google cloud 的 artifactregistry 是一个用于管理应用程序依赖项的强大工具。本指南演示如何创建 cloud build 管道以使 docker 能够访问存储在 artifactregistry 中的 python 包。通过执行以下步骤，您可以安全地管理依赖项并简化部署。
先决条件
- google cloud 项目：确保您已设置 gcp 项目。
- artifactregistry：python 存储库应该已经在 artifactregistry 中配置。
- cloud build：为您的项目启用 cloud build api。
- 身份验证：配置服务帐户权限以访问工件注册表。
配置云构建的步骤
1. 生成 artifact 注册表令牌
使用 gcloud auth 生成访问令牌，该令牌将允许 docker 构建过程通过 artifact registry 进行身份验证。执行此操作的方法如下：
steps:
# generate artifact registry token
- name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
entrypoint: bash
args:
- '-c'
- |
art=$(gcloud auth print-access-token)
echo "$art" > /workspace/artifact_registry_token
echo "$art"
2.在docker构建中使用token
令牌生成后，可以将其作为构建参数传递给 docker 构建过程。方法如下：
- name: gcr.io/cloud-builders/docker
id: build
env:
- 'btf=/workspace/artifact_registry_token'
entrypoint: bash
args:
- '-c'
- |
docker build \
--build-arg artifact_registry_token=$(cat $btf) \
--build-arg project_id=$project_id \
-t test-image:latest \
-f dockerfile .
3. 创建 dockerfile
dockerfile 配置为使用令牌从 artifact registry 下载 python 包：
# syntax=docker/dockerfile:1
from python:3.11-slim
arg artifact_registry_token
arg project_id
# keeps python from buffering stdout and stderr
env pythonunbuffered=1
workdir /app
run pip install --no-cache-dir -r requirements.txt
copy . .
# install dependencies using the token
run pip install \
--index-url https://pypi.org/simple \
--extra-index-url https://oauth2accesstoken:${artifact_registry_token}@us-central1-python.pkg.dev/${project_id}/python-packages/simple/ \
"your-package-name==your-package-version"
# expose the application port
expose 8080
# command to run the application
cmd ["uvicorn", "main:app", "--port=8080", "--host=0.0.0.0"]
4. 添加构建配置选项
最后，定义其他配置，例如机器类型、日志记录和替换：
options: machinetype: e2_highcpu_8 substitutionoption: allow_loose logging: cloud_logging_only substitutions: _package: your-package-name==your-package-version _repository: python-packages _location: us-central1 _project_id: your-project-id
标签和元数据
为了更好地组织您的构建，请包含有意义的标签：
tags: - gcp-cloud-build - artifact-registry - docker-python-packages
概括
此设置可确保 cloud build 中的 docker 构建可以使用访问令牌从 artifact registry 安全地提取 python 依赖项。将提供的配置调整为特定于项目的详细信息，例如包名称、存储库 url 和部署目标。
实施此管道将提高安全性并使您的项目无缝依赖管理。
