码头工人注册表

在使用Docker时，Artifactory支持三种类型的存储库:

• 局部存储库是您的内部Docker映像的地方。通过Artifactory的安全功能，这些都是安全的私有Docker注册表。
• 远程存储库用于代理远程Docker资源，如Docker Hub。2022世界杯阿根廷预选赛赛程
• 虚拟存储库可以聚合多个Docker注册中心，从而支持一个单一端点，可以用于推送和拖动Docker映像。这使得管理员可以在用户不知道的情况下管理不同的Docker注册中心，并继续使用相同的端点。

**确保进入每个存储库的高级选项卡，并设置注册表端口，如果您使用Docker的端口方法。然后，反向代理生成器应该为指定的端口添加一个新节。

本地Docker存储库

本地Docker存储库是您可以部署和托管您的内部Docker映像的地方。实际上，它是一个Docker注册表，能够托管标记Docker映像的集合，这些映像就是您的Docker存储库。一旦您的映像被托管，您就可以执行细粒度的访问控制，并通过复制或通过其他Artifactory实例中的存储库代理在您的组织中共享它们。

定义一个本地Docker存储库:

1. 从政府模块,选择存储库|存储库|当地的．
2. 点击新建本地存储库并选择码头工人从选择包类型对话框。

3. 设置库的关键，并在“Docker Settings”部分选择V2作为Docker API版本。

4. 集最大唯一标签．这指定了每个存储库应该为Docker映像存储的惟一标记的最大数量。一旦一个图像的标签数量超过这个数字，旧的标签将被删除。将字段保留为空(默认值)意味着将存储所有标记。

反向代理设置

Artifactory支持通过反向代理(使用子域法或通过端口绑定)，或使用直接访问．

当通过反向代理访问时，如果您正在使用Artifactory反向代理的配置生成器下配置Docker存储库的反向代理设置先进的设置选项卡。详情请参阅Docker反向代理设置．

---

推广Docker形象

Artifactory支持将Docker映像从Artifactory中的一个Docker库提升到另一个Docker库。

当您需要将Docker映像通过不同的验收和测试阶段(例如，从开发存储库通过不同的网关一直到生产)移动时，提升是非常有用的。使用升级将确保生产环境中的映像是由CI服务器构建并通过所有相关测试的映像，而不是多次重新构建映像。

提升可以使用以下端点和cURL触发:

POST api/docker//v2/promote {"targetRepo": ""， "dockerRepository": ""， "tag": ""， "targetTag": ""， "copy": }

地点:

repoKey	源存储库密钥
targetRepo	要移动或复制的目标存储库
dockerRepository	要提升的docker存储库名称
标签	要提升的可选标记名，如果为空—整个docker存储库将提升。默认值:最新的
targetTag	如果你想的话，图片在被提升后应该有的新标签
复制	当为true时，将提升映像的副本。如果为false，则将映像移动到目标存储库

一个提升docker形象的例子jfrog / ubuntu”)所有的标签都来自docker-local来docker-prod使用cURL将是:

curl -i -uadmin:password -X POST "https://artprod.company.com/api/docker//v2/promote" -H "Content-Type: application/json" -d '{"targetRepo":"docker-prod"，"dockerRepository":"jfrog/ubuntu"}'

https://artprod.company.com/api/docker/< repoKey > / v2 /推广

注意，上面的示例是通过反向代理执行的。要直接通过Artifactory，您将执行以下命令:

curl -i -uadmin:password -X POST "http://localhost:8080/artifactory/api/docker/docker-local/v2/promote" -H "Content-Type: application/json" -d '{"targetRepo":"docker-prod"，"dockerRepository":"jfrog/ubuntu"}'

类的特定版本添加重标记jfrog / ubuntu图像(4.9.0)被重标记到最新的当它得到推广时:

curl -i -uadmin:password -X POST "https://artprod.company.com/api/docker/docker-local/v2/promote" -H "Content-Type: application/json" -d '{"targetRepo":"docker-prod"，"dockerRepository":"jfrog/ubuntu"， "tag":" 4.9.0"， "targetTag":" latest"}'

推和拉图像

撮合我

得到相应的码头工人推而且码头工人拉任何存储库的命令，请转到Artifactory|工件|工件存储库浏览器，在应用程序模块，然后单击撮合我．

码头工人

Podman

将多架构Docker映像推送到Artifactory

JFrog Artifactory支持以下方法将多架构Docker映像推送到Docker注册表:

• 逐个为每个体系结构推送Docker映像
• 使用Docker Buildx CLI批量推送Docker映像(Artifactory 7.21.2及更高版本支持)
• 使用Docker Build推送多架构Docker映像从Artifactory 7.21.2或更高。

一个一个地推送Docker图像

您可以使用'方法来推送多架构Docker映像。清单列表’文件，(Docker将其正式称为胖舱单文件’)，它引用特定于平台版本的图像清单。有关更多信息，请单击在这里．

推送多架构Docker映像的过程类似于标准的Docker Push过程，但有一些例外:

1. 每个体系结构都有一个不同的标签。
2. 在所有的架构都建立和推进之后，一个单一的'胖舱单文件’，包含所有带有相关标签的图片。
3. 按完后“脂肪清单文件的时，图像会以给定的标签发布。

