创建连接器代码库

控制台

1. 在 Google Cloud 控制台中打开代码库页面。

   打开“代码库”页面

2. 点击创建代码库。

3. 指定代码库名称。对于项目中的每个代码库位置，代码库名称不得重复。

4. 在格式部分，选择 Docker。

5. 在代码库模式部分中，选择连接器。

6. 在连接器代码库来源部分，选择以下选项之一：

   • Docker Hub：连接器使用 Docker Hub (https://docker.io) 作为上游代码库。
   • 自定义：连接器使用其他 Docker 上游网址作为上游代码库。

7. 如果您选择自定义，请在自定义代码库字段中输入完整的代码库网址。创建代码库后，网址便无法更改。

   如需查看一些常见的上游网址示例，请参阅自定义上游。

8. 在连接器仓库身份验证模式部分中，输入以下内容：

   1. 上游代码库的用户名。
   2. 用于在 Secret Manager 中存储凭据的 Secret。

   您可以在创建代码库后修改这些值。

9. 在位置类型部分中，选择代码库的位置：

   1. 选择位置类型：区域或多区域。位置列表会更改以反映您的选择。

   2. 在区域或多区域列表中，选择一个位置。

   如需了解位置类型和支持的位置，请参阅代码库位置

10. 为代码库添加说明。说明有助于您了解代码库的用途及其包含的工件类型。

    请勿包含敏感数据，因为代码库说明不会加密。

11. 如果您想使用标签来整理代码库，请点击添加标签，然后输入标签的键值对。您可以在创建代码库后添加、修改或移除标签。

12. 在加密部分中，选择代码库的加密机制。

    • Google-managed encryption key - 使用 Google-owned and Google-managed encryption key加密代码库内容。
    • 客户管理的密钥 - 使用您通过 Cloud Key Management Service 控制的密钥来加密代码库内容。如需查看密钥设置说明，请参阅为代码库设置 CMEK。

13. 在 Artifact Analysis 部分中，选择漏洞扫描设置：

    • 已启用 - 允许在此代码库中进行扫描。必须在您的项目中启用 Container Scanning API。

      当您启用 Container Scanning API 后，系统会立即开始计费。在项目上启用 Container Scanning API 后，系统会为所有新旧代码库启用漏洞扫描功能。当您将映像推送到 Artifact Registry 时，Artifact Analysis 会自动对其进行扫描。

    • 已停用 - 防止在此代码库中进行扫描。如果您的项目已启用 Container Scanning API，系统会继续扫描其他代码库，但会排除此代码库。

      如需详细了解漏洞扫描选项，请参阅启用和停用自动扫描。

14. 点击创建。

Artifact Registry 会创建代码库并将其添加到代码库列表中。

gcloud CLI

如需创建连接器代码库，请运行相应命令来创建 Docker 连接器代码库或自定义连接器代码库。

  gcloud artifacts repositories create CONNECTOR-REPOSITORY-NAME \
      --project=PROJECT_ID \
      --location=LOCATION \
      --description="DESCRIPTION" \
      --repository-format=docker \
      --mode=connector-repository \
      --remote-docker-repo="UPSTREAM-NAME" \
      --remote-username="USERNAME" \
      --remote-password-secret-version="PASSWORD" \

必须使用 --mode=connector-repository 标志将代码库定义为连接器代码库。--repository-format 必须是 docker。

替换以下内容：

• CONNECTOR-REPOSITORY-NAME：代码库的名称。对于项目中的每个代码库位置，代码库名称不得重复。
• PROJECT_ID：项目 ID。 如果省略此标志，则系统会使用当前项目或默认项目。
• LOCATION：制品库的单区域或多区域位置。如果您设置默认值，则可以省略此标志。如需查看受支持位置的列表，请运行命令 gcloud artifacts locations list。
• DESCRIPTION：可选。连接器仓库的说明。请勿包含敏感数据，因为代码库说明未加密。
• UPSTREAM-NAME：预设的上游名称或用户定义的上游代码库网址。
• USERNAME：可选。用于向上游代码库进行身份验证的用户名。
• PASSWORD：可选。包含上游代码库密码的密文版本。

例如，以下命令会创建一个名为 my-connector-repo 的连接器代码库，该代码库会将上游 Jfrog 代码库连接到 Google Cloud 项目 my-project。上游代码库的完整网址为 https://my-account.jfrog.io/scoped-repo。

gcloud artifacts repositories create my-connector-repo \
    --project=my-project \
    --location=us-east1 \
    --repository-format=docker \
    --mode=connector-repository \
    --remote-docker-repo=https://my-account.jfrog.io/scoped-repo \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1

如需详细了解如何向上游代码库进行身份验证，请参阅对连接器代码库进行身份验证以连接到上游来源。

Terraform

使用 google_artifact_registry_repository 资源创建代码库。 必须使用 terraform-provider-google 版本 5.0.0 或更高版本。

如果您刚开始使用 Terraform for Google Cloud，请参阅 HashiCorp 网站上的使用入门 - Google Cloud 页面。

以下示例定义了提供方和连接器代码库，其中 Terra 资源名称为 my-repo。

```hcl
provider "google" {
    project = "PROJECT-ID"
}

resource "google_artifact_registry_repository" "NAME" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "docker"
  mode          = "REMOTE_REPOSITORY"

  # Setting mode="REMOTE_REPOSITORY" and no_cache() together configures the repository as a connector-type repository.
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    docker_repository {
      public_repository = "DOCKER_HUB"
    }
    no_cache {}
  }
}
```

Replace the following:

  * `PROJECT-ID`: the Google Cloud project ID.
  * `NAME`: the name of your repository.
  * `LOCATION`: the repository location.
  * `REPOSITORY_ID`: the repository ID.
  * `DESCRIPTION`: optional. A description for the repository.
    Do not include sensitive data. Repository descriptions are
    not encrypted.
  * `KEY`: the name of the Cloud Key Management Service key, if you are using
    [customer-managed encryption keys][cmek] (CMEK) for encryption. Omit
    this argument to use the default setting, Google-managed encryption
    keys.
  * `CONFIG_DESCRIPTION`: optional. A description of the remote
    source.

控制台

1. 在 Google Cloud 控制台中打开代码库页面。

   打开“代码库”页面

2. 在代码库列表中，选择相应代码库，然后点击修改代码库。

3. 修改代码库说明，然后点击保存。

gcloud

如需更新代码库说明，请运行以下命令：

gcloud artifacts repositories update REPOSITORY \
    --project=PROJECT \
    --location=LOCATION \
    --description="DESCRIPTION"

替换以下内容：

• REPOSITORY：代码库的名称。如果您配置了默认代码库，则可以省略此标志以使用默认值。
• PROJECT： Google Cloud项目 ID。如果省略此标志，则系统会使用当前项目或默认项目。
• LOCATION 是代码库的单区域或多区域位置。 使用此标志可查看特定位置的代码库。如果您配置了默认位置，则可以省略此标志以使用默认值。
• DESCRIPTION：代码库的说明。