Skopeo

使用指南 阅读更多

skopeo是一个命令行应用程序,它对容器镜像和镜像存储库执行各种操作。 skopeo可以操作OCI镜像以及原始的Docker v2镜像。 支持的操作 Skopeo使用API V2注册表,例如Docker注册表,Atomic注册表,私有注册表,本地目录和本地OCI布局目录。 Skopeo不需要运行守护进程来执行这些操作,包括: 从各种存储机制复制镜像。 例如,您可以将镜像从一个注册表复制到另一个注册表,而无需特权。 检查显示其属性(包括其镜像层)的远程镜像,而无需将镜像拉到主机。 从镜像存储库中删除镜像。 当存储库需要时,skopeo可以传递适当的凭据和证书进行身份验证。 支持的类型(镜像或存储库) Skopeo对以下类型的镜像和存储库进行操作: containers-storage:docker-reference。位于本地容器/存储镜像存储中的镜像。在/etc/containers/storage.conf中指定的位置和镜像存储 dir:path一个现有的本地目录路径,它将manifest,镜像层tarball和signatures存储为单个文件。这是一种非标准化格式,主要用于调试或非侵入式容器检查。 docker://docker-reference。实现“Docker Registry HTTP API V2”的注册表中的镜像。默认情况下,使用$HOME/.docker/config.json中的授权状态,例如,设置为使用(docker login)。 docker-archive:path [:docker-reference]。镜像存储在docker save formated file中。 docker-reference仅在创建此类文件时使用,并且不得包含digest。 docker-daemon:docker-reference。存储在docker守护程序内部存储中的镜像。 docker-reference必须包含tag或digest。或者,在读取镜像时,格式也可以是docker-daemon:algo:digest(image ID)。 oci:path:tag。路径中符合“Open Container Image Layout Specification”的目录中的镜像标记。 ostree:image / absolute / repo / path。本地OSTree存储库中的镜像。 /absolute/repo/path默认为/ostree/repo。 例子 检查存储库 skopeo能够检查Docker注册表上的存储库并获取镜像层。 inspect命令获取存储库的清单,它能够显示有关整个存储库或标记的docker inspect-like json输出。 与docker inspect相比,此工具可帮助您在提取存储库或标记之前收集有用的信息(使用磁盘空间)。 inspect命令可以显示给定存储库可用的标记,图像的标签,图像的创建日期和操作系统等。 # show properties of fedora:latest $ skopeo inspect docker://docker.io/fedora { "Name": "docker.io/library/fedora", "Tag": "latest", "Digest": "sha256:cfd8f071bf8da7a466748f522406f7ae5908d002af1b1a1c0dcf893e183e5b32", "RepoTags": [ "20", "21", "22", "23", "heisenbug", "latest", "rawhide" ], "Created": "2016-03-04T18:40:02.92155334Z", "DockerVersion": "1.9.1", "Labels": {}, "Architecture": "amd64", "Os": "linux", "Layers": [ "sha256:236608c7b546e2f4e7223526c74fc71470ba06d46ec82aeb402e704bfdee02a2", "sha256:a3ed95caeb02ffe68cdd9fd84406680ae93d633cb16422d00e8a7c22955b46d4" ] } # show unverifed image's digest $ skopeo inspect docker://docker.io/fedora:rawhide | jq '.Digest' "sha256:905b4846938c8aef94f52f3e41a11398ae5b40f5855fb0e40ed9c157e721d7f8" 拷贝镜像 skopeo可以在各种存储机制之间复制容器镜像,包括: 基于Docker分发的注册表 Docker Hub,OpenShift,GCR,Artifactory,Quay ...... 容器存储后端 Docker守护程序存储 github.com/containers/storage(CRI-O的后端,Buildah和frends) 本地目录 本地OCI布局目录 $ skopeo copy docker://busybox:1-glibc atomic:myns/unsigned:streaming $ skopeo copy docker://busybox:latest dir:existingemptydirectory $ skopeo copy docker://busybox:latest oci:busybox_ocilayout:latest 删除镜像 $ skopeo delete docker://localhost:5000/imagename:latest 具有身份验证的私有注册表 当与私有注册表交互时,skopeo首先查找--creds(用于skopeo inspect | delete)或--src-creds | --dest-creds(用于skopeo copy)标志。 如果没有提供,它会查找Docker的cli配置文件(通常位于$ HOME/.docker/config.json)以获取进行身份验证所需的凭据。 像Docker一样,最终的后备是在与这些注册表交互时提供空身份验证。 $ cat /home/runcom/.docker/config.json { "auths": { "myregistrydomain.com:5000": { "auth": "dGVzdHVzZXI6dGVzdHBhc3N3b3Jk", "email": "stuf@ex.cm" } } } # we can see I'm already authenticated via docker login so everything will be fine $ skopeo inspect docker://myregistrydomain.com:5000/busybox {"Tag":"latest","Digest":"sha256:473bb2189d7b913ed7187a33d11e743fdc2f88931122a44d91a301b64419f092","RepoTags":["latest"],"Comment":"","Created":"2016-01-15T18:06:41.282540103Z","ContainerConfig":{"Hostname":"aded96b43f48","Domainname":"","User":"","AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":null,"Cmd":["/bin/sh","-c","#(nop) CMD [\"sh\"]"],"Image":"9e77fef7a1c9f989988c06620dabc4020c607885b959a2cbd7c2283c91da3e33","Volumes":null,"WorkingDir":"","Entrypoint":null,"OnBuild":null,"Labels":null},"DockerVersion":"1.8.3","Author":"","Config":{"Hostname":"aded96b43f48","Domainname":"","User":"","AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":null,"Cmd":["sh"],"Image":"9e77fef7a1c9f989988c06620dabc4020c607885b959a2cbd7c2283c91da3e33","Volumes":null,"WorkingDir":"","Entrypoint":null,"OnBuild":null,"Labels":null},"Architecture":"amd64","Os":"linux"} # let's try now to fake a non existent Docker's config file $ cat /home/runcom/.docker/config.json {} $ skopeo inspect docker://myregistrydomain.com:5000/busybox FATA[0000] unauthorized: authentication required # passing --creds - we can see that everything goes fine $ skopeo inspect --creds=testuser:testpassword docker://myregistrydomain.com:5000/busybox {"Tag":"latest","Digest":"sha256:473bb2189d7b913ed7187a33d11e743fdc2f88931122a44d91a301b64419f092","RepoTags":["latest"],"Comment":"","Created":"2016-01-15T18:06:41.282540103Z","ContainerConfig":{"Hostname":"aded96b43f48","Domainname":"","User":"","AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":null,"Cmd":["/bin/sh","-c","#(nop) CMD [\"sh\"]"],"Image":"9e77fef7a1c9f989988c06620dabc4020c607885b959a2cbd7c2283c91da3e33","Volumes":null,"WorkingDir":"","Entrypoint":null,"OnBuild":null,"Labels":null},"DockerVersion":"1.8.3","Author":"","Config":{"Hostname":"aded96b43f48","Domainname":"","User":"","AttachStdin":false,"AttachStdout":false,"AttachStderr":false,"Tty":false,"OpenStdin":false,"StdinOnce":false,"Env":null,"Cmd":["sh"],"Image":"9e77fef7a1c9f989988c06620dabc4020c607885b959a2cbd7c2283c91da3e33","Volumes":null,"WorkingDir":"","Entrypoint":null,"OnBuild":null,"Labels":null},"Architecture":"amd64","Os":"linux"} # skopeo copy example: $ skopeo copy --src-creds=testuser:testpassword docker://myregistrydomain.com:5000/private oci:local_oci_image 获取skopeo skopeo可能已经打包在您的发行版中,例如在Fedora 23上,以后您可以使用它安装它 $ sudo dnf install skopeo 否则,请继续阅读以从源代码构建和安装它: 要构建skopeo二进制文件,至少需要Go 1.5,因为它使用最新的GO15VENDOREXPERIMENT标志。 构建skopeo有两种方法:在容器中,或在没有容器的情况下本地。 选择更符合您需求和环境的产品。 不在容器中 没有容器的构建需要在您的环境中进行更多的手动工作和设置,但它更灵活: 它应该在更多环境中工作(例如,对于本机macOS构建) 它不需要root权限(安装依赖项后) 它更快,因此开发skopeo更方便。 安装必要的依赖项: Fedora $ sudo dnf install gpgme-devel libassuan-devel btrfs-progs-devel device-mapper-devel ostree-devel Ubuntu $ sudo apt install libgpgme-dev libassuan-dev btrfs-progs libdevmapper-dev libostree-dev macOS $ brew install gpgme 确保在GOPATH中克隆此存储库 - 否则编译失败。 $ git clone https://github.com/containers/skopeo $ GOPATH / src / github.com / containers / skopeo $ cd $ GOPATH / src / github.com / containers / skopeo && make binary-local 在容器中 在容器中构建更简单,但更具限制性: 它需要docker命令和运行Linux容器的能力 创建的可执行文件是Linux可执行文件,依赖于动态库,这些库只能在类似Linux发行版的容器中使用。 bash $ make binary #或(make all)也可以构建文档,见下文。 要构建pure-Go静态二进制文件(禁用ostree,devicemapper,btrfs和gpgme): bash $ make binary-static DISABLE_CGO = 1 编译文档 要构建手册,您需要go-md2man。 Debian $ sudo apt-get install go-md2man Fedora $ sudo dnf安装go-md2man 然后 $ make docs 安装 最后,在构建二进制文件之后: $ sudo make install