byteforce

CPN 한국어 자습서 · 외부 문서 한국어 미러

UV 문서 · Guides

Google Artifact Registry

Google Artifact Registry · 원문: docs.astral.sh/uv/guides/integration/google/

아래는 원문을 한국어로 옮긴 미러입니다. 코드·명령은 원문 그대로이며, 가장 최신 정보는 하단 원문 링크에서 확인하세요.

uv는 액세스 토큰 또는 keyring 패키지를 사용하여 Google Artifact Registry에서 패키지를 설치할 수 있습니다.

Google 액세스 토큰으로 인증하기

프로젝트 설정에 인덱스를 추가합니다:

코드 · 명령
[[tool.uv.index]]
name = "private-registry"
url = "https://<REGION>-python.pkg.dev/<PROJECT>/<REPOSITORY>/simple/"

gcloud CLI를 사용하여 토큰을 생성합니다:

코드 · 명령
export ARTIFACT_REGISTRY_TOKEN=$(
    gcloud auth application-default print-access-token
)

환경변수를 사용하여 자격증명을 설정합니다:

코드 · 명령
export UV_INDEX_PRIVATE_REGISTRY_USERNAME=oauth2accesstoken
export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="$ARTIFACT_REGISTRY_TOKEN"

환경변수의 인덱스 이름은 설정에서 정의한 이름과 일치해야 합니다.

keyring과 keyrings.google-artifactregistry-auth로 인증하기

keyrings.google-artifactregistry-auth 플러그인은 keyring과 함께 작동하여 gcloud CLI에서 단기 액세스 토큰을 안전하게 관리합니다.

필요한 패키지를 설치합니다:

코드 · 명령
uv tool install keyring --with keyrings.google-artifactregistry-auth

서브프로세스 모드에서 keyring 인증을 활성화합니다:

코드 · 명령
export UV_KEYRING_PROVIDER=subprocess
export UV_INDEX_PRIVATE_REGISTRY_USERNAME=oauth2accesstoken

패키지 게시하기

인덱스에 게시 URL을 설정합니다:

코드 · 명령
[[tool.uv.index]]
name = "private-registry"
url = "https://<REGION>-python.pkg.dev/<PROJECT>/<REPOSITORY>/simple/"
publish-url = "https://<REGION>-python.pkg.dev/<PROJECT>/<REPOSITORY>/"

게시 자격증명을 설정합니다:

코드 · 명령
export UV_PUBLISH_USERNAME=oauth2accesstoken
export UV_PUBLISH_PASSWORD="$ARTIFACT_REGISTRY_TOKEN"

패키지를 게시합니다:

코드 · 명령
uv publish --index private-registry

또는 프로젝트 설정을 수정하지 않고 UV_PUBLISH_URL을 사용합니다:

코드 · 명령
export UV_PUBLISH_URL=https://<REGION>-python.pkg.dev/<PROJECT>/<REPOSITORY>/
uv publish

원문(영어): https://docs.astral.sh/uv/guides/integration/google/ · 본 문서는 학습용 한국어 번역이며 원본의 권리는 원저작자(Astral)에게 있습니다.

원문(영어): https://docs.astral.sh/uv/guides/integration/google/