표준 저장소 만들기

이 페이지에서는 Artifact Registry 표준 저장소를 만드는 방법을 설명합니다.

표준 저장소는 비공개 아티팩트를 위한 저장소입니다. 이러한 저장소에 아티팩트를 직접 업로드하고 다운로드합니다.

일부 아티팩트 형식에서 사용할 수 있는 두 가지 다른 저장소 모드가 있습니다.

원격은 Docker Hub, Maven Central 또는 PyPI와 같은 외부 소스의 아티팩트를 저장합니다.
가상은 업스트림 표준 또는 원격 저장소에 있는 아티팩트를 다운로드, 설치, 배포하는 단일 액세스 포인트 역할을 합니다.

각 저장소에는 지원되는 단일 형식의 아티팩트가 포함될 수 있습니다.

시작하기 전에

Artifact Registry API 사용 설정 및 Google Cloud CLI 설치를 포함하여 Artifact Registry를 사용 설정합니다.
(선택사항) gcloud 명령어의 기본값을 구성합니다.
저장소 콘텐츠를 암호화하는 데 고객 관리 암호화 키(CMEK)가 필요한 경우 저장소의 Cloud KMS에 키를 만들고 사용 설정합니다.

필요한 역할

저장소를 만드는 데 필요한 권한을 얻으려면 관리자에게 Google Cloud 프로젝트의 Artifact Registry 저장소 관리자(roles/artifactregistry.repoAdmin) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

표준 저장소 만들기

저장소를 만들 때 저장소를 만든 후에는 변경할 수 없는 다음 설정을 구성해야 합니다.

아티팩트 형식
선택한 형식으로 여러 모드를 사용할 수 있는 경우 저장소 모드
저장소 위치
Google 관리 키 또는 고객 관리 암호화 키로 암호화. Artifact Registry는 기본적으로 Google 관리 암호화 키를 사용합니다.

Artifact Registry는 CMEK가 리소스를 암호화하도록 요구하거나 CMEK 보호에 사용할 수 있는 Cloud KMS 키를 제한하는 조직 정책 제약조건을 적용합니다.

Google Cloud 콘솔을 사용하여 저장소 만들기

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

저장소 페이지 열기
저장소 만들기를 클릭합니다.
저장소 이름을 지정합니다. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
저장소 형식을 선택합니다.
여러 저장소 모드를 사용할 수 있는 경우 표준을 선택합니다.
Maven만 해당: 버전 정책을 구성합니다.
1. 버전 정책을 선택합니다.
  - 없음 - 버전 정책이 없습니다. 출시 및 스냅샷 패키지를 모두 저장합니다.
  - 출시 - 출시 패키지만 저장합니다.
  - 스냅샷 - 스냅샷 패키지만 저장합니다.
2. 스냅샷 저장소가 저장소의 기존 버전을 덮어쓰는 고유하지 않은 스냅샷을 수락하도록 하려면 스냅샷 덮어쓰기 허용을 선택합니다.
  
  참고: Maven 3은 고유한 스냅샷만 지원합니다. 스냅샷 저장소를 사용하는 경우 고유한 스냅샷만 사용하는 것이 좋습니다.
위치 유형에서 저장소의 위치를 선택합니다.
1. 위치 유형(리전 또는 멀티 리전)을 선택합니다. 선택 사항이 반영되도록 위치 목록이 변경됩니다.
2. 리전 또는 멀티 리전 목록에서 위치를 선택합니다.
위치 유형 및 지원되는 위치에 대한 자세한 내용은 저장소 위치를 참조하세요.
저장소에 대한 설명을 추가합니다. 설명은 저장소의 용도와 저장소에 포함된 아티팩트의 종류를 식별하는 데 도움이 됩니다.

저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
라벨을 사용하여 저장소를 구성하려면 라벨 추가를 클릭하고 라벨의 키-값 쌍을 입력합니다. 저장소를 만든 후 라벨을 추가, 수정 또는 삭제할 수 있습니다.
암호화 섹션에서 저장소의 암호화 메커니즘을 선택합니다.
- Google 관리 키 - Google 관리 암호화 키로 저장소 콘텐츠를 암호화합니다.
- 고객 관리 키 - Cloud Key Management Service를 통해 제어하는 키로 저장소 콘텐츠를 암호화합니다. 키 설정 안내는 저장소의 CMEK 설정을 참조하세요.
- Docker 저장소의 경우 변경할 수 없는 이미지 태그 설정(미리보기)이 항상 동일한 이미지 다이제스트를 가리키는 이미지 태그를 사용하도록 저장소를 구성합니다. Artifact Registry 관리자 역할이 있는 사용자는 저장소가 생성된 후 이 설정을 변경할 수 있습니다.
  - 기본적으로 이 설정은 사용 중지되어 있습니다. 이미지 태그는 변경 가능합니다. 즉, 태그가 가리키는 이미지 다이제스트가 변경될 수 있습니다.
  - 이 설정을 사용 설정하면 이미지 태그를 변경할 수 없습니다. 태그는 항상 동일한 이미지 다이제스트를 가리켜야 합니다. 변경 가능한 이미지 태그와 변경할 수 없는 이미지 태그에 대한 자세한 내용은 컨테이너 이미지 버전을 참조하세요.
