建立及存取執行個體

建立及存取執行個體

建立 Secure Source Manager 執行個體並存取其網頁介面，準備建立存放區及授予使用者存取權。

注意： Secure Source Manager 不支援網域範圍專案。如果專案 ID 包含冒號 (:)，您必須先建立新專案，才能使用 Secure Source Manager。

事前準備

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

安裝 Google Cloud CLI。

注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。

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

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

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您已獲授角色，即可選取任何專案。
• 建立專案：如要建立專案，您需要具備專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。完成這些步驟後，您就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

確認專案已啟用計費功能 Google Cloud 。

啟用 Secure Source Manager API：

啟用 API 時所需的角色

如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

gcloud services enable securesourcemanager.googleapis.com

安裝 Google Cloud CLI。

注意：如果您先前已安裝 gcloud CLI，請執行 gcloud components update，確認您使用的是最新版本。

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

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

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您已獲授角色，即可選取任何專案。
• 建立專案：如要建立專案，您需要具備專案建立者角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。完成這些步驟後，您就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

確認專案已啟用計費功能 Google Cloud 。

啟用 Secure Source Manager API：

啟用 API 時所需的角色

如要啟用 API，您需要具備服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

gcloud services enable securesourcemanager.googleapis.com

必要的角色

如要取得建立 Secure Source Manager 執行個體所需的權限，請要求管理員授予您 Google Cloud 專案的執行個體擁有者 (roles/securesourcemanager.instanceOwner) IAM 角色。

注意： 專案的Secure Source Manager 管理員角色 (roles/securesourcemanager.admin) 或IAM 基本角色 (擁有者 roles/owner) 也包含建立執行個體的權限。您不應在正式環境中授予管理員角色或基本角色，但可以在開發或測試環境中授予這些角色。

Secure Source Manager 角色必須先授予主體，才會顯示在 Google Cloud 控制台中。如要首次授予 Secure Source Manager 角色，請參閱「授予及撤銷 IAM 角色」。

建立執行個體

1. 執行下列指令，在 us-central1 location 中建立名為 my-instance 的執行個體。系統可能會要求您向 gcloud CLI 進行驗證。

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   其中：

   • my-instance 是執行個體的名稱。
   • us-central1 是您要建立執行個體的地區。

   系統會啟動長時間執行的建立執行個體作業。輸出結果看起來與下列內容相似：

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   其中：

   • projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e 是OPERATION_NAME。
   • PROJECT_ID 是您的專案 ID。

   建立執行個體最多需要 60 分鐘。

2. 請記下 OPERATION_NAME，因為您需要使用這個 ID 來檢查作業狀態。

3. 執行下列指令，檢查 create 作業的狀態：

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   更改下列內容：

   • OPERATION_NAME，並將其替換為建立指令回應中的作業名稱。

   執行個體準備就緒後，回應內容應如下所示：

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   其中：

   • my-instance-098765432109.us-central1.sourcemanager.dev 是執行個體 HTML 網址。
   • PROJECT_ID 是您的專案 ID。
   注意： 狀態檢查可能會在執行個體完全運作前，回報作業已完成。如果在建立執行個體後存取時發生錯誤，請等待 60 分鐘，然後再試一次。如果仍無法存取，請透過 Secure Source Manager 支援團隊的電子郵件地址 [e-mail] 尋求協助。

4. 從成功建立的檢查狀態指令中複製 HTML 網址。您需要這個網址，才能透過網路瀏覽器存取執行個體。

存取執行個體

建立執行個體後，您可以使用瀏覽器透過網頁介面存取執行個體。

注意： 如要在執行個體中建立存放區，您需要具備執行個體專案的存放區建立者角色 (roles/securesourcemanager.repoCreator)，以及 Secure Source Manager 執行個體的執行個體存放區建立者角色 (roles/securesourcemanager.instanceRepositoryCreator)。

1. 如要取得執行個體的 HTML 網址，請再次執行下列指令：

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. 從 gcloud source-manager operations describe 指令的成功回應中複製 HTML 網址，然後貼到瀏覽器的網址列。

3. 系統會顯示 OAuth 2.0 畫面，詢問您是否要授權sourcemanager.dev存取 Google Cloud 帳戶。

4. 點選「允許」按鈕。

5. Secure Source Manager 網頁介面隨即開啟。您可以在網頁介面中建立及查看存放區，以及所有相關聯的問題和提取要求。

清除所用資源

為了避免系統向您的 Google Cloud 帳戶收取本頁面所用資源的費用，請刪除含有這些資源的 Google Cloud 專案。

注意：刪除專案會造成以下結果：

• 專案中的所有內容都會遭到刪除。如果使用現有專案來進行本文中的任務，刪除專案將一併移除當中已完成的其他任務'。
• 自訂專案 ID 會消失。當您之前建立這個專案時，可能建立了想要在日後使用的自訂專案 ID。如要保留使用該專案 ID 的網址 (例如 appspot.com 網址)，請刪除在該專案中選取的資源，而不是刪除整個專案。

如果打算探索多種架構、教學課程或快速入門導覽課程，重複使用專案可避免超出專案配額限制。

1. 前往 Google Cloud 控制台的「Manage resources」(管理資源) 頁面。

   前往「Manage resources」(管理資源)

2. 在專案清單中選取要刪除的專案，然後點選「Delete」(刪除)。
3. 在對話方塊中輸入專案 ID，然後按一下 [Shut down] (關閉) 以刪除專案。

後續步驟

• 建立及複製存放區
• 授予使用者執行個體存取權
• 新增存放區使用者