커넥터 저장소 만들기

콘솔

1. 콘솔에서 저장소 페이지를 엽니다. Cloud de Confiance

   저장소 페이지 열기

2. 저장소 만들기 를 클릭합니다.

3. 저장소 이름을 지정합니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.

4. 형식 섹션에서 Docker 를 선택합니다.

5. 저장소 모드 섹션에서 커넥터 를 선택합니다.

6. 커넥터 저장소 소스 섹션에서 다음 옵션 중 하나를 선택합니다.

   • Docker Hub: 커넥터는 Docker Hub (https://docker.io)를 업스트림 저장소로 사용합니다.
   • 커스텀: 커넥터는 업스트림 저장소에 다른 Docker 업스트림 URL을 사용합니다.

7. 커스텀을 선택한 경우 커스텀 저장소 필드에 전체 저장소 URL을 입력합니다. 저장소를 만든 후에는 URL을 변경할 수 없습니다.

   일반적인 업스트림 URL의 예시는 커스텀 업스트림을 참조하세요.

8. 커넥터 저장소 인증 모드 섹션에서 다음을 입력합니다.

   1. 업스트림 저장소의 사용자 이름
   2. Secret Manager에 사용자 인증 정보를 저장할 보안 비밀

   저장소를 만든 후에는 이 값을 수정할 수 있습니다.

9. 위치 유형 섹션에서 저장소의 위치를 선택합니다.

   1. 위치 유형(리전 또는 멀티 리전)을 선택합니다. 선택 사항이 반영되도록 위치 목록이 변경됩니다.

   2. 리전 또는 멀티 리전 목록에서 위치를 선택합니다.

   위치 유형 및 지원되는 위치에 대한 자세한 내용은 저장소 위치를 참조하세요.

10. 저장소에 대한 설명을 추가합니다. 설명은 저장소의 용도와 저장소에 포함된 아티팩트의 종류를 식별하는 데 도움이 됩니다.

    저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.

11. 라벨을 사용하여 저장소를 구성하려면 라벨 추가를 클릭하고 라벨의 키-값 쌍을 입력합니다. 저장소를 만든 후 라벨을 추가, 수정 또는 삭제할 수 있습니다.

12. 암호화 섹션에서 저장소의 암호화 메커니즘을 선택합니다.

    • Google Cloud-powered encryption key - 저장소 콘텐츠를 a Google Cloud-powered 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: 업스트림 저장소의 사전 설정 업스트림 이름 또는 사용자 정의 URL입니다.
• USERNAME: 선택사항입니다. 업스트림 저장소에 인증하기 위한 사용자 이름입니다.
• PASSWORD: 선택사항입니다. 업스트림 저장소 비밀번호가 포함된 보안 비밀 버전입니다.

예를 들어 다음 명령어는 업스트림 Jfrog 저장소를 프로젝트 my-project에 연결하는 my-connector-repo라는 커넥터 저장소를 만듭니다. Cloud de Confiance 업스트림 저장소의 전체 URL은 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을 처음 사용하는 경우 Cloud de Confiance by S3NS 시작하기 - Cloud de Confiance by S3NS 페이지를 HashiCorp 웹사이트에서 참조하세요.

다음 예시에서는 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 Cloud de Confiance 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. 콘솔에서 저장소 페이지를 엽니다. Cloud de Confiance

   저장소 페이지 열기

2. 저장소 목록에서 저장소를 선택하고 저장소 수정 을 클릭합니다.

3. 저장소 설명을 수정한 후 저장을 클릭합니다.

gcloud

저장소 설명을 업데이트하려면 다음 명령어를 실행합니다.

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

다음을 바꿉니다.

• REPOSITORY: 저장소의 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
• PROJECT: 프로젝트 ID입니다. Cloud de Confiance by S3NS이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION은 저장소의 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
• DESCRIPTION: 저장소에 대한 설명입니다.