만들기를 클릭합니다.

Artifact Registry는 저장소를 만들고 저장소 목록에 추가합니다.

저장소를 만든 후:

저장소에 액세스 권한을 부여합니다.
저장소 인증을 위해 Docker, 패키지 관리자, 기타 타사 클라이언트를 구성합니다.
- 컨테이너 이미지: Docker, Helm
- 언어 패키지: 자바, Node.js, Python, Go
- OS 패키지: Debian, RPM
- 기타: Kubeflow 파이프라인 템플릿

Google Cloud CLI를 사용하여 저장소 만들기

명령어를 실행하여 새 저장소를 만듭니다.

Apt

gcloud artifacts repositories create REPOSITORY \
    --repository-format=apt \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Docker

gcloud artifacts repositories create REPOSITORY \
    --repository-format=docker \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --immutable-tags \
    --async

REPOSITORY: 저장소 이름. 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--immutable-tags는 항상 동일한 이미지 다이제스트를 가리키는 태그를 사용하도록 저장소를 구성하는 선택적 플래그입니다.

기본적으로 --immutable-tags 플래그가 전달되지 않으면 태그를 다른 이미지 다이제스트로 이동할 수 있습니다. 변경할 수 없는 이미지 태그와 변경 가능한 이미지 태그에 대한 자세한 내용은 컨테이너 이미지 버전을 참조하세요.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

KubeFlow Pipelines

gcloud artifacts repositories create REPOSITORY \
    --repository-format=kfp \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Maven

기본적으로 Maven 저장소는 패키지의 스냅샷 및 출시 버전을 모두 저장합니다. 버전 정책을 지정하여 스냅샷 또는 출시 저장소를 만들 수 있습니다.

스냅샷과 출시 버전을 저장하는 저장소를 만들려면 다음 명령어를 실행합니다.

gcloud artifacts repositories create REPOSITORY \
    --repository-format=maven \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

스냅샷과 출시 버전을 서로 다른 저장소에 저장하려면 명령어에 버전 정책을 지정합니다.

gcloud artifacts repositories create REPOSITORY \
  --repository-format=maven \
  [--location=LOCATION] \
  [--description="DESCRIPTION"] \
  [--kms-key=KMS-KEY] \
  [--version-policy=VERSION-POLICY] \
  [--allow-snapshot-overwrites] \
  [--async] \

다음 플래그는 Maven 저장소에만 적용됩니다.

--version-policy=VERSION-POLICY: 저장소에 저장할 패키지 유형을 지정합니다. VERSION-POLICY를 다음과 같이 설정할 수 있습니다.

None - 버전 정책이 없습니다. 출시 및 스냅샷 패키지를 모두 저장합니다. 명령어에 --version-policy 플래그를 포함하지 않으면 기본 설정입니다.
Release - 출시 패키지만 저장합니다.
Snapshot - 스냅샷 패키지만 저장합니다.

--allow-snapshot-overwrites: 스냅샷 저장소에만 해당됩니다. 이 플래그를 지정하면 저장소의 기존 버전을 덮어쓰는 고유하지 않은 스냅샷을 게시할 수 있습니다.

npm

gcloud artifacts repositories create REPOSITORY \
    --repository-format=npm \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Python

gcloud artifacts repositories create REPOSITORY \
    --repository-format=python \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Yum

gcloud artifacts repositories create REPOSITORY \
    --repository-format=yum \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Go

gcloud artifacts repositories create REPOSITORY \
    --repository-format=go \
    --location=LOCATION \
    --description="DESCRIPTION" \
    --kms-key=KMS-KEY \
    --async

REPOSITORY: 저장소 이름 프로젝트의 저장소 위치마다 저장소 이름이 고유해야 합니다.
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본값을 설정하는 경우 이 플래그를 생략할 수 있습니다. 지원되는 위치 목록을 보려면 다음 명령어를 실행합니다.
```
gcloud artifacts locations list
```
DESCRIPTION은 저장소에 대한 설명입니다. 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
고객 관리 암호화 키를 사용하여 저장소 콘텐츠를 암호화하는 경우 KMS-KEY는 Cloud KMS 암호화 키의 전체 경로입니다. 경로 형식은 다음과 같습니다.
```
projects/KMS-PROJECT/locations/KMS-LOCATION/keyRings/KEY-RING/cryptoKeys/KEY
```
각 항목의 의미는 다음과 같습니다.
- KMS-PROJECT은 키가 저장된 프로젝트입니다.
- KMS-LOCATION은 키의 위치입니다.
- KEY-RING은 키링의 이름입니다.
- KEY는 키의 이름입니다.
--async는 진행 중인 작업이 완료되기를 기다리지 않고 즉시 반환합니다.

Artifact Registry가 저장소를 만듭니다. 다음 명령어를 실행하여 저장소에 대한 설명을 봅니다.

gcloud artifacts repositories describe REPOSITORY \
    --location=LOCATION

저장소를 만든 후:

저장소에 액세스 권한을 부여합니다.
저장소 인증을 위해 Docker, 패키지 관리자, 기타 타사 클라이언트를 구성합니다.
- 컨테이너 이미지: Docker, Helm
- 언어 패키지: 자바, Node.js, Python, Go
- OS 패키지: Debian, RPM
- 기타: Kubeflow 파이프라인 템플릿

Terraform을 사용하여 저장소 만들기

google_artifact_registry_repository 리소스를 사용하여 저장소를 만듭니다. terraform-provider-google 버전 5.0.0 이상이 필요합니다.

Google Cloud에서 Terraform을 처음 사용하는 경우 HashiCorp 웹사이트의 시작하기 - Google Cloud 페이지를 참조하세요.

다음 예시에서는 Terraform 리소스 이름이 my-repo인 제공업체와 저장소를 정의합니다.

Apt

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "apt"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

Docker

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "docker"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

KubeFlow Pipelines

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "kfp"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

Maven

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

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "maven"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

스냅샷과 출시 버전을 서로 다른 저장소에 저장하려면 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 = "us-central1"
repository_id = "my-repo"
description = "Maven repository"
format = "MAVEN"
maven_config {
  version_policy = "RELEASE"
}
}

npm

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "npm"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

Python

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "python"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

Artifact Registry가 저장소를 만듭니다. 다음 명령어를 실행하여 저장소에 대한 설명을 봅니다.

gcloud artifacts repositories describe REPOSITORY \
  --location=LOCATION

Yum

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "yum"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

Go

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

resource "google_artifact_registry_repository" "my-repo" {
  location = "LOCATION"
  repository_id = "REPOSITORY"
  description = "DESCRIPTION"
  format = "go"
  kms_key_name = "KEY"
}

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

PROJECT-ID: Google Cloud 프로젝트 ID
LOCATION: 저장소 위치
REPOSITORY: 저장소 이름
DESCRIPTION: 저장소 설명(선택사항). 저장소 설명은 암호화되지 않으므로 민감한 정보는 포함하지 마세요.
KEY: 암호화에 고객 관리 암호화 키(CMEK)를 사용하는 경우 Cloud Key Management Service 키의 이름. 기본 설정인 Google 관리 암호화 키를 사용하려면 이 인수를 생략합니다.

저장소를 만든 후:

저장소에 액세스 권한을 부여합니다.
저장소 인증을 위해 Docker, 패키지 관리자, 기타 타사 클라이언트를 구성합니다.
- 컨테이너 이미지: Docker, Helm
- 언어 패키지: 자바, Node.js, Python, Go
- OS 패키지: Debian, RPM
- 기타: Kubeflow 파이프라인 템플릿

저장소 설명 수정

Google Cloud 콘솔 또는 gcloud CLI에서 저장소 설명을 변경할 수 있습니다.

콘솔

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

저장소 페이지 열기
저장소 목록에서 저장소를 선택하고 저장소 수정을 클릭합니다.
저장소 설명을 수정한 후 저장을 클릭합니다.

gcloud

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

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

다음 값을 바꿉니다.

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

표준 저장소 만들기

시작하기 전에

필요한 역할

표준 저장소 만들기

Google Cloud 콘솔을 사용하여 저장소 만들기

Google Cloud CLI를 사용하여 저장소 만들기

Apt

Docker

KubeFlow Pipelines

Maven

npm

Python

Yum

Go

Terraform을 사용하여 저장소 만들기

Apt

Docker

KubeFlow Pipelines

Maven

npm

Python

Yum

Go

저장소 설명 수정

콘솔

gcloud

다음 단계