Artifact Registry에 다른 형식 저장

Artifact Registry에 다른 형식 저장

미리보기

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

Artifact Registry 일반 형식 저장소를 설정하고 YAML 파일을 업로드하는 방법을 알아봅니다.

시작하기 전에

1. Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

4. Artifact Registry API 사용 설정

   API 사용 설정

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Google Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

7. Artifact Registry API 사용 설정

   API 사용 설정

Cloud Shell 실행

Google Cloud 콘솔에서 Cloud Shell을 활성화합니다.

Cloud Shell 활성화

Google Cloud 콘솔 하단에서 Cloud Shell 세션이 시작되고 명령줄 프롬프트가 표시됩니다. Cloud Shell은 Google Cloud CLI가 사전 설치된 셸 환경으로, 현재 프로젝트의 값이 이미 설정되어 있습니다. 세션이 초기화되는 데 몇 초 정도 걸릴 수 있습니다.

이 빠른 시작에서는 Cloud Shell을 사용하여 gcloud 명령어를 실행합니다.

일반 저장소 만들기

1. Generic repository라는 설명이 있는 us-central1 위치에 quickstart-generic-repo라는 이름의 일반 형식 저장소를 만들려면 다음 명령어를 실행합니다.

   gcloud artifacts repositories create quickstart-generic-repo \
       --repository-format=generic \
       --location=us-central1 \
       --description="Generic repository"
   

2. 저장소가 생성되었는지 확인하려면 다음 명령어를 실행합니다.

   gcloud artifacts repositories list
   

3. gcloud 명령어를 단순화하려면 다음 명령어를 실행하여 기본 저장소를 quickstart-generic-repo로 설정하고 기본 위치를 us-central1로 설정합니다.

   1. 기본 저장소를 quickstart-generic-repo로 설정하려면 다음 명령어를 실행합니다.

      gcloud config set artifacts/repository quickstart-generic-repo
      

   2. 기본 위치를 us-central1로 설정하려면 다음 명령어를 실행합니다.

      gcloud config set artifacts/location us-central1
      

   이 값을 설정하면 저장소나 위치가 필요한 gcloud 명령어에 값을 지정할 필요가 없습니다.

저장소에 아티팩트 업로드

1. 홈 디렉터리에서 저장소에 업로드할 파일을 만듭니다.

   echo "hello world" > hello.yaml
   

2. 파일을 저장소에 아티팩트로 업로드하려면 다음 명령어를 실행합니다.

   gcloud artifacts generic upload \
       --source=hello.yaml \
       --package=my-package \
       --version=1.0.0
   

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

   • hello.yaml은 업로드할 파일의 경로입니다.
   • my-package는 업로드할 패키지입니다.
   • 1.0.0은 아티팩트의 버전입니다. 저장소의 기존 버전을 덮어쓸 수 없습니다.

저장소에서 아티팩트 보기

아티팩트가 저장소에 추가되었는지 확인하려면 다음 명령어를 실행하여 모든 아티팩트를 나열할 수 있습니다.

gcloud artifacts files list

응답에는 PACKAGE:VERSION:FILE_NAME 형식의 파일 세부정보가 포함됩니다.

다음 예시에서 hello.yaml은 FILE_NAME입니다.

FILE: my-package:1.0.0:hello.yaml
CREATE_TIME: 2023-03-09T20:55:07
UPDATE_TIME: 2023-03-09T20:55:07
SIZE (MB): 0.000
OWNER: projects/my-project/locations/us-central1/repositories/quickstart-generic-repo/packages/my-package/versions/1.0.0

일반 아티팩트 다운로드

저장소에서 일반 아티팩트를 다운로드하려면 다음 명령어를 실행합니다.

gcloud artifacts generic download \
    --name=hello.yaml \
    --package=my-package \
    --version=1.0.0 \
    --destination=DESTINATION

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

• hello.yaml은 다운로드할 파일의 이름입니다.
• my-package는 다운로드할 패키지입니다.
• 1.0.0은 아티팩트의 버전입니다.

DESTINATION을 다운로드를 저장하려는 로컬 파일 시스템의 디렉터리로 바꿉니다. 대상 폴더가 이미 있어야 합니다. 그렇지 않으면 명령어가 실패합니다.

삭제

이 튜토리얼에서 사용된 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 리소스가 포함된 프로젝트를 삭제하거나 프로젝트는 유지하되 저장소를 삭제하세요.

프로젝트 삭제

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.

• 프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
• 커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.

여러 아키텍처, 튜토리얼, 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

Google Cloud 프로젝트를 삭제합니다.

gcloud projects delete PROJECT_ID

저장소 삭제

저장소를 삭제하기 전에, 보관할 패키지가 다른 위치에서 사용할 수 있는지 확인합니다.

1. quickstart-generic-repo 저장소를 삭제하려면 다음 명령어를 실행합니다.

   gcloud artifacts repositories delete quickstart-generic-repo
   

2. 활성 gcloud 구성에 지정한 기본 저장소 및 위치 설정을 삭제하려면 다음 명령어를 실행합니다.

   gcloud config unset artifacts/repository
   gcloud config unset artifacts/location
   

다음 단계

• 일반 아티팩트 자세히 알아보기