$ docker build -t domain/docker/multiarch-image:amd64——build-arg ARCH=amd64/ $ docker push domain/docker/multiarch-image:amd64 $ docker build -t domain_name:port/docker/multiarch-image:arm64——build-arg ARCH=arm64/ $ docker push domain/docker/multiarch-image:arm64 $ docker manifest create \ domain_name:port1/docker/multiarch-image:tag \——modify domain/docker/multiarch-image:amd64 \——modify domain/docker/multiarch-image:arm64 \ $ docker manifest push domain/docker/multiarch-image:my-tag

使用Docker Buildx批量推送图像CLI

从Artifactory 7.21.2，码头工人buildx命令，允许您创建和上传Docker '清单列表’到Artifactory的Docker注册表。码头工人buildx允许您使用单个命令构建和推送多个体系结构映像，而不必分别构建和推送每个体系结构映像。有关更多信息，请参见使用buildx．

支持码头工人建造x, Artifactory将图像的每个架构保存在以下带有标签的路径结构下这包括最初发布的标记、图像操作系统和图像体系结构。

imageName: tag-os-arch

下面的例子展示了Docker BuildX API的使用。

Docker buildx build——platform linux/amd64,linux/arm64——tag domain/ Docker /multiarch-image:tag——output=type=image,push=true——push。

使用Docker Build推送多架构Docker映像

从Artifactory版本7.21.2及更高版本开始，如果您继续使用码头工人建造，你推送的所有图片都会被复制，并且架构标签会自动添加到每张图片。

在以下示例中，使用Docker Build推送以下图像将导致Artifactory自动复制图像并添加linux标签到每个图像。

列表清单

docker.artifactory。< domain_name > /测试/ busybox: 1.33

一个形象

1. 在构建过程中推送映像A。
   

   docker.artifactory < domain_name > /测试/ busybox: 1.33 amd64

   
   

2. Artifactory复制图像并添加“linux”标签。

   docker.artifactory。< domain_name > /测试/ busybox: 1.33 -linux-amd64

B图像

1. 在构建过程中推送了图像B。
   

   docker.artifactory。< domain_name > /测试/ busybox: 1.33 s390x

2. Artifactory复制图像并添加'linux的标签。
   

   artifactory.us…< domain_name > /测试/ busybox: 1.33 -linux-s390x

浏览Docker存储库

有关如何浏览存储库的一般信息，请参阅浏览Artifactory．

的码头工人信息TAB给出了三个部分:标签信息，Docker标签可视化,标签．

标签信息

显示所选标记的基本细节。

Docker标签可视化

本节将映射用于生成所选标记的整个命令集以及相应层的摘要。本质上，您将看到相同的命令系列使用码头工人的历史．

您可以选择图像的任何层来查看以下属性。

象征	财产
	图层ID
	图层大小
	创建层时的时间戳
	创建层的命令
	摘要

标签

此部分显示附加到图像的标签。

还要注意，Artifactory提取与Docker映像关联的任何标签，并在manifest.json可以用来指定搜索参数的文件，这可以用来很容易地向任何图像添加额外的元数据。

搜索Docker图像

的名称、标记或图像摘要搜索Docker图像工件包搜索或通过REST API．

列出Docker映像

Artifactory支持以下与Docker注册表相关的REST API端点:

• Docker图片列表提供指定Artifactory Docker注册表中的Docker映像列表。这个端点模仿Docker_catalogREST API。
• Docker标签列表提供指定Docker映像的标签列表。

Artifactory还支持此端点的分页。

来启用从缓存中获取ListDockerRepositories和ListDockerTagsREST api，设置artifactory.docker.catalogs.tags.fallback.fetch.remote.cache在artifactory.system.properties文件中，系统属性为true(默认为false):

#启用从Docker存储库的缓存中获取#artifactory.docker.catalogs.tags.fallback.fetch.remote.cache=true

需要重新启动Artifactory才能使此更改生效。

删除和清理

Artifactory本机支持删除标记和存储库，并符合Docker Hub规范。

删除Docker标记和存储库会自动清除剩下的任何孤立层(未被任何其他标记/存储库使用的层)。

目前Docker客户端不支持DELETE命令，但可以手动触发删除。要使用cURL删除整个Docker存储库，请执行以下命令:

curl -u -X DELETE "/ Artifactory //<图像命名空间>"

或者对于特定的标签版本:

curl -u -X DELETE "/ Artifactory //<图像命名空间>/<标签>"

例如，要删除Ubuntu存储库的最新标签:

//删除"jfrog/ubuntu"库中的最新标签curl -uadmin:password -X DELETE "https://artprod.company.com/artifactory/dockerv2-local/jfrog/ubuntu/latest"

限制唯一标签

为避免Docker注册表中由于为一个图像上传许多快照而造成的混乱和膨胀，请将最大唯一标签字段中的本地Docker存储库配置以限制唯一标记的数量。

Docker构建信息

通过使用JFrog CLI运行Docker构建，您可以在Artifactory中存储详尽的构建信息。

JFrog CLI从构建代理收集构建信息，然后将其发布到Artifactory。发布之后，可以在构建浏览器下构建．

有关使用JFrog CLI集成Docker构建的更多细节，请参考管理Docker映像《JFrog CLI User Guide》中的“。”

从Docker V1迁移到Docker V2

如果您还在使用Docker V1，我们强烈建议您升级到Docker V2。这要求您迁移为Docker V1创建的所有Docker存储库，并通过一个简单的cURL端点完成。

详情请参阅将V1存储库迁移到V2下使用Docker V1文档。