App Lifecycle Manager 租戶可讓您整理已部署的單位,並將資源部署至不同的租戶專案,以便隔離及管理基礎架構。
如需租戶和租戶專案的總覽,請參閱「租戶和租戶專案」。
事前準備
建立租戶專案或資源前:
- 在供應商專案中,建立 Terraform 設定、Artifact Registry 存放區,以及包含 SaaS 應用程式的構件。如要瞭解如何建立及上傳藍圖,請參閱「建立及上傳藍圖」。如要瞭解如何設定 SaaS 產品,請參閱「快速入門導覽課程:使用 App Lifecycle Manager 部署應用程式」。
啟用 App Lifecycle Manager 所需的 API。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。確認已建立必要的服務帳戶,並在供應商專案中授予必要的 Identity and Access Management 角色。這包括使用者建立的服務帳戶,以及授予供應商專案中
service-PROJECT_NUMBER@gcp-sa-saasservicemgmt.服務代理的角色,其中PROJECT_NUMBER是供應商專案的專案編號。
設定租戶專案
將租戶資源佈建至個別專案時,各租戶的資源、IAM 政策、配額和網路設定都會分開,因此單一租戶發生違規或設定錯誤時,較不可能影響其他租戶。
您需要以下資訊:
- 一個生產者專案
每個租戶一個租戶專案
控制台
如要使用 Google Cloud 控制台設定租戶和供應商專案,請按照下列步驟操作:
- 為每個租戶建立一個供應商專案和一個租戶專案。
- 為租戶和供應商專案啟用計費功能。
在租戶專案中啟用 App Lifecycle Manager 所需的 API。
啟用 API 所需的角色
如要啟用 API,您必須具備
serviceusage.services.enable權限。如果您建立了專案,可能已透過擁有者角色 (roles/owner) 取得這項權限。否則,您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。確認租戶專案具備具備必要權限的啟動服務帳戶。
詳情請參閱「App Lifecycle Manager 服務帳戶」。
為供應商和租戶專案建立並啟用計費功能後,即可建立租戶資源,並將單位與租戶建立關聯。
gcloud
如要使用 Google Cloud CLI 設定生產者和租戶專案,請按照下列步驟操作:
建立供應商專案,並為每個租戶建立租戶專案:
gcloud projects create \ PRODUCER_PROJECT_ID \ --name="SaaS producer project" gcloud projects create \ TENANT_PROJECT_ID \ --name="SaaS tenant A project"更改下列內容:
PRODUCER_PROJECT_ID:供應商專案 IDTENANT_PROJECT_ID:租戶專案 ID
為租戶和供應商專案啟用計費功能:
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
在租戶專案中啟用 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為每個租戶專案授予執行服務帳戶必要的 IAM 角色:
gcloud projects add-iam-policy-binding \ TENANT_PROJECT_ID \ --member='serviceAccount:SERVICE_ACCOUNT_ID@PRODUCER_PROJECT_ID.' \ --role=ROLE更改下列內容:
SERVICE_ACCOUNT_ID:執行服務帳戶的 IDROLE:要授予的 IAM 角色 (例如roles/compute.admin)
針對要授予指定服務帳戶的每個角色,執行
gcloud projects add-iam-policy-binding。
為供應商和租戶專案建立並啟用計費功能後,即可建立租戶資源,並將單位與租戶建立關聯。
建立租戶資源
在 SaaS 產品中建立租戶資源,代表客戶:
在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Tenants」。
點選 「Create」(建立)。
在「Tenant name」(租戶名稱) 欄位中,輸入租戶資源的名稱。
選用:在「Consumer resource」(用戶端資源) 欄位中,輸入用戶端資源,並採用用戶端定義的整合設定。
在「SaaS offering」(SaaS 產品) 清單中,選取要與租戶建立關聯的 SaaS 產品。
從「Region」(區域) 清單中,選取儲存租戶中繼資料的區域。
選用:按一下 「Add label」(新增標籤),以鍵/值組合的形式為租戶新增標籤。
點選「建立」。
將單位與租戶建立關聯
建立租戶並部署單位後,即可將兩者連結。這項關聯主要做為組織標記,協助您整理哪些單位屬於哪個租戶。
如要進一步瞭解如何部署單元,請參閱「部署 SaaS 產品」。
如要將單元與租戶建立關聯,請按照下列步驟操作:
在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Tenants」。
按一下要與單位建立關聯的租戶名稱。
按一下「Edit」(編輯)。
在「Select a unit to be included in the tenant.」(選取要納入租戶的單元。) 下方,按一下 「Add unit」(新增單元)。
在「Unit」(單元) 清單中,選取要與這個租戶建立關聯的單元。
按一下「完成」。
按一下「儲存」。
所選單元已與指定租戶建立關聯。
使用租戶專案變數佈建新單元
佈建與租戶相關聯的單元時,您必須提供 tenant_project_id 和 tenant_project_number 變數。
在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Units」。
建立與單元 kind 相關聯的新單元。
按一下「 佈建」。
選取要佈建至獨立租用環境的版本。
在「Actuation service account」(執行服務帳戶) 下方的「Service account」(服務帳戶) 清單中,選取您在租戶專案中授予角色的服務帳戶。請遵循最小權限原則,只授予受管理資源所需的角色。
在「Other input variables」(其他輸入變數) 部分:
- 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入
tenant_project_id和tenant_project_number變數。 - 選用:按一下「 Add input variable」(新增輸入變數),輸入 Terraform 設定中定義的其他輸入變數。
- 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入
點選「佈建」。
App Lifecycle Manager 會使用指定的啟動服務帳戶,觸發 Infrastructure Manager。Infrastructure Manager 會讀取 tenant_project_id 和 tenant_project_number 變數,並在該租戶專案中佈建 Terraform 資源。
使用新版本重新佈建單元
使用新版本重新佈建現有單元時,必須提供 tenant_project_id 和 tenant_project_number 變數。
在 Google Cloud 控制台中,依序前往「App Lifecycle Manager」>「Units」。
選取與單元 kind 相關聯的單元。
按一下「升級」。
選取您使用更新後的 Terraform 設定建立的版本。
在「Actuation service account」(啟動服務帳戶) 下方的「Service account」(服務帳戶) 清單中,選取您在租戶專案中授予角色的服務帳戶。請遵循最小權限原則,只授予受管理資源所需的角色。
在「Other input variables」(其他輸入變數) 部分:
- 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入
tenant_project_id和tenant_project_number變數。 - 選用:按一下「 Add input variable」(新增輸入變數),輸入 Terraform 設定中定義的其他輸入變數。
- 按一下「 Add tenant project variables」(新增租戶專案變數),然後選取租戶專案,填入
按一下「升級」。
App Lifecycle Manager 會使用指定的啟動服務帳戶,觸發 Infrastructure Manager。Infrastructure Manager 會讀取 tenant_project_id 和 tenant_project_number 變數,並更新該租戶專案中的 Terraform 資源。
後續步驟
- 瞭解如何管理單元之間的依附元件。
- 進一步瞭解如何使用變數和變數對應。
- 查看服務帳戶所需的權限。