跳至主要内容
版本:1.23.6

容器註冊表

為您的用戶或組織發布符合 Open Container Initiative 規範的映像。 容器註冊表遵循 OCI 規範,支持所有兼容的映像,如 DockerHelm Charts

需求

要使用容器註冊表,您可以使用特定映像類型的工具。 以下範例使用 docker 客戶端。

登錄到容器註冊表

要推送映像或如果映像在私有註冊表中,您必須進行身份驗證:

docker login gitea.example.com

如果您使用 2FA 或 OAuth,請使用 個人訪問令牌 代替密碼。

映像命名規則

映像必須遵循以下命名規則:

{registry}/{owner}/{image}

在構建您的 docker 映像時,使用上述命名規則,這看起來像這樣:

# 使用標籤構建映像
docker build -t {registry}/{owner}/{image}:{tag} .
# 使用標籤命名現有映像
docker tag {some-existing-image}:{tag} {registry}/{owner}/{image}:{tag}

其中您的註冊表是您的 gitea 實例的域名(例如 gitea.example.com)。 例如,以下是所有者 testuser 的所有有效映像名稱:

gitea.example.com/testuser/myimage

gitea.example.com/testuser/my-image

gitea.example.com/testuser/my/image

備註

註冊表僅支持不區分大小寫的標籤名稱。因此 image:tagimage:Tag 被視為相同的映像和標籤。

推送映像

通過執行以下命令推送映像:

docker push gitea.example.com/{owner}/{image}:{tag}
參數描述
owner映像的擁有者。
image映像的名稱。
tag映像的標籤。

例如:

docker push gitea.example.com/testuser/myimage:latest

拉取映像

通過執行以下命令拉取映像:

docker pull gitea.example.com/{owner}/{image}:{tag}
參數描述
owner映像的擁有者。
image映像的名稱。
tag映像的標籤。

例如:

docker pull gitea.example.com/testuser/myimage:latest