Artifact Registry에 Conda 저장소를 만들면 새 저장소에 Conda 패키지를 설치할 수 있습니다. 이 페이지에서는 Conda 패키지를 설치, 확인, 삭제하는 방법을 설명합니다.
시작하기 전에
Google Cloud CLI를 설치하고 초기화합니다.
Conda 저장소용 명령어를 실행하려면 Google Cloud CLI 버전 354.0.0 이상이 필요합니다. 명령어를 사용하여 버전을 확인할 수 있습니다.
gcloud versionGoogle Cloud 환경 내에서 Conda CLI를 사용하려면 다음 Conda 패키지 관리자 중 하나를 설치하세요.
Artifact Registry에 Conda 저장소가 없으면 Conda 패키지 저장소를 만듭니다.
(선택사항) gcloud 명령어의 기본값을 설정합니다.
Artifact Registry는 표준 및 원격 Conda 저장소를 지원합니다. 원격 저장소에 다음 주소를 사용할 수 있습니다.
https://repo.anaconda.com/pkgs/mainhttps://repo.anaconda.com/pkgs/rhttps://repo.anaconda.com/pkgs/msys2https://conda.anaconda.org/conda-forgehttps://conda.anaconda.org/bioconda
필요한 역할
Conda 패키지를 관리하는 데 필요한 권한을 얻으려면 관리자에게 저장소에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.
-
패키지 또는 패키지 파일 보기: Artifact Registry 리더 (
roles/artifactregistry.reader) -
패키지 다운로드 또는 설치: Artifact Registry 리더 (
roles/artifactregistry.reader) -
저장소에 패키지 추가: Artifact Registry 작성자 (
roles/artifactregistry.writer) -
패키지 삭제: Artifact Registry 저장소 관리자 (
roles/artifactregistry.repoAdmin)
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.
Conda 패키지 관리
Artifact Registry 저장소에 Conda 패키지를 추가한 후 Conda 환경에 패키지를 설치하고 Google Cloud를 사용하여 패키지에 관한 세부정보를 볼 수 있습니다.
Artifact Registry 저장소에 패키지 추가
Artifact Registry 저장소에 Conda 패키지를 추가하려면 다음 명령어를 실행합니다.
gcloud artifacts files upload \
--source=PACKAGE_NAME \
--repository=REPO_NAME\
--project=PROJECT \
--location=LOCATION
각 항목의 의미는 다음과 같습니다.
- REPO_NAME는 저장소 ID입니다.
- PROJECT는 저장소가 포함된 프로젝트의 ID입니다.
- LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다.
한 번에 여러 패키지를 추가하려면 다음 단계를 따르세요.
gcloud artifacts files upload \
--source-directory=DIRECTORY \
--repository=REPO_NAME\
--project=PROJECT \
--location=LOCATION
각 항목의 의미는 다음과 같습니다.
- DIRECTORY은 Conda 패키지가 포함된 로컬 폴더의 주소입니다.
패키지 설치
저장소 모드: 표준, 원격
Conda 환경에 패키지의 최신 안정화 버전을 설치하려면 다음 명령어를 실행하세요.
Conda
conda install -n ENVIRONMENT_NAME PACKAGE_NAME
Miniforge
conda install -n ENVIRONMENT_NAME PACKAGE_NAME
Mamba
mamba install -n ENVIRONMENT_NAME PACKAGE_NAME
Micromamba
micromamba install -n ENVIRONMENT_NAME PACKAGE_NAME
각 항목의 의미는 다음과 같습니다.
- ENVIRONMENT_NAME은 Conda 환경의 이름입니다.
이미 환경이 활성화되어 있고 환경에 직접 패키지를 설치하는 경우
-n ENVIRONMENT_NAME을 생략할 수 있습니다. PACKAGE_NAME은 Conda 패키지의 이름입니다.
Conda 환경에 특정 버전의 패키지를 설치하려면 패키지 이름 뒤에 VERSION를 포함합니다.
표준 저장소의 경우 저장소에서 직접 패키지를 다운로드합니다.
원격 저장소의 경우 패키지와 해당 종속 항목의 캐시된 복사본을 다운로드합니다. 캐시된 복사본이 없으면 원격 저장소가 업스트림 소스에서 패키지를 다운로드하고 캐시한 후에 개발자에게 제공합니다. 저장소의 패키지 목록을 확인하여 원격 저장소가 업스트림 소스에서 패키지를 검색했는지 확인할 수 있습니다.
패키지 및 버전 보기
저장소 모드: 표준, 원격
콘솔 또는 Google Cloud gcloud를 사용하여 패키지 및 패키지 버전을 보려면 다음 안내를 따르세요.
콘솔
콘솔에서 저장소 페이지를 엽니다. Google Cloud
저장소 목록에서 적절한 저장소를 클릭합니다.
패키지 페이지에 저장소의 패키지가 나열됩니다.
패키지의 버전을 보려면 패키지를 클릭합니다.
gcloud
저장소의 패키지를 나열하려면 다음 명령어를 실행합니다.
gcloud artifacts packages list [--repository=REPOSITORY] [--location=LOCATION]
다음을 바꿉니다.
REPOSITORY: 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.-
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
패키지 버전을 보려면 다음 명령어를 실행합니다.
gcloud artifacts versions list --package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION]
다음을 바꿉니다.
PACKAGE는 패키지의 ID 또는 패키지의 정규화된 식별자입니다.REPOSITORY: 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.-
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
원격 저장소의 경우 반환된 목록에 캐시된 패키지만 표시됩니다.
파일 나열
저장소 모드: 표준, 원격
원격 저장소의 경우 반환된 목록에는 캐시된 Conda 패키지와 색인 파일만 표시됩니다.
저장소의 파일, 지정된 패키지의 모든 버전 파일, 패키지의 특정 버전 파일을 나열할 수 있습니다.
다음 모든 명령어에 대해 --limit 플래그를 명령어에 추가하여 반환할 최대 파일 수를 설정할 수 있습니다.
기본값이 구성된 경우 기본 프로젝트, 저장소, 위치의 모든 파일을 나열하려면 다음 명령어를 실행합니다.
gcloud artifacts files list
지정된 프로젝트, 저장소, 위치의 파일을 나열하려면 다음을 실행합니다.
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION
특정 패키지의 모든 버전에 대한 파일을 나열하려면 다음을 실행합니다.
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE
특정 패키지 버전의 파일을 나열하려면 다음을 실행합니다.
gcloud artifacts files list \
--project=PROJECT \
--repository=REPOSITORY \
--location=LOCATION \
--package=PACKAGE \
--version=VERSION
다음 값을 바꿉니다.
LOCATION: 저장소의 리전 또는 멀티 리전 위치입니다.PROJECT: Google Cloud 프로젝트 ID 프로젝트 ID에 콜론 (:)이 포함되어 있으면 도메인 범위 프로젝트를 참고하세요.REPOSITORY: 이미지가 저장된 저장소의 이름입니다.PACKAGE: 패키지의 이름입니다.VERSION: 패키지의 버전입니다.
예시
다음 패키지 정보를 고려하세요.
- 프로젝트:
my-project - 저장소:
my-repo - 저장소 위치:
us-west1 - 패키지:
my-app
다음 명령어는 기본 프로젝트 내의 us-west1 위치에 있는 my-repo 저장소의 모든 파일을 나열합니다.
gcloud artifacts files list \
--location=us-west1 \
--repository=my-repo
1.0 버전 파일을 나열합니다.
gcloud artifacts files list \
--project=my-project \
--location=us-west1 \
--repository=my-repo \
--package=my-app \
--version=1.0
패키지 및 버전 삭제
저장소 모드: 표준, 원격
패키지 및 모든 해당 버전을 삭제하거나 특정 버전을 삭제할 수 있습니다. 삭제된 패키지는 복원할 수 없습니다.
패키지 또는 패키지 버전을 삭제하기 전에 이에 대한 중요한 종속 항목에 대해 논의하거나 처리했는지 확인합니다.
패키지를 삭제하려면 다음 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 저장소 페이지를 엽니다.
저장소 목록에서 적절한 저장소를 클릭합니다.
패키지 페이지에 저장소의 패키지가 나열됩니다.
삭제할 패키지를 선택합니다.
삭제를 클릭합니다.
확인 대화상자에서 삭제를 클릭합니다.
gcloud
다음 명령어를 실행합니다.
gcloud artifacts packages delete PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] [--async]
다음을 바꿉니다.
PACKAGE는 저장소의 패키지 이름입니다.REPOSITORY는 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.-
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
--async 플래그를 사용하면 진행 중인 작업이 완료될 때까지 기다리지 않고 명령어가 즉시 반환됩니다.
패키지 버전을 삭제하려면 다음 안내를 따르세요.
콘솔
Google Cloud 콘솔에서 저장소 페이지를 엽니다.
저장소 목록에서 적절한 저장소를 클릭합니다.
패키지 페이지에 저장소의 패키지가 나열됩니다.
패키지의 버전을 보려면 패키지를 클릭합니다.
삭제할 버전을 선택합니다.
삭제를 클릭합니다.
확인 대화상자에서 삭제를 클릭합니다.
gcloud
다음 명령어를 실행합니다.
gcloud artifacts versions delete VERSION \
--package=PACKAGE \
[--repository=REPOSITORY] [--location=LOCATION] \
[--async]
다음을 바꿉니다.
VERSION은 삭제할 버전의 이름입니다.PACKAGE는 저장소의 패키지 이름입니다.REPOSITORY는 저장소 이름입니다. 기본 저장소를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.-
LOCATION은 저장소의 리전 또는 멀티 리전 위치입니다. 특정 위치의 저장소를 보려면 이 플래그를 사용합니다. 기본 위치를 구성한 경우 이 플래그를 생략하여 기본값을 사용할 수 있습니다.
--async 플래그를 사용하면 진행 중인 작업이 완료될 때까지 기다리지 않고 명령어가 즉시 반환됩니다.
원격 저장소의 경우 Artifact Registry는 패키지 버전과 파일을 비롯한 선택한 패키지의 캐싱 데이터를 삭제합니다.