byteforce

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

UV 문서 · Guides

Coiled와 함께 uv 사용하기

Using uv with Coiled · 원문: docs.astral.sh/uv/guides/integration/coiled/

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

Coiled는 서버리스, UX 중심의 클라우드 컴퓨팅 플랫폼으로 클라우드 하드웨어(AWS, GCP, Azure)에서 코드를 쉽게 실행할 수 있습니다.

이 가이드는 의존성 관리를 위해 uv를, 클라우드 배포를 위해 Coiled를 사용하여 클라우드에서 Python 스크립트를 실행하는 방법을 설명합니다.

uv로 스크립트 의존성 관리하기

다음 예시는 인라인 의존성이 있는 자체 포함 Python 스크립트를 보여줍니다:

코드 · 명령
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "pandas",
#   "pyarrow",
#   "s3fs",
# ]
# ///

import pandas as pd

df = pd.read_parquet(
    "s3://coiled-data/uber/part.0.parquet",
    storage_options={"anon": True},
)
print(df.head())

uv run process.py로 로컬에서 실행할 때 uv는 자동으로 가상환경을 생성하고 의존성을 설치합니다. 인라인 스크립트 메타데이터는 스크립트를 완전히 자체 포함적이고 이식 가능하게 만듭니다.

Coiled로 클라우드에서 스크립트 실행하기

다음과 같은 시나리오에서 클라우드 실행이 유용합니다:

인증

먼저 Coiled에 인증합니다:

코드 · 명령
$ uvx coiled login

설정

스크립트에 클라우드 설정을 지정하는 두 개의 주석을 추가합니다:

코드 · 명령
# COILED container ghcr.io/astral-sh/uv:debian-slim
# COILED region us-east-2

이 지시문은 Coiled에게 공식 uv Docker 이미지를 사용하고 지정된 AWS 리전에서 실행하도록 알려줍니다.

실행

배치 작업을 제출합니다:

코드 · 명령
$ uvx coiled batch run \
    uv run process.py

동일한 프로세스가 이제 원격 클라우드 VM에서 실행됩니다. cloud.coiled.io나 coiled batch status, coiled batch wait, coiled batch logs 같은 터미널 명령으로 진행 상황을 모니터링할 수 있습니다.

인스턴스 유형, 디스크 크기, 스팟 인스턴스 설정 등 추가 설정 옵션은 Coiled Batch 문서를 참조하세요.

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

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