byteforce

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

UV 문서 · Guides

AWS CodeArtifact

AWS CodeArtifact · 원문: docs.astral.sh/uv/guides/integration/aws/

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

개요

uv 패키지 관리자는 액세스 토큰 또는 자격증명 관리를 위한 keyring 패키지를 사용하여 AWS CodeArtifact에서 패키지를 가져올 수 있습니다.

인덱스 설정

pyproject.toml에 CodeArtifact 인덱스를 선언합니다:

코드 · 명령
[[tool.uv.index]]
name = "private-registry"
url = "https://<DOMAIN>-<ACCOUNT_ID>.d.codeartifact.<REGION>.amazonaws.com/pypi/<REPOSITORY>/simple/"

인증 방법

AWS 액세스 토큰 사용

AWS CLI를 통해 토큰을 생성합니다:

코드 · 명령
export AWS_CODEARTIFACT_TOKEN="$(
    aws codeartifact get-authorization-token \
    --domain <DOMAIN> \
    --domain-owner <ACCOUNT_ID> \
    --query authorizationToken \
    --output text
)"

Basic HTTP 인증 자격증명으로 uv를 설정합니다:

코드 · 명령
export UV_INDEX_PRIVATE_REGISTRY_USERNAME=aws
export UV_INDEX_PRIVATE_REGISTRY_PASSWORD="$AWS_CODEARTIFACT_TOKEN"

인증이 성공하려면 사용자 이름이 반드시 aws여야 합니다.

Keyring 통합 사용

공개 PyPI에서 keyring 도구를 설치합니다:

코드 · 명령
uv tool install keyring --with keyrings.codeartifact

서브프로세스 모드를 활성화합니다:

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

keyrings.codeartifact 플러그인은 boto3를 래핑하여 단기 액세스 토큰을 생성하고, 시스템 keyring에 안전하게 저장하며, 만료 시 갱신합니다.

패키지 게시하기

인덱스 설정에 publish-url을 추가합니다:

코드 · 명령
[[tool.uv.index]]
name = "private-registry"
url = "https://<DOMAIN>-<ACCOUNT_ID>.d.codeartifact.<REGION>.amazonaws.com/pypi/<REPOSITORY>/simple/"
publish-url = "https://<DOMAIN>-<ACCOUNT_ID>.d.codeartifact.<REGION>.amazonaws.com/pypi/<REPOSITORY>/"

게시 자격증명을 설정하고 실행합니다:

코드 · 명령
export UV_PUBLISH_USERNAME=aws
export UV_PUBLISH_PASSWORD="$AWS_CODEARTIFACT_TOKEN"
uv publish --index private-registry

또는 게시 URL을 직접 설정합니다:

코드 · 명령
export UV_PUBLISH_URL=https://<DOMAIN>-<ACCOUNT_ID>.d.codeartifact.<REGION>.amazonaws.com/pypi/<REPOSITORY>/
uv publish

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

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