원격 저장소 만들기

Docker

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=docker \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-docker-repo=UPSTREAM

업스트림 저장소에 인증하기 위한 선택적 플래그:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

다음을 바꿉니다.

• REMOTE-REPOSITORY-NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE-REPOSITORY-DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명으로 바꿉니다.
• (원하는 경우) USERNAME을 인증 사용 시 업스트림 저장소에 인증하기 위한 사용자 이름으로 바꿉니다.
• (원하는 경우) SECRET_VERSION을 인증 사용 시 업스트림 저장소 비밀번호가 포함된 보안 비밀 버전으로 바꿉니다.

• UPSTREAM을 사전 설정된 업스트림 이름, Artifact Registry 저장소 경로 또는 업스트림 저장소의 사용자 정의 URL로 바꿉니다.
  
  Artifact Registry 업스트림 저장소의 경우 저장소 경로 형식을 다음과 같이 지정합니다. projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY
  
  사용 가능한 사전 설정 업스트림 및 지원되는 사용자 정의 업스트림에 대한 자세한 내용은 지원되는 형식을 참조하세요.

• --disable-vulnerability-scanning: 자동 취약점 스캔을 사용 중지하도록 저장소를 구성하는 선택적 플래그입니다.

• --allow-vulnerability-scanning: 자동 취약점 스캔을 허용하도록 저장소를 구성하는 선택적 플래그입니다. 자세한 내용은 자동 스캔 사용 설정 또는 중지를 참고하세요.

예를 들어 다음 명령어는 Google Cloud 프로젝트 my-project의 us-east1 리전에 my-repo라는 원격 저장소를 만들고 사용자 이름 my-username과 projects/my-project/secrets/my-secret/versions/1 보안 비밀 버전을 사용하여 업스트림 저장소에 인증할 수 있습니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=docker \
    --location=us-east1 \
    --description="Remote Docker repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Docker Hub" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-docker-repo=DOCKER-HUB

Docker Hub 업스트림 저장소 인증에 대한 자세한 내용은 Docker Hub에 대한 원격 저장소 인증 구성을 참조하세요.

Maven

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=maven \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-mvn-repo=UPSTREAM

업스트림 저장소에 인증하기 위한 선택적 플래그:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

다음을 바꿉니다.

• REMOTE-REPOSITORY-NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE-REPOSITORY-DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명으로 바꿉니다.
• (원하는 경우) USERNAME을 인증 사용 시 업스트림 저장소에 인증하기 위한 사용자 이름으로 바꿉니다.
• (원하는 경우) SECRET_VERSION을 인증 사용 시 업스트림 저장소 비밀번호가 포함된 보안 비밀 버전으로 바꿉니다.

• UPSTREAM을 사전 설정된 업스트림 이름, Artifact Registry 저장소 경로 또는 업스트림 저장소의 사용자 정의 URL로 바꿉니다.
  
  Artifact Registry 업스트림 저장소의 경우 저장소 경로 형식을 다음과 같이 지정합니다. projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY
  
  사용 가능한 사전 설정 업스트림 및 지원되는 사용자 정의 업스트림에 대한 자세한 내용은 지원되는 형식을 참조하세요.

• --disable-vulnerability-scanning: 자동 취약점 스캔을 사용 중지하도록 저장소를 구성하는 선택적 플래그입니다.

• --allow-vulnerability-scanning: 자동 취약점 스캔을 허용하도록 저장소를 구성하는 선택적 플래그입니다. 자세한 내용은 자동 스캔 사용 설정 또는 중지를 참고하세요.

예를 들어 다음 명령어는 Google Cloud 프로젝트 my-project의 us-east1 리전에 my-repo라는 원격 저장소를 만들고 사용자 이름 my-username과 projects/my-project/secrets/my-secret/versions/1 보안 비밀 버전을 사용하여 업스트림 저장소에 인증할 수 있습니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=maven \
    --location=us-east1 \
    --description="Remote Maven repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Maven Central" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-mvn-repo=MAVEN-CENTRAL

npm

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=npm \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-npm-repo=UPSTREAM

업스트림 저장소에 인증하기 위한 선택적 플래그:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

다음을 바꿉니다.

• REMOTE-REPOSITORY-NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE-REPOSITORY-DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명으로 바꿉니다.
• (원하는 경우) USERNAME을 인증 사용 시 업스트림 저장소에 인증하기 위한 사용자 이름으로 바꿉니다.
• (원하는 경우) SECRET_VERSION을 인증 사용 시 업스트림 저장소 비밀번호가 포함된 보안 비밀 버전으로 바꿉니다.

