创建和访问实例

创建和访问实例

创建 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 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要拥有 Project Creator 角色 (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，您需要拥有 Service Usage Admin 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 角色，您可以选择已获授角色的任何项目。
• 创建项目：如需创建项目，您需要拥有 Project Creator 角色 (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，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予 角色。

gcloud services enable securesourcemanager.googleapis.com

所需的角色

如要获得创建 Secure Source Manager 实例所需的权限，请让您的管理员为您授予项目的 Instance Owner (roles/securesourcemanager.instanceOwner) IAM 角色。 Google Cloud

注意： 您项目的 Secure Source Manager Admin 角色 (roles/securesourcemanager.admin) 或 Owner (roles/owner) IAM 基本角色也包含创建 实例的权限。您不应在生产环境中授予管理员角色或基本角色，但可以在开发或测试环境中授予这些角色。

Secure Source Manager 角色在授予给正文之前不会显示在 Google Cloud 控制台中，直到 它们被授予给正文。如需首次授予 Secure Source Manager 角色 ，请参阅 授予和撤消 IAM 角色。

创建实例

1. 运行以下命令，在 us-central1 位置创建一个名为 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，因为您需要使用它来检查操作的状态。

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 网址。您需要此网址才能通过网络浏览器访问实例。

访问实例

创建实例后，您可以使用浏览器通过其网页界面访问该实例。

注意 ：如需在 实例中创建代码库，您需要拥有实例项目的 Repo Creator 角色 （roles/securesourcemanager.repoCreator）和 Secure Source Manager 实例的 Instance Repository Creator 角色 （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 网页界面随即打开。您可以通过 Web 界面创建和查看代码库以及所有关联的问题和拉取请求。

清理

为避免因本页面中使用的资源导致您的 Google Cloud 账号产生费用，请删除包含这些资源的 Google Cloud 项目。

警告：删除项目会产生以下影响

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目 可以帮助您避免超出项目配额限制。

1. 在 Google Cloud 控制台中，前往 管理资源 页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击 关闭以删除项目。

后续步骤

• 创建和克隆代码库
• 授予用户实例访问权限
• 添加代码库用户