设置环境变量以配置构建

您可以配置在构建容器映像期间设置的环境变量。

您还可以通过扩展构建和运行映像来自定义容器映像。

本地构建

对于本地构建，您必须已安装 Pack CLI 和 Docker。

准备工作

  1. 在工作站上安装 Docker 社区版 (CE)。pack 会将 Docker 用作 OCI 映像构建器。
  2. 安装 Pack CLI。
  3. 安装 Git 源代码控制工具以从 GitHub 获取示例应用。

设置环境变量

如需为本地构建设置环境变量，请将 --env 标志附加到每个环境变量的 pack 命令。

您可以使用运行时支持的一个或多个环境变量。

pack build SERVICE_NAME \
    --env ENVIRONMENT_VARIABLE

您需要将其中的：

  • 将 SERVICE_NAME 替换为您的应用或函数的服务名称。
  • 将 ENVIRONMENT_VARIABLE 替换为您要在构建期间设置的环境变量。
示例

如需在容器映像中设置 GOOGLE_ENTRYPOINT="gunicorn -p :8080 main:app" 环境变量，请运行以下命令：

pack build my-app \
    --builder gcr.io/buildpacks/builder:v1 \
    --env GOOGLE_ENTRYPOINT="gunicorn -p :8080 main:app"
    --env MY-LOCAL-ENV-VARIABLE

远程构建

如需为远程构建设置环境变量，请使用 project.toml 项目描述符。构建容器映像时，Cloud Build 会使用 project.toml 项目描述符。

准备工作

  1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

  2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  3. 确保您的 Google Cloud 项目已启用结算功能。

  4. 启用 Cloud Build and Artifact Registry API。

    启用 API

  5. 安装 Google Cloud CLI。

  6. 如需初始化 gcloud CLI，请运行以下命令： 

    gcloud init
    7.

  7. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

    转到“项目选择器”

  8. 确保您的 Google Cloud 项目已启用结算功能。

  9. 启用 Cloud Build and Artifact Registry API。

    启用 API

  10. 安装 Google Cloud CLI。

  11. 如需初始化 gcloud CLI，请运行以下命令： 

    gcloud init
    12.
  12. 确保您的 Google Cloud 项目有权访问容器映像代码库。

    如需配置对 Artifact Registry 中的 Docker 代码库的访问权限，请执行以下操作：

    1. 在 Google Cloud 项目的同一位置创建一个新的 Docker 代码库。
      gcloud artifacts repositories create REPO_NAME \
--repository-format=docker \
--location=REGION --description="DESCRIPTION"
      您需要进行如下替换：
      • 将 REPO_NAME 替换为您为 Docker 代码库选择的名称。
      • 将 REGION 替换为 Google Cloud 项目的位置或最接近该位置的位置。
      • 将 DESCRIPTION 替换为您选择的说明。

      例如，如需在 us-west2 中创建具有说明“Docker 仓库”的 docker 仓库，请运行以下命令：

      gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
--location=us-west2 --description="Docker repository"
    2. 验证您的代码库已创建： 
      gcloud artifacts repositories list

      您应该会在列表中看到您为 Docker 仓库选择的名称。

可选：下载示例应用

  1. 将示例代码库克隆到本地计算机： 
    git clone https://github.com/GoogleCloudPlatform/buildpack-samples.git
  2. 切换到包含应用示例代码的目录：

    Go

    cd buildpack-samples/sample-go

    Java

    cd buildpack-samples/sample-java-gradle

    Node.js

    cd buildpack-samples/sample-node

    PHP

    cd buildpack-samples/sample-php

    Python

    cd buildpack-samples/sample-python

    Ruby

    cd buildpack-samples/sample-ruby

    .NET

    cd buildpack-samples/sample-dotnet

使用环境变量构建应用

  1. 在服务的根目录中，创建或更新 project.toml 项目描述符，以包含 [[build.env]] 部分和任何支持的环境变量：
    [[build.env]]
    name = "ENVIRONMENT_VARIABLE_NAME"
    value = "ENVIRONMENT_VARIABLE_VALUE"

    您需要将其中的：

    • 将 ENVIRONMENT_VARIABLE_NAME 替换为支持的环境变量的名称。
    • 将 ENVIRONMENT_VARIABLE_VALUE 替换为指定环境变量的相应值。

    示例

    [[build.env]]
    name = "GOOGLE_ENTRYPOINT"
    value = "gunicorn -p :8080 main:app"
  2. 使用 gcloud 将应用源代码提交到 Cloud Build： 
    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/IMAGE_NAME

    您需要进行如下替换：

    • 将 LOCATION 替换为容器仓库的区域名称。示例：us-west2-docker.pkg.dev
    • 将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
    • 将 REPO_NAME 替换为您的 Docker 代码库的名称。
    • 将 IMAGE_NAME 替换为容器映像的名称。

    示例：如果您下载了示例应用，请运行相应的命令：

    Go

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-go

    Java

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-java-gradle

    Node.js

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-node

    PHP

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-php

    Python

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-python

    Ruby

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-ruby

    .NET

    gcloud builds submit --pack image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/sample-dotnet
  3. 验证示例应用是否已成功发布到 REPO_NAME： 
    gcloud artifacts docker images list LOCATION-docker.pkg.dev/project-id/REPO_NAME

    您需要将其中的：

    • 将 LOCATION 替换为容器仓库的区域名称。 示例：us-west2-docker.pkg.dev
    • 将 PROJECT_ID 替换为您的 Google Cloud 项目的 ID。
    • 将 REPO_NAME 替换为您的 Docker 代码库的名称。