• UPSTREAM을 사전 설정된 업스트림 이름, Artifact Registry 저장소 경로 또는 업스트림 저장소의 사용자 정의 URL로 바꿉니다.
  
  Artifact Registry 업스트림 저장소의 경우 저장소 경로 형식을 다음과 같이 지정합니다. projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY
  
  사용 가능한 사전 설정 업스트림 및 지원되는 사용자 정의 업스트림에 대한 자세한 내용은 지원되는 형식을 참조하세요.

• --disable-vulnerability-scanning: 자동 취약점 스캔을 사용 중지하도록 저장소를 구성하는 선택적 플래그입니다.

• --allow-vulnerability-scanning: 자동 취약점 스캔을 허용하도록 저장소를 구성하는 선택적 플래그입니다. 자세한 내용은 자동 스캔 사용 설정 또는 중지를 참고하세요.

예를 들어 다음 명령어는 Google Cloud 프로젝트 my-project의 us-east1 리전에 my-repo라는 원격 저장소를 만들고 사용자 이름 my-username과 projects/my-project/secrets/my-secret/versions/1 보안 비밀 버전을 사용하여 업스트림 저장소에 인증할 수 있습니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=npm \
    --location=us-east1 \
    --description="Remote npm repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Public npm registry" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-npm-repo=NPMJS

Python

gcloud artifacts repositories create REMOTE-REPOSITORY-NAME \
    --project=PROJECT_ID \
    --repository-format=python \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE-REPOSITORY-DESCRIPTION" \
    --disable-vulnerability-scanning \
    --remote-python-repo=UPSTREAM

업스트림 저장소에 인증하기 위한 선택적 플래그:

• --remote-username=USERNAME
• --remote-password-secret-version=SECRET_VERSION

다음을 바꿉니다.

• REMOTE-REPOSITORY-NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE-REPOSITORY-DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명으로 바꿉니다.
• (원하는 경우) USERNAME을 인증 사용 시 업스트림 저장소에 인증하기 위한 사용자 이름으로 바꿉니다.
• (원하는 경우) SECRET_VERSION을 인증 사용 시 업스트림 저장소 비밀번호가 포함된 보안 비밀 버전으로 바꿉니다.

• UPSTREAM을 사전 설정된 업스트림 이름, Artifact Registry 저장소 경로 또는 업스트림 저장소의 사용자 정의 URL로 바꿉니다.
  
  Artifact Registry 업스트림 저장소의 경우 저장소 경로 형식을 다음과 같이 지정합니다. projects/UPSTREAM_PROJECT_ID/locations/REGION/repositories/UPSTREAM_REPOSITORY
  
  사용 가능한 사전 설정 업스트림 및 지원되는 사용자 정의 업스트림에 대한 자세한 내용은 지원되는 형식을 참조하세요.

• --disable-vulnerability-scanning: 자동 취약점 스캔을 사용 중지하도록 저장소를 구성하는 선택적 플래그입니다.

• --allow-vulnerability-scanning: 자동 취약점 스캔을 허용하도록 저장소를 구성하는 선택적 플래그입니다. 자세한 내용은 자동 스캔 사용 설정 또는 중지를 참고하세요.

예를 들어 다음 명령어는 Google Cloud 프로젝트 my-project의 us-east1 리전에 my-repo라는 원격 저장소를 만들고 사용자 이름 my-username과 projects/my-project/secrets/my-secret/versions/1 보안 비밀 버전을 사용하여 업스트림 저장소에 인증할 수 있습니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=python \
    --location=us-east1 \
    --description="Remote Python repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="PyPI" \
    --remote-username=my-username \
    --remote-password-secret-version=projects/my-project/secrets/my-secret/versions/1 \
    --remote-python-repo=PYPI

Apt(미리보기)

gcloud artifacts repositories create REMOTE_REPOSITORY_NAME \
    --project=PROJECT_ID \
    --repository-format=apt \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE_REPOSITORY_DESCRIPTION" \
    --remote-apt-repo=APT_REPOSITORY_BASE \
    --remote-apt-repo-path="APT_REPOSITORY_PATH"

다음을 바꿉니다.

• REMOTE_REPOSITORY_NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE_REPOSITORY_DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명(선택사항)으로 바꿉니다.
• APT_REPOSITORY_BASE를 Apt 원격 저장소의 OS 패키지 지원 업스트림에 나열된 지원되는 저장소 기본 이름 중 하나로 바꿉니다.
• APT_REPOSITORY_PATH를 저장소 기본 이후에 원격 저장소에 캐시할 업스트림 저장소의 나머지 URL로 바꿉니다.

