GCP는 프로덕션에 Python 패키지를 게시합니다.

GCP: 프로덕션에 Python 패키지 게시

이 가이드에서는 Google Artifact Registry를 사용하여 공유 Python 코드를 패키지로 관리하는 방법을 설명합니다. 이 접근 방식은 Cloud Functions와 서버 간의 코드 중복을 제거합니다.

---

1단계: 공유 코드 구조화

공유 로직(예: common_logic)을 위한 새 Python 패키지를 만듭니다.

common_logic/
├── setup.py
├── common_logic/
│   ├── __init__.py

---

2단계: setup.py 만들기

setup.py 파일에서 패키지 구성을 정의합니다.

common_logic/
├── setup.py
├── common_logic/
│   ├── __init__.py

---

3단계: Google Artifact Registry 설정

1. Artifact Registry API 활성화:

from setuptools import setup, find_packages

setup(
    name="common_logic",
    version="0.1.0",
    packages=find_packages(),
    install_requires=[
        "pandas>=1.3.0",
    ],
    author="Your Name",
    author_email="your.email@example.com",
    description="Common logic for app",
)

1. Python 저장소 만들기:

   gcloud services enable artifactregistry.googleapis.com

---

4단계: 인증 구성

1. 서비스 계정 만들기:

   gcloud artifacts repositories create python-packages \
       --repository-format=python \
       --location=us-central1 \
       --description="Python packages repository"

1. 필요한 권한 부여:

   gcloud iam service-accounts create artifact-publisher \
       --description="Service account for publishing to Artifact Registry"

1. 키 생성 및 다운로드:

   gcloud artifacts repositories add-iam-policy-binding python-packages \
       --location=us-central1 \
       --member="serviceAccount:artifact-publisher@${PROJECT_ID}.iam.gserviceaccount.com" \
       --role="roles/artifactregistry.writer"

---

5단계: 패키지 빌드 및 업로드

1. 빌드 도구 설치:

   gcloud iam service-accounts keys create key.json \
       --iam-account=artifact-publisher@${PROJECT_ID}.iam.gserviceaccount.com

1. 패키지 빌드:

   pip install build twine

1. Artifact Registry용 꼬기 구성:

   python -m build

1. 패키지 업로드:

   cat > ~/.pypirc << EOL
   [distutils]
   index-servers = common-logic-repo
   [common-logic-repo]
   repository: https://us-central1-python.pkg.dev/${PROJECT_ID}/python-packages/
   username: _json_key_base64
   password: $(base64 -w0 key.json)
   EOL

---

6단계: 패키지 사용

클라우드 기능에서

1. requirements.txt 파일을 만듭니다.

   twine upload --repository common-logic-repo dist/*

1. Cloud 함수에서 패키지를 사용하세요.

   --index-url https://pypi.org/simple
   --extra-index-url https://oauth2accesstoken:${ARTIFACT_REGISTRY_TOKEN}@us-central1-python.pkg.dev/${PROJECT_ID}/python-packages/simple/
   common-logic==0.1.0

서버 코드에서

1. 서버의 요구사항.txt에 추가:

   from common_logic import ...

   def cloud_function(request):
       # Your cloud function code using the imported functions
       pass

1. 서버 코드에서 사용하세요:

   --index-url https://pypi.org/simple
   --extra-index-url https://oauth2accesstoken:${ARTIFACT_REGISTRY_TOKEN}@us-central1-python.pkg.dev/${PROJECT_ID}/python-packages/simple/
   common-logic==0.1.0

---

7단계: CI/CD 통합

1. GitHub 저장소에 서비스 계정 키를 보안 비밀로 추가하세요.
2. Cloud Build 구성을 업데이트하세요.

   from common_logic import ...
   # Your server code using the imported functions

---

8단계: 버전 관리

1. setup.py에서 버전을 업데이트하세요.
2. 새 버전을 빌드하고 업로드하세요.
3. Cloud Functions와 서버 코드 모두에서 요구사항.txt를 업데이트하세요.
4. 두 구성 요소를 모두 배포합니다.

---

모범 사례

• 패키지에 의미적 버전 관리를 사용하세요.
• requirements.txt에 특정 버전을 고정하세요.
• 새 버전을 배포하기 전에 철저하게 테스트하세요.
• 버전 변경에 대한 변경 로그를 유지하세요.
• PROJECT_ID 및 LOCATION에 환경 변수를 사용하세요.
• 패키지에 포괄적인 문서를 포함하세요.

---

일반적인 문제 및 해결 방법

인증 오류

• 서비스 계정 권한을 확인하세요.
• key.json이 올바르게 인코딩되었는지 확인하세요.
• .pypirc 구성을 확인하세요.

패키지를 찾을 수 없음

• 저장소 URL 형식을 확인하세요.
• 패키지가 성공적으로 업로드되었는지 확인하세요.
• requirements.txt가 올바른 URL 형식을 사용하는지 확인하세요.

버전 충돌

• 특정 종속성 버전을 고정하세요.
• 테스트에는 가상 환경을 사용하세요.
• 종속성 요구 사항을 명확하게 문서화하세요.

위 내용은 GCP는 프로덕션에 Python 패키지를 게시합니다.의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!