建立及存取執行個體

建立及存取執行個體

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

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

事前準備

1. 安裝 Google Cloud CLI。

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

2. 設定 gcloud CLI，使用您的聯合身分。

   詳情請參閱「使用聯合身分登入 gcloud CLI」。

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

   gcloud init

4. 建立或選取 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 專案名稱。

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

6. 啟用 Secure Source Manager API：

   啟用 API 時所需的角色

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

   gcloud services enable securesourcemanager.googleapis.com

必要的角色

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

注意： 專案的安全來源管理員角色 (roles/securesourcemanager.admin) 或身分與存取權管理基本角色 (擁有者 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
   

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

2. 請記下 OPERATION_NAME，這是回應您要求時收到的作業完整資源名稱。格式如下，且在下一個步驟中檢查作業狀態時必須提供：

   projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

   例如： projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e 其中 PROJECT_ID 是您的 Google Cloud 專案。

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 分鐘，然後再試一次。如果問題仍未解決，請傳送電子郵件至 [e-mail]，向 Secure Source Manager 支援團隊尋求協助。

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] (關閉) 以刪除專案。

後續步驟

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