예를 들어 다음 명령어는 Google Cloud 프로젝트 my-project의 us-east1 리전에 있는 Debian 버스터 저장소를 캐시하기 위해 my-repo라는 원격 저장소를 만듭니다. 업스트림 저장소의 전체 URL은 http://deb.debian.org/debian/dists/buster입니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=apt \
    --location=us-east1 \
    --description="Apt remote repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="Debian buster distribution" \
    --remote-apt-repo=DEBIAN \
    --remote-apt-repo-path="debian/dists/buster"

Yum(미리보기)

gcloud artifacts repositories create REMOTE_REPOSITORY_NAME \
    --project=PROJECT_ID \
    --repository-format=yum \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --mode=remote-repository \
    --remote-repo-config-desc="REMOTE_REPOSITORY_DESCRIPTION" \
    --remote-yum-repo=YUM_REPOSITORY_BASE \
    --remote-yum-repo-path="YUM_REPOSITORY_PATH"

다음을 바꿉니다.

• REMOTE_REPOSITORY_NAME을 저장소 이름으로 바꿉니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
• PROJECT_ID를 프로젝트 ID로 바꿉니다. 이 플래그를 생략하면 현재 프로젝트 또는 기본 프로젝트가 사용됩니다.
• LOCATION을 저장소의 리전 또는 멀티 리전 위치로 바꿉니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 저장소 위치 목록을 보려면 gcloud artifacts locations list 명령어를 실행합니다.
• DESCRIPTION을 저장소에 대한 설명(선택사항)으로 바꿉니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• REMOTE_REPOSITORY_DESCRIPTION을 이 원격 저장소의 외부 저장소 구성에 대한 설명(선택사항)으로 바꿉니다.
• YUM_REPOSITORY_BASE를 Yum 원격 저장소의 OS 패키지 지원 업스트림에 나열된 지원되는 저장소 기본 이름 중 하나로 바꿉니다.
• YUM_REPOSITORY_PATH를 저장소 기본 이후에 원격 저장소에 캐시할 업스트림 저장소의 나머지 URL로 바꿉니다.

예를 들어 다음 명령어는 업스트림 저장소 9-stream/BaseOs/x86_64/os의 Google Cloud 프로젝트 my-project에 있는 us-east1 리전에 my-repo라는 Yum 패키지의 원격 저장소를 만듭니다. 저장소의 전체 URL은 https://mirror.stream.centos.org/9-stream/BaseOS/x86_64/os입니다.

gcloud artifacts repositories create my-repo \
    --project=my-project \
    --repository-format=yum \
    --location=us-east1 \
    --description="Yum remote repository" \
    --mode=remote-repository \
    --remote-repo-config-desc="CentOS 8 x86" \
    --remote-yum-repo=CENTOS_STREAM \
    --remote-yum-repo-path="9-stream/BaseOs/x86_64/os"

Docker

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

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "docker"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    docker_repository {
      public_repository = "DOCKER_HUB"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• DRY_RUN_STATUS: 삭제 정책이 아티팩트를 삭제할지 여부를 결정하거나 저장소에서 삭제 정책을 설정하는 경우 삭제될 아티팩트만 로깅합니다. 저장소에 삭제 정책을 추가하지 않으려면 생략합니다. * true: 테스트 실행 모드로 실행되도록 정책을 설정합니다. 테스트 실행 모드에서는 아티팩트가 삭제되지 않습니다. * false: 삭제 정책을 적용합니다. 아티팩트는 정책에 따라 삭제되거나 유지됩니다. 삭제 정책에 대한 자세한 내용은 삭제 정책 구성을 참조하세요.
  • POLICY_NAME: 삭제 정책의 이름
  • TAG_STATE: 정책을 적용할 태그 상태입니다. 값은 tagged, untagged, any입니다. any는 태그가 지정된 아티팩트와 태그가 지정되지 않은 아티팩트 모두에 적용됩니다. 저장소에 변경할 수 없는 태그가 사용 설정된 경우 태그가 지정된 아티팩트를 삭제할 수 없습니다.
  • TAG_PREFIX, TAG_PREFIX_N: 정책을 적용할 태그 프리픽스
  • PKG_PREFIX, PKG_PREFIX_N: 정책을 적용할 패키지 프리픽스
  • TIME_SINCE_UPLOAD: 아티팩트 버전이 저장소에 업로드된 이후의 시간(기간). 각각 s, m, h, d를 추가하여 초, 분, 시간, 일로 기간을 지정할 수 있습니다.
  • KEEP_COUNT: 저장소에 보관할 아티팩트의 패키지당 버전 수

Maven

버전 정책을 지정하지 않으면 Artifact Registry가 기본적으로 패키지의 스냅샷 및 출시 버전을 모두 저장하는 Maven 저장소를 만듭니다.

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

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "maven"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    maven_repository {
      public_repository = "MAVEN_CENTRAL"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• DRY_RUN_STATUS: 삭제 정책이 아티팩트를 삭제할지 여부를 결정하거나 저장소에서 삭제 정책을 설정하는 경우 삭제될 아티팩트만 로깅합니다. 저장소에 삭제 정책을 추가하지 않으려면 생략합니다. * true: 테스트 실행 모드로 실행되도록 정책을 설정합니다. 테스트 실행 모드에서는 아티팩트가 삭제되지 않습니다. * false: 삭제 정책을 적용합니다. 아티팩트는 정책에 따라 삭제되거나 유지됩니다. 삭제 정책에 대한 자세한 내용은 삭제 정책 구성을 참조하세요.
  • POLICY_NAME: 삭제 정책의 이름
  • TAG_STATE: 정책을 적용할 태그 상태입니다. 값은 tagged, untagged, any입니다. any는 태그가 지정된 아티팩트와 태그가 지정되지 않은 아티팩트 모두에 적용됩니다. 저장소에 변경할 수 없는 태그가 사용 설정된 경우 태그가 지정된 아티팩트를 삭제할 수 없습니다.
  • TAG_PREFIX, TAG_PREFIX_N: 정책을 적용할 태그 프리픽스
  • PKG_PREFIX, PKG_PREFIX_N: 정책을 적용할 패키지 프리픽스
  • TIME_SINCE_UPLOAD: 아티팩트 버전이 저장소에 업로드된 이후의 시간(기간). 각각 s, m, h, d를 추가하여 초, 분, 시간, 일로 기간을 지정할 수 있습니다.
  • KEEP_COUNT: 저장소에 보관할 아티팩트의 패키지당 버전 수

스냅샷과 출시 버전을 서로 다른 저장소에 저장하려면 maven_config 블록을 사용하여 저장소에 대해 버전 정책을 지정합니다. 이 블록은 다음 설정을 지원합니다.

• version_policy는 다음 값 중 하나로 버전 정책을 설정합니다.
  • VERSION_POLICY_UNSPECIFIED: 스냅샷 및 출시 패키지를 저장합니다. 이는 기본 설정입니다.
  • 출시: 출시 패키지만 저장합니다.
  • 스냅샷: 스냅샷 패키지만 저장합니다.
• allow_snapshot_overwrites는 SNAPSHOT 버전 정책으로 저장소를 구성하여 저장소의 기존 버전을 덮어쓰는 고유하지 않은 스냅샷을 허용합니다.

다음 예시에서는 출시 버전 정책으로 Maven 저장소를 정의합니다.

provider "google" {
project = "my-project"
}

resource "google_artifact_registry_repository" "my-repo" {
provider = google-beta

location = "LOCATION"
repository_id = "my-repo"
description = "Maven repository"
format = "MAVEN"
mode = "REMOTE_REPOSITORY"
maven_config {
  version_policy = "RELEASE"
}
}

npm

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

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "npm"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    npm_repository {
      public_repository = "NPMJS"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• DRY_RUN_STATUS: 삭제 정책이 아티팩트를 삭제할지 여부를 결정하거나 저장소에서 삭제 정책을 설정하는 경우 삭제될 아티팩트만 로깅합니다. 저장소에 삭제 정책을 추가하지 않으려면 생략합니다. * true: 테스트 실행 모드로 실행되도록 정책을 설정합니다. 테스트 실행 모드에서는 아티팩트가 삭제되지 않습니다. * false: 삭제 정책을 적용합니다. 아티팩트는 정책에 따라 삭제되거나 유지됩니다. 삭제 정책에 대한 자세한 내용은 삭제 정책 구성을 참조하세요.
  • POLICY_NAME: 삭제 정책의 이름
  • TAG_STATE: 정책을 적용할 태그 상태입니다. 값은 tagged, untagged, any입니다. any는 태그가 지정된 아티팩트와 태그가 지정되지 않은 아티팩트 모두에 적용됩니다. 저장소에 변경할 수 없는 태그가 사용 설정된 경우 태그가 지정된 아티팩트를 삭제할 수 없습니다.
  • TAG_PREFIX, TAG_PREFIX_N: 정책을 적용할 태그 프리픽스
  • PKG_PREFIX, PKG_PREFIX_N: 정책을 적용할 패키지 프리픽스
  • TIME_SINCE_UPLOAD: 아티팩트 버전이 저장소에 업로드된 이후의 시간(기간). 각각 s, m, h, d를 추가하여 초, 분, 시간, 일로 기간을 지정할 수 있습니다.
  • KEEP_COUNT: 저장소에 보관할 아티팩트의 패키지당 버전 수

Python

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

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "python"
  kms_key_name = "KEY"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    python_repository {
      public_repository = "PYPI"
    }
  }
  cleanup_policy_dry_run = DRY_RUN_STATUS
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "DELETE"
    condition {
      tag_state    = "TAG_STATE"
      tag_prefixes = ["TAG_PREFIX", "TAG_PREFIX_N"]
      older_than   = "TIME_SINCE_UPLOAD"
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    condition {
      tag_state             = "TAG_STATE"
      tag_prefixes          = ["TAG_PREFIX", "TAG_PREFIX_N"]
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
    }
  }
  cleanup_policies {
    id     = "POLICY_NAME"
    action = "KEEP"
    most_recent_versions {
      package_name_prefixes = ["PKG_PREFIX", "PKG_PREFIX_N"]
      keep_count            = KEEP_COUNT
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• DRY_RUN_STATUS: 삭제 정책이 아티팩트를 삭제할지 여부를 결정하거나 저장소에서 삭제 정책을 설정하는 경우 삭제될 아티팩트만 로깅합니다. 저장소에 삭제 정책을 추가하지 않으려면 생략합니다. * true: 테스트 실행 모드로 실행되도록 정책을 설정합니다. 테스트 실행 모드에서는 아티팩트가 삭제되지 않습니다. * false: 삭제 정책을 적용합니다. 아티팩트는 정책에 따라 삭제되거나 유지됩니다. 삭제 정책에 대한 자세한 내용은 삭제 정책 구성을 참조하세요.
  • POLICY_NAME: 삭제 정책의 이름
  • TAG_STATE: 정책을 적용할 태그 상태입니다. 값은 tagged, untagged, any입니다. any는 태그가 지정된 아티팩트와 태그가 지정되지 않은 아티팩트 모두에 적용됩니다. 저장소에 변경할 수 없는 태그가 사용 설정된 경우 태그가 지정된 아티팩트를 삭제할 수 없습니다.
  • TAG_PREFIX, TAG_PREFIX_N: 정책을 적용할 태그 프리픽스
  • PKG_PREFIX, PKG_PREFIX_N: 정책을 적용할 패키지 프리픽스
  • TIME_SINCE_UPLOAD: 아티팩트 버전이 저장소에 업로드된 이후의 시간(기간). 각각 s, m, h, d를 추가하여 초, 분, 시간, 일로 기간을 지정할 수 있습니다.
  • KEEP_COUNT: 저장소에 보관할 아티팩트의 패키지당 버전 수

Apt(미리보기)

  provider "google" {
  project = "PROJECT_ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "APT"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    apt_repository {
      public_repository {
        repository_base = "REPOSITORY_BASE"
        repository_path = "REPOSITORY_PATH"
      }
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• REPOSITORY_BASE는 Apt의 사전 설정된 공개 저장소 기본입니다. 가능한 값은 DEBIAN, UBUNTU입니다.
• REPOSITORY_PATH는 기본의 특정 저장소입니다. 예를 들면 debian/dists/buster입니다.

Yum(미리보기)

  provider "google" {
  project = "PROJECT_ID"
}

resource "google_artifact_registry_repository" "my-repo" {
  location      = "LOCATION"
  repository_id = "REPOSITORY_ID"
  description   = "DESCRIPTION"
  format        = "YUM"
  mode          = "REMOTE_REPOSITORY"
  remote_repository_config {
    description = "CONFIG_DESCRIPTION"
    yum_repository {
      public_repository {
        repository_base = "REPOSITORY_BASE"
        repository_path = "REPOSITORY_PATH"
      }
    }
  }
}

각 항목의 의미는 다음과 같습니다.

• PROJECT-ID: Google Cloud 프로젝트 ID
• LOCATION: 저장소 위치
• REPOSITORY_ID: 저장소 ID
• DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
• CONFIG_DESCRIPTION: 원격 소스에 대한 설명(선택사항)
• REPOSITORY_BASE는 Yum의 사전 설정된 공개 저장소 기본입니다. 가능한 값은 CENTOS, CENTOS_DEBUG, CENTOS_VAULT, CENTOS_STREAM, ROCKY, EPEL입니다.
• REPOSITORY_PATH는 기본의 특정 저장소입니다. 예를 들면 "centos/8-stream/BaseOS/x86_64/os입니다.

콘솔

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

   저장소 페이지 열기

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

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

gcloud

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

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

다음을 바꿉니다.

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