在已使用 App Hub 的環境中,App Hub 主專案可讓您建立多專案邊界。您可以將服務專案附加至主專案,並指派 App Hub 角色,管理這些專案的應用程式資源。主專案是舊版設定模式,因此請為新部署作業設定啟用應用程式管理功能的資料夾,以便存取所有以應用程式為中心的 Google Cloud 功能,例如 Application Design Center 和 Gemini Cloud Assist。如要比較可用的設定模型,請參閱「選擇應用程式設定模型」。
主專案和服務專案總覽
主專案是 Google Cloud專案,可附加其他專案,其中包含您要分組為 App Hub 應用程式的服務和工作負載。附加至主專案的專案稱為「服務專案」。主專案和服務專案的連結會定義多專案邊界。
主專案可以附加至自身,直接管理自己的資源。不過,如果是單一專案設定,建議採用單一專案方法。
事前準備
將 Google Cloud 專案設為主專案,並附加服務專案之前,請先完成下列步驟:
- 找出要用做主專案的 Google Cloud 專案。您可以使用現有專案或建立新專案。
找出要附加至主專案做為服務專案的 Google Cloud 專案。您必須找出所有專案,其中包含要註冊至 App Hub 應用程式的服務和工作負載。App Hub 無法查看其他專案中的資源。服務專案必須符合下列規定:
必要的角色
如要取得將服務專案附加至主專案所需的權限,請要求管理員在主專案和要附加的各個服務專案,授予您 App Hub 管理員 (roles/apphub.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。
設定主專案
如要將 Google Cloud 專案設為主專案,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,使用專案挑選器選取專案。
從 App Hub 前往「Overview」(總覽) 頁面:
按一下「Set up App Hub」(設定 App Hub)。
在「Enable App Hub」(啟用 App Hub) 頁面中,選擇「Full setup」(完整設定),建立多專案邊界。
記下專案名稱和 ID。這項資訊會識別主專案,您將使用這些值授予存取權。
查看正在啟用的 API 清單。某些 API 會產生相關費用。進一步瞭解 API 費用,或點選個別 API 查看相關費用。
按一下「繼續」。
在「Define boundary」(定義邊界) 分頁中,確認專案資訊。
按一下「 Add project」(新增專案),將服務專案新增至邊界,或稍後再新增。
按一下「繼續」。
在「Grant access」(授予存取權) 分頁中,為專案管理員選擇適當的 IAM 角色和權限。如需Google Cloud 產品中建議的應用程式中心角色清單,請參閱「將應用程式中心角色授予使用者」。
在「New principals」(新增主體) 方塊中,輸入應具備專案中應用程式中心工作管理員存取權的使用者、群組或服務帳戶。
依序點選「授予角色」和「完成」。
之後,您可以在「IAM」頁面為實體授予其他 IAM 角色。詳情請參閱「使用 Google Cloud 控制台授予 IAM 角色」一文。
gcloud
-
在 Google Cloud 控制台啟用 Cloud Shell。
Google Cloud 控制台底部會開啟 Cloud Shell 工作階段,並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境,並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。
確認已安裝最新版 Google Cloud CLI:
gcloud components update將主專案設為指令的預設專案:
gcloud config set project HOST_PROJECT_ID將
HOST_PROJECT_ID替換為要設為主專案的專案 ID。在主專案中啟用 App Hub API:
gcloud services enable apphub.googleapis.com \ --project=HOST_PROJECT_ID
新增服務專案
將服務專案附加至主專案,即可將服務專案新增至應用程式管理邊界。
如要將服務專案附加至主專案,並建立多專案邊界,請按照下列步驟操作:
控制台
gcloud
- 找出 要設為服務專案的各個 Google Cloud 專案 ID。
附加各項服務專案:
gcloud apphub service-projects add SERVICE_PROJECT_ID \ --project=HOST_PROJECT_ID更改下列內容:
SERVICE_PROJECT_ID:要附加的服務專案 ID。HOST_PROJECT_ID:主機專案的 ID。
針對要附加至主專案的每個服務專案,重複執行上述程序。
Terraform
如要使用 Terraform 將服務專案附加至主專案,請使用 google_apphub_service_project_attachment 資源,例如:
resource "google_apphub_service_project_attachment" "example" {
service_project_attachment_id = google_project.service_project.project_id
depends_on = [time_sleep.wait_120s]
}
resource "google_project" "service_project" {
project_id ="project-1"
name = "Service Project"
org_id = "123456789"
deletion_policy = "DELETE"
}
resource "time_sleep" "wait_120s" {
depends_on = [google_project.service_project]
create_duration = "120s"
}
如要將服務專案從主專案中卸載,請參閱「移除服務專案」。
指派 App Hub 角色和權限
如要將適當的 App Hub 角色和權限授予主專案和服務專案中的 App Hub 使用者,請按照下列步驟操作:
控制台
在 Google Cloud 控制台,使用專案挑選器選取主專案。
前往「IAM」頁面:
按一下「Grant access」(授予存取權)。 「授予存取權」窗格隨即開啟。
在「New principals」(新增主體) 欄位中,輸入要授予 App Hub 存取權的主體電子郵件地址。
按一下「Select a role」(選取角色),然後在「Filter」(篩選器) 欄位中輸入 App Hub。
選取要指派給主體的 App Hub IAM 角色,然後按一下「Save」(儲存)。
在您附加至主專案的每個 App Hub 服務專案中,重複上述程序,將相同角色授予相同使用者。
gcloud
將主專案中的主體授予存取權:
gcloud projects add-iam-policy-binding HOST_PROJECT_ID \ --member='user:EMAIL_ADDRESS' \ --role='ROLE_NAME'更改下列內容:
HOST_PROJECT_ID:主機專案的 ID。EMAIL_ADDRESS: 主體必須在主專案中取得 App Hub 存取權 ,是該主體的電子郵件地址。這個值必須採用username@yourdomain格式,例如my.user@example.com。ROLE_NAME:要指派給主體的 App Hub IAM 角色,例如roles/apphub.admin。
在您附加至主專案的每個 App Hub 服務專案中,將相同角色授予相同使用者:
gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \ --member='user:EMAIL_ADDRESS' \ --role='ROLE_NAME'將
SERVICE_PROJECT_ID替換為要授予存取權的服務專案 ID。
設定 VPC Service Controls
如要使用 VPC Service Controls perimeter 保護應用程式,請先將 App Hub 主機專案和服務專案新增至 perimeter,再建立應用程式。詳情請參閱「搭配使用 VPC Service Controls 與 App Hub」。
選用:設定指標範圍
如要在 Cloud Monitoring 中查看主專案內應用程式的系統指標,請將附加的服務專案新增至主專案的指標範圍。主專案可做為時間序列資料的範圍專案,用於繪製圖表及監控資料。如需更多資訊和設定操作說明,請參閱「設定指標範圍」和「使用 API 設定指標範圍」。
移除服務專案
從主專案卸離服務專案,即可將其從應用程式管理邊界中移除。
如要從主專案卸離服務專案,請按照下列步驟操作:
控制台
gcloud
- 找出要從主專案中移除的各項服務專案 ID。
移除各項服務專案:
gcloud apphub service-projects remove SERVICE_PROJECT_ID \ --project=HOST_PROJECT_ID更改下列內容:
SERVICE_PROJECT_ID:要移除的服務專案 ID。HOST_PROJECT_ID:主機專案的 ID。
針對要從主專案中移除的每個服務專案,重複執行上述程序。
從主專案移除服務專案時,如果您先前已設定指標範圍,建議您也從主專案的指標範圍中移除該服務專案。詳情請參閱「從指標範圍中移除專案」。