从容器镜像库中删除容器镜像

您可以从容器镜像库中删除容器镜像。

caution删除容器镜像是一种破坏性操作，无法撤消。要恢复已删除的容器镜像，您必须重建并重新上传它。

删除私有化部署实例上的容器镜像不会释放存储空间，只会将镜像标记为符合删除条件。要真正删除未引用的容器镜像并恢复存储空间，管理员必须运行垃圾收集。

使用极狐GitLab UI

使用极狐GitLab UI 删除容器镜像：

  1. 在顶部栏中，选择 主菜单，然后：
    • 对于项目，选择 项目 并找到您的项目。
    • 对于群组，选择 群组 并找到您的群组。
  2. 在左侧边栏中，选择 软件包与镜像库 > 容器镜像库。

  3. 在 容器镜像库 页面中，您可以通过以下任一方式选择要删除的内容：

    • 通过选择红色的 图标删除整个镜像及其包含的所有标签。
    • 进入镜像页面，并通过选择要删除的标签旁边的红色 图标，单独或批量删除标签。
  4. 在对话框中，选择 删除标签。

使用 API

您可以使用 API 自动执行删除容器镜像的过程。有关详细信息，请参阅以下端点：

使用极狐GitLab CI/CD

note极狐GitLab CI/CD 不提供删除容器镜像的内置方法。此示例使用名为 reg 的第三方工具与容器镜像库 API 通信。有关此第三方工具的帮助，请参阅 reg 的议题队列。

以下示例定义了两个阶段：build 和 clean。build_image 作业为分支构建容器镜像，而 delete_image 作业删除它。reg 可执行文件被下载，并用于删除与 $CI_PROJECT_PATH:$CI_COMMIT_REF_SLUG 预定义的 CI/CD 变量 匹配的容器镜像。

要使用此示例，请更改 IMAGE_TAG 变量来满足您的需要。 

stages:
  - build
  - clean

build_image:
  image: docker:20.10.16
  stage: build
  services:
    - docker:20.10.16-dind
  variables:
    IMAGE_TAG: $CI_REGISTRY_IMAGE:$CI_COMMIT_REF_SLUG
  script:
    - docker login -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $CI_REGISTRY
    - docker build -t $IMAGE_TAG .
    - docker push $IMAGE_TAG
  only:
    - branches
  except:
    - main

delete_image:
  before_script:
    - curl --fail --show-error --location "https://github.com/genuinetools/reg/releases/download/v$REG_VERSION/reg-linux-amd64" --output ./reg
    - echo "$REG_SHA256  ./reg" | sha256sum -c -
    - chmod a+x ./reg
  image: curlimages/curl:7.86.0
  script:
    - ./reg rm -d --auth-url $CI_REGISTRY -u $CI_REGISTRY_USER -p $CI_REGISTRY_PASSWORD $IMAGE_TAG
  stage: clean
  variables:
    IMAGE_TAG: $CI_PROJECT_PATH:$CI_COMMIT_REF_SLUG
    REG_SHA256: ade837fc5224acd8c34732bf54a94f579b47851cc6a7fd5899a98386b782e228
    REG_VERSION: 0.16.1
  only:
    - branches
  except:
    - main
note您可以从 发布页面 下载最新的 reg 版本，然后通过更改 delete_image 作业中定义的 REG_SHA256 和 REG_VERSION 变量来更新代码示例。

使用清理策略

您可以为每个项目创建一个清理策略，确保定期从容器镜像库中删除旧标签和镜像。