11.3. 准备自定义 GCE 镜像并将其上传到 GCP

流程

1. 使用文本编辑器创建一个包含以下内容的 gcp-config.toml 配置文件：

   provider = "gcp"
   [settings]
   bucket = "GCP_BUCKET"
   region = "GCP_STORAGE_REGION"
   object = "OBJECT_KEY"
   credentials = "GCP_CREDENTIALS"

   • GCP_BUCKET 指向现有的存储桶。它用于存储正在上传的镜像的中间存储对象。
   • GCP_STORAGE_REGION 是常规的 Google 存储区域和双区域或多区域。
   • OBJECT_KEY 是中间存储对象的名称。它在上传过程前不能存在，并在上传过程完成后被删除。如果对象名称不以 .tar.gz 结尾，则扩展会自动添加到对象名称中。

   • GCP_CREDENTIALS 是从 GCP 下载的凭证 JSON 文件的 Base64 编码的方案。凭证决定了 GCP 将镜像上传到的项目。

     注意

     如果您使用不同的机制来使用 GCP 进行身份验证，在 gcp-config.toml 文件中指定 GCP_CREDENTIALS 是可选的。有关其他验证方法，请参阅 使用 GCP 进行验证 。

2. 从 GCP 下载的 JSON 文件中检索 GCP_CREDENTIALS。

   $ sudo base64 -w 0 cee-gcp-nasa-476a1fa485b7.json

3. 使用附加镜像名称和云供应商配置集创建 compose：

   $ sudo composer-cli compose start BLUEPRINT-NAME gce IMAGE_KEY gcp-config.toml

   镜像构建、上传和云注册过程最多可能需要十分钟才能完成。

1. 在配置文件中，使用 composer-cli 命令指定的凭证。
2. 凭证在 osbuild-composer worker 配置中被配置。

3. Google GCP SDK 库中的 应用程序默认凭证，它尝试使用以下选项自动找到一个身份验证的方法：

   1. 如果设置了 GOOGLE_APPLICATION_CREDENTIALS 环境变量，应用程序默认凭据会尝试加载并从文件中使用由变量指向的凭证。

   2. 应用默认凭据尝试使用附加到运行代码的资源的服务帐户进行身份验证。例如，Google Compute Engine 虚拟机。

      注意

      您必须使用 GCP 凭证来决定将镜像上传到的 GCP 项目。因此，除非要将所有镜像上传到同一 GCP 项目，您必须使用 composer-cli 命令指定 gcp-config.toml 配置文件中的凭证。