設定租戶專案和資源

App Lifecycle Manager 租戶可讓您整理已部署的單位,並將資源部署至不同的租戶專案,以便隔離及管理基礎架構。

如需租戶和租戶專案的總覽,請參閱「租戶和租戶專案」。

事前準備

建立租戶專案或資源前:

  1. 在供應商專案中,建立 Terraform 設定、Artifact Registry 存放區,以及包含 SaaS 應用程式的構件。如要瞭解如何建立及上傳藍圖,請參閱「建立及上傳藍圖」。如要瞭解如何設定 SaaS 產品,請參閱「快速入門導覽課程:使用 App Lifecycle Manager 部署應用程式」。
  2. 啟用 App Lifecycle Manager 所需的 API。

    啟用 API 所需的角色

    如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  3. 確認已建立必要的服務帳戶,並在供應商專案中授予必要的 Identity and Access Management 角色。這包括使用者建立的服務帳戶,以及授予供應商專案中 service-PROJECT_NUMBER@gcp-sa-saasservicemgmt. 服務代理的角色,其中 PROJECT_NUMBER 是供應商專案的專案編號。

設定租戶專案

將租戶資源佈建至個別專案時,各租戶的資源、IAM 政策、配額和網路設定都會分開,因此單一租戶發生違規或設定錯誤時,較不可能影響其他租戶。

您需要以下資訊:

  • 一個生產者專案
  • 每個租戶一個租戶專案

控制台

如要使用 Google Cloud 控制台設定租戶和供應商專案,請按照下列步驟操作:

  1. 為每個租戶建立一個供應商專案和一個租戶專案。
  2. 為租戶和供應商專案啟用計費功能。
  3. 在租戶專案中啟用 App Lifecycle Manager 所需的 API。

    啟用 API 所需的角色

    如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

    啟用 API

  4. 確認租戶專案具備具備必要權限的啟動服務帳戶。

    詳情請參閱「App Lifecycle Manager 服務帳戶」。

為供應商和租戶專案建立並啟用計費功能後,即可建立租戶資源,並將單位與租戶建立關聯。

gcloud

如要使用 Google Cloud CLI 設定生產者和租戶專案,請按照下列步驟操作:

  1. 建立供應商專案,並為每個租戶建立租戶專案:

    gcloud projects create \
        PRODUCER_PROJECT_ID \
        --name="SaaS producer project"
    gcloud projects create \
        TENANT_PROJECT_ID \
        --name="SaaS tenant A project"
    

    更改下列內容:

    • PRODUCER_PROJECT_ID:供應商專案 ID
    • TENANT_PROJECT_ID:租戶專案 ID
  2. 為租戶和供應商專案啟用計費功能:

    gcloud billing projects link \
        PRODUCER_PROJECT_ID \
        --billing-account=BILLING_ACCOUNT_ID
    gcloud billing projects link \
        TENANT_PROJECT_ID \
        --billing-account=BILLING_ACCOUNT_ID
    

    更改下列內容:

    • BILLING_ACCOUNT_ID:要與指定專案建立關聯的帳單帳戶 ID
  3. 在租戶專案中啟用 App Lifecycle Manager 所需的 API:

    gcloud services enable \
        saasservicemgmt.googleapis.com \
        artifactregistry.googleapis.com \
        config.googleapis.com \
        developerconnect.googleapis.com \
        cloudbuild.googleapis.com \
        storage.googleapis.com \
        --project=TENANT_PROJECT_ID
    
  4. 為每個租戶專案授予執行服務帳戶必要的 IAM 角色:

    gcloud projects add-iam-policy-binding \
        TENANT_PROJECT_ID \
        --member='serviceAccount:SERVICE_ACCOUNT_ID@PRODUCER_PROJECT_ID.' \
        --role=ROLE
    

    更改下列內容:

    • SERVICE_ACCOUNT_ID:執行服務帳戶的 ID
    • ROLE:要授予的 IAM 角色 (例如 roles/compute.admin)

    針對要授予指定服務帳戶的每個角色,執行 gcloud projects add-iam-policy-binding。

為供應商和租戶專案建立並啟用計費功能後,即可建立租戶資源,並將單位與租戶建立關聯。

建立租戶資源

在 SaaS 產品中建立租戶資源,代表客戶:

  1. 在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Tenants」。

    前往「Tenants」(租戶) 頁面

  2. 點選 「Create」(建立)。

  3. 在「Tenant name」(租戶名稱) 欄位中,輸入租戶資源的名稱。

  4. 選用:在「Consumer resource」(用戶端資源) 欄位中,輸入用戶端資源,並採用用戶端定義的整合設定。

  5. 在「SaaS offering」(SaaS 產品) 清單中,選取要與租戶建立關聯的 SaaS 產品。

  6. 從「Region」(區域) 清單中,選取儲存租戶中繼資料的區域。

  7. 選用:按一下 「Add label」(新增標籤),以鍵/值組合的形式為租戶新增標籤。

  8. 點選「建立」。

將單位與租戶建立關聯

建立租戶並部署單位後,即可將兩者連結。這項關聯主要做為組織標記,協助您整理哪些單位屬於哪個租戶。

如要進一步瞭解如何部署單元,請參閱「部署 SaaS 產品」。

如要將單元與租戶建立關聯,請按照下列步驟操作:

  1. 在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Tenants」。

    前往「Tenants」(租戶) 頁面

  2. 按一下要與單位建立關聯的租戶名稱。

  3. 按一下「Edit」(編輯)。

  4. 在「Select a unit to be included in the tenant.」(選取要納入租戶的單元。) 下方,按一下 「Add unit」(新增單元)。

  5. 在「Unit」(單元) 清單中,選取要與這個租戶建立關聯的單元。

  6. 按一下「完成」。

  7. 按一下「儲存」。

所選單元已與指定租戶建立關聯。

使用租戶專案變數佈建新單元

佈建與租戶相關聯的單元時,您必須提供 tenant_project_id 和 tenant_project_number 變數。

  1. 在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Units」。

    前往「單位」

  2. 建立與單元 kind 相關聯的新單元。

  3. 按一下「 佈建」。

  4. 選取要佈建至獨立租用環境的版本。

  5. 在「Actuation service account」(執行服務帳戶) 下方的「Service account」(服務帳戶) 清單中,選取您在租戶專案中授予角色的服務帳戶。請遵循最小權限原則,只授予受管理資源所需的角色。

  6. 在「Other input variables」(其他輸入變數) 部分:

    1. 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入 tenant_project_id 和 tenant_project_number 變數。
    2. 選用:按一下「 Add input variable」(新增輸入變數),輸入 Terraform 設定中定義的其他輸入變數。
  7. 點選「佈建」。

App Lifecycle Manager 會使用指定的啟動服務帳戶,觸發 Infrastructure Manager。Infrastructure Manager 會讀取 tenant_project_id 和 tenant_project_number 變數,並在該租戶專案中佈建 Terraform 資源。

使用新版本重新佈建單元

使用新版本重新佈建現有單元時,必須提供 tenant_project_id 和 tenant_project_number 變數。

  1. 在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Units」。

    前往「單位」

  2. 選取與單元 kind 相關聯的單元。

  3. 按一下「升級」。

  4. 選取您使用更新後的 Terraform 設定建立的版本。

  5. 在「Actuation service account」(啟動服務帳戶) 下方的「Service account」(服務帳戶) 清單中,選取您在租戶專案中授予角色的服務帳戶。請遵循最小權限原則,只授予受管理資源所需的角色。

  6. 在「Other input variables」(其他輸入變數) 部分:

    1. 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入 tenant_project_id 和 tenant_project_number 變數。
    2. 選用:按一下「 Add input variable」(新增輸入變數),輸入 Terraform 設定中定義的其他輸入變數。
  7. 按一下「升級」。

App Lifecycle Manager 會使用指定的啟動服務帳戶,觸發 Infrastructure Manager。Infrastructure Manager 會讀取 tenant_project_id 和 tenant_project_number 變數,並更新該租戶專案中的 Terraform 資源。

後續步驟