使用特定建構工具

建構工具是包含所有必要元件的版本化映像檔，可用於建立可執行的容器。每個建構工具都會使用特定 OS 發行版本做為基礎映像檔 (例如 Ubuntu 22)，並支援多個程式設計語言版本。

如果需要下列功能，您可能需要自訂建構工具版本：

• 僅適用於特定建構工具版本的作業系統專屬依附元件。
• 程式設計語言的特定版本，僅適用於特定建構工具版本。

本機建構作業

如要進行本機建構，您必須安裝 Pack CLI 和 Docker。

事前準備

1. 在工作站上安裝 Docker Community Edition (CE)。pack 會使用 Docker 做為 OCI 映像檔建構工具。
2. 安裝 Pack CLI。
3. 安裝 Git 原始碼控管工具，以便從 GitHub 中擷取範例應用程式。

使用 pack 指定建構工具版本

您可以在 pack 指令中附加 --builder 標記，指定要使用的建構工具版本：

pack build SERVICE_IMAGE_NAME --builder=BUILDER_IMAGE_URL

更改項目：

• BUILDER_IMAGE_URL，並提供建構工具的網址。範例：gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME 改為您為應用程式映像檔選擇的名稱。

如要進一步瞭解 pack 指令，請參閱 CLI 說明文件。

使用 project.toml 指定建構工具版本

使用 pack 建構時，您可以透過 buildpacks 專案描述元 (project.toml) 設定建構工具

1. 在應用程式根目錄中，建立名為 project.toml 的檔案，並加入下列設定：

   [build]
   builder = "BUILDER_IMAGE_URL"

2. 執行 `pack` 指令來建構應用程式：

   pack build SERVICE_IMAGE_NAME

更改下列內容：

• BUILDER_IMAGE_URL：產生器的網址，例如 gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME：您為應用程式映像檔選擇的名稱。

遠端建構作業

提交專案時，附加 --pack 旗標，即可使用 Cloud Build 搭配特定建構工具。

事前準備

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Build and Artifact Registry APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

如果您之前已經安裝了 Google Cloud CLI，請執行 gcloud components update 來確認您擁有最新版本。

1. 確認 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 repository」，請執行下列指令：

      gcloud artifacts repositories create buildpacks-docker-repo --repository-format=docker \
      --location=us-west2 --description="Docker repository"

   2. 確認存放區是否已成功建立：

      gcloud artifacts repositories list

      清單中應該會顯示您為 Docker 存放區選擇的名稱。

使用特定建構工具建構應用程式

1. 使用 gcloud 將應用程式原始碼提交至 Cloud Build：

   gcloud builds submit --pack builder=BUILDER_IMAGE_URL,image=LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/SERVICE_IMAGE_NAME

   取代：

   • 將 BUILDER_IMAGE_URL 替換為建構工具的網址。 範例：gcr.io/buildpacks/builder:google-24
   • LOCATION 替換為容器存放區的區域名稱。 範例：us-west2-docker.pkg.dev
   • 將 PROJECT_ID 替換為專案 ID。 Google Cloud
   • REPO_NAME 替換為 Docker 存放區的名稱。
   • SERVICE_IMAGE_NAME 改為您建立的容器映像檔名稱。

   如要進一步瞭解 submit 指令，請參閱 Cloud Build 說明文件。

2. 確認範例應用程式已成功發布至 REPO_NAME：

   gcloud artifacts docker images list LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME

   更改項目：

   • LOCATION 替換為容器存放區的區域名稱。 範例：us-west2-docker.pkg.dev
   • 將 PROJECT_ID 替換為專案 ID。 Google Cloud
   • REPO_NAME 替換為 Docker 存放區的名稱。

使用 Cloud Run 從原始碼部署

使用建構套件專案描述元檔案 (例如 project.toml 檔案)，在透過 Cloud Run 從來源部署時設定建構工具

1. 在應用程式目錄的根層級初始化 project.toml 檔案，然後將下列設定貼到該檔案中：

   [build]
   builder = "BUILDER_IMAGE_URL"

2. 從來源部署應用程式

   gcloud run deploy --source . SERVICE_IMAGE_NAME

更改項目：

• BUILDER_IMAGE_URL，並提供建構工具的網址。範例：gcr.io/buildpacks/builder:google-24
• SERVICE_IMAGE_NAME 改為您建立的容器映像檔名稱。