設定單一專案

本文說明如何設定單一 Google Cloud 專案來管理應用程式。這項設定也稱為「單一專案界線」。

在這個設定中， Google Cloud 專案會設定為管理自己的應用程式和元件，做為獨立的管理專案。如果所有應用程式元件都位於這個單一專案中，這是開始管理應用程式的最快方式。App Hub 會自動探索專案中所有支援的資源，並將這些資源整理成應用程式。

限制

與資料夾層級邊界相比，單一專案邊界支援的功能不同。App Hub、Application Design Center 和 Application Monitoring 完全支援單一專案，但其他以應用程式為中心的 Google Cloud 服務 (例如 Cloud Hub 和 Gemini Cloud Assist) 則需要資料夾層級的界線。

如要比較單一專案和資料夾層級模式的功能支援情形，請參閱「依邊界類型劃分的功能支援情形」。

事前準備

選擇要用來管理應用程式的 Google Cloud 專案。這項專案將做為獨立的管理專案。您可以使用現有專案或建立新專案。

必要的角色

如要取得設定單一專案以管理應用程式所需的權限，請要求管理員在您要設定為獨立管理專案的專案中，授予下列 IAM 角色：

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

為專案啟用應用程式管理功能

這項動作會將專案設定為獨立管理專案，並啟用應用程式中繼資料和設定的必要 API。這類專案稱為「已啟用應用程式的專案」。

如要為單一專案啟用應用程式管理功能，請按照下列步驟操作：

控制台

  1. 在 Google Cloud 控制台，使用專案挑選器選取專案。

  2. 從 App Hub 前往「總覽」頁面：

    前往「Overview」(總覽) 頁面

  3. 按一下「設定應用程式中心」。

    如果專案已位於已啟用應用程式管理功能的資料夾中，頁面就不會顯示「設定 App Hub」選項。系統會提示您從選單中選取已啟用應用程式管理功能的資料夾，或是使用目前的專案。選取目前的專案，繼續進行單一專案設定。如要進一步瞭解應用程式管理資源階層結構的注意事項，請參閱「規劃應用程式管理的資源階層結構」。

  4. 在「Enable App Hub」(啟用 App Hub) 頁面中，選擇下列其中一個選項：

    • 快速設定：管理這項專案中資源的預設設定，並定義第一個應用程式，以便初步採用。
    • 完整設定：管理應用程式的自訂設定，包括設定預先存取控管，以及視需要新增更多專案，以建立多專案界線。

  5. 記下專案名稱和 ID。這項資訊會識別管理專案，您將使用這些值授予存取權。

  6. 查看正在啟用的 API 清單。部分 API 會產生相關費用。 進一步瞭解 API 費用，或點選個別 API 查看相關費用。

  7. 按一下「繼續」。

  8. 根據選用的方法完成設定：

    • 如果選取「快速設定」，「定義應用程式」分頁會讓您選擇立即定義應用程式，或在不建立應用程式的情況下完成設定。您現在可以建立應用程式，並向應用程式註冊資源。您也可以參閱應用程式快速入門指南。

    • 如果您選取「Full setup」(完整設定)，請為管理員授予自訂應用程式中心存取權：

      1. 在「定義邊界」分頁中，確認專案資訊。「Projects in your boundary」(邊界內的專案) 表格只會顯示定義單一專案邊界的專案。如果是單一專案邊界設定，請勿新增任何其他專案。

      2. 按一下「繼續」。

      3. 在「Grant access」(授予存取權) 分頁中，為專案管理員選擇適當的 IAM 角色和權限。如需Google Cloud 產品中建議的應用程式中心角色清單，請參閱「將應用程式中心角色授予使用者」。

      4. 在「New principals」(新增主體) 方塊中，輸入應具備專案中應用程式中心工作管理員存取權的使用者、群組或服務帳戶。

      5. 依序點選「授予角色」和「完成」。

      您現在可以透過 Application Design Center，將現有資源註冊至應用程式，或建立應用程式範本。

您之後可以透過「IAM」頁面，授予主體其他 IAM 角色。詳情請參閱「使用 Google Cloud 控制台授予 IAM 角色」一文。

gcloud

  1. 在 Google Cloud 控制台中啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

  2. 確認已安裝最新版的 Google Cloud CLI：

    gcloud components update

  3. 找出專案 ID。

  4. 將專案設為指令的預設專案：

    gcloud config set project PROJECT_ID

    將 PROJECT_ID 替換為專案 ID。

  5. 啟用 App Hub API：

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

  6. 將專案附加至自身，建立應用程式管理邊界：

    gcloud apphub boundary update \
    --crm-node=projects/PROJECT_ID \
    --project=PROJECT_ID \
    --location=global

    這個指令會將專案設為自己的管理專案，讓 App Hub 自動探索專案中所有支援的資源。

  7. 確認附件狀態：

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    輸出內容應如下列範例所示。

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_ID
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

管理專案設定完成後，應用程式管理所需的 API 就會啟用，您也可以開始使用 App Hub，將服務和工作負載歸入應用程式。如要使用進階功能，請視需要查看建議的 API。

指派 App Hub 角色和權限

如要讓使用者透過 App Hub 探索、註冊及管理這項專案中的應用程式元件，您必須授予適當的 App Hub 角色和權限。

步驟如下：

控制台

  1. 在 Google Cloud 控制台，使用專案挑選器選取管理專案。

  2. 前往「IAM」頁面：

    前往「身分與存取權管理」頁面

  3. 按一下「Grant access」(授予存取權)。 「授予存取權」窗格隨即開啟。

  4. 在「New principals」(新增主體) 欄位中，輸入要授予應用程式中心存取權的主體電子郵件地址。

  5. 按一下「選取角色」，然後在「篩選條件」欄位中輸入「App Hub」。

  6. 選取要指派給主體的「App Hub IAM 角色」，然後按一下「儲存」。

gcloud

  1. 在管理專案中授予主體存取權：

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

    更改下列內容：

    • PROJECT_ID：管理專案的 ID。
    • EMAIL_ADDRESS：必須取得 App Hub 存取權的校長電子郵件地址。這個值必須採用 username@yourdomain 格式，例如 my.user@example.com。
    • ROLE_NAME：要指派給主體的應用程式中心 IAM 角色，例如 roles/apphub.admin。

變更應用程式管理邊界

如要變更定義單一專案邊界的專案，請在舊專案中停用應用程式管理，並在新專案中啟用。應用程式資料不會遷移，您必須在新專案中重新建立應用程式。

如要從單一專案邊界改為資料夾層級邊界，請設定已啟用應用程式管理功能的資料夾。這項操作會在資料夾中設定新的管理專案。您必須在這個新的管理專案中重新建立應用程式。

停用專案的應用程式管理功能

如果您不想再透過 App Hub 應用程式管理專案資源，可以停用專案的應用程式管理功能。

停用專案的應用程式管理功能後，專案就會從應用程式管理邊界中分離。應用程式中的服務和工作負載會繼續存在，但其註冊狀態會變更為「已卸離」。如果您決定重新啟用專案的應用程式管理功能，App Hub 就能重新探索應用程式、服務和工作負載，並在基礎資源仍存在時更新註冊狀態。

如要停用單一專案的應用程式管理功能，請按照下列步驟操作：

控制台

  1. 在 Google Cloud 控制台，使用專案挑選器選取管理專案。

    前往「歡迎」

  2. 從 App Hub 前往「Boundary settings」(邊界設定) 頁面：

    前往「邊界設定」

  3. 勾選專案的核取方塊，將專案從邊界卸離，並停用應用程式管理功能。

  4. 按一下「Detach projects」(卸載專案)。

    「邊界內的專案」表格會重新整理，不再顯示專案資訊。

gcloud

  1. 在 Google Cloud 控制台中啟用 Cloud Shell。

    啟用 Cloud Shell

    Google Cloud 控制台底部會開啟 Cloud Shell 工作階段，並顯示指令列提示。Cloud Shell 是已安裝 Google Cloud CLI 的殼層環境，並已設定適用於您目前專案的值。工作階段可能要幾秒鐘的時間才能初始化。

  2. 確認已安裝最新版的 Google Cloud CLI：

    gcloud components update

  3. 找出專案 ID。

  4. 將專案設為指令的預設專案：

    gcloud config set project PROJECT_ID

    將 PROJECT_ID 替換為專案 ID。

  5. 從邊界卸離專案，即可停用應用程式管理功能：

    gcloud apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --crm-node=""

    這個指令會更新邊界資源並移除附件，進而停用專案的應用程式管理功能。

  6. 請說明邊界，確認要卸除：

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    輸出內容不含 crmNode 欄位，確認專案已停用應用程式管理功能。

  7. (選用) 如果您不會再使用這個專案中的應用程式功能，請刪除專案中的所有應用程式，然後停用 App Hub API：

    gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

後續步驟