GCP Artifact Registry如何在Github Action中仅当仓库不存在时创建

核心思路 #

通过预先检查仓库存在性、过滤已知存在错误、或使用幂等资源管理工具三种方式，避免重复创建仓库导致的CI流程报错。

方案1：前置存在性检查（最常用） #

先调用gcloud artifacts repositories describe命令判断仓库是否存在，仅当查询失败时执行创建逻辑，示例代码如下：

# 替换为你的实际配置
REPO_NAME="your-repo-name"
REPO_REGION="asia-east1"
REPO_TYPE="docker"
GCP_PROJECT_ID="your-project-id"

# 静默查询仓库是否存在，查询成功说明已存在，失败则说明不存在
if ! gcloud artifacts repositories describe "${REPO_NAME}" \
  --location="${REPO_REGION}" \
  --project="${GCP_PROJECT_ID}" > /dev/null 2>&1; then
  # 执行创建操作
  gcloud artifacts repositories create "${REPO_NAME}" \
    --location="${REPO_REGION}" \
    --project="${GCP_PROJECT_ID}" \
    --repository-format="${REPO_TYPE}"
  echo "仓库 ${REPO_NAME} 已成功创建"
else
  echo "仓库 ${REPO_NAME} 已存在，跳过创建步骤"
fi

该方案逻辑清晰，可自定义日志输出，方便CI流程排查问题。

方案2：过滤已存在错误码 #

gcloud命令在资源已存在时会返回固定错误码6，可以仅过滤该错误码，其他异常错误（如权限不足、参数错误）仍会正常抛出导致CI失败，避免隐藏真实问题：

gcloud artifacts repositories create your-repo-name \
  --location=asia-east1 \
  --repository-format=docker \
  --project=your-project-id || create_exit_code=$?

# 仅忽略资源已存在的错误，其他错误直接终止CI流程
if [ -n "$create_exit_code" ] && [ "$create_exit_code" -ne 6 ]; then
  exit $create_exit_code
fi

该方案代码简洁，不需要额外的查询步骤。

方案3：使用基础设施即代码(IaC)工具 #

如果项目已经在使用Terraform、Pulumi等IaC工具管理云资源，直接声明Artifact Registry资源即可，这类工具本身支持幂等操作，会自动判断资源状态，不存在则创建、存在则跳过，不会报错。

以Terraform为例：

resource "google_artifact_registry_repository" "repo" {
  project       = "your-project-id"
  location      = "asia-east1"
  repository_id = "your-repo-name"
  format        = "DOCKER"
}

该方案适合已经落地IaC规范的项目，后续仓库配置变更也可以统一通过代码管理。

Github Action 完整集成示例 #

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: GCP身份认证
        uses: google-github-actions/auth@v1
        with:
          credentials_json: ${{ secrets.GCP_SERVICE_ACCOUNT_KEY }}
          project_id: ${{ vars.GCP_PROJECT_ID }}

      - name: 安装配置gcloud SDK
        uses: google-github-actions/setup-gcloud@v1

      - name: 按需创建Artifact Registry仓库
        run: |
          REPO_NAME="my-app-repo"
          REPO_REGION="asia-east1"
          REPO_TYPE="docker"
          if ! gcloud artifacts repositories describe "${REPO_NAME}" --location="${REPO_REGION}" > /dev/null 2>&1; then
            gcloud artifacts repositories create "${REPO_NAME}" --location="${REPO_REGION}" --repository-format="${REPO_TYPE}"
            echo "仓库创建完成"
          else
            echo "仓库已存在，跳过创建"
          fi

内容的提问来源于stack exchange，提问作者HumbleCoder