GCP veröffentlicht Python-Paket in der Produktion

GCP: Python-Paket in der Produktion veröffentlichen

In dieser Anleitung wird erläutert, wie Sie mit Google Artifact Registry gemeinsam genutzten Python-Code als Paket verwalten. Dieser Ansatz eliminiert die Codeduplizierung zwischen Ihren Cloud-Funktionen und dem Server.

Schritt 1: Strukturieren Sie Ihren gemeinsamen Code

Erstellen Sie ein neues Python-Paket für Ihre gemeinsame Logik (z. B. common_logic).

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

Schritt 2: Erstellen Sie setup.py

Definieren Sie Ihre Paketkonfiguration in einer setup.py-Datei:

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

Schritt 3: Richten Sie Google Artifact Registry ein

1. Aktivieren Sie die 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. Erstellen Sie ein Python-Repository:

   gcloud services enable artifactregistry.googleapis.com

Schritt 4: Authentifizierung konfigurieren

1. Erstellen Sie ein Dienstkonto:

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

1. Erteilen Sie die erforderlichen Berechtigungen:

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

1. Erstellen Sie einen Schlüssel und laden Sie ihn herunter:

   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"

Schritt 5: Paket erstellen und hochladen

1. Build-Tools installieren:

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

1. Erstellen Sie das Paket:

   pip install build twine

1. Binden für Artifact Registry konfigurieren:

   python -m build

1. Laden Sie das Paket hoch:

   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

Schritt 6: Verwenden Sie das Paket

In Cloud-Funktionen

1. Erstellen Sie eine „requirements.txt“-Datei:

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

1. Verwenden Sie das Paket in Ihrer Cloud-Funktion:

   --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

Im Servercode

1. Fügen Sie die Datei „Anforderungen Ihres Servers“ hinzu:

   from common_logic import ...

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

1. Verwenden Sie es in Ihrem Servercode:

   --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

Schritt 7: CI/CD-Integration

1. Fügen Sie den Dienstkontoschlüssel als Geheimnis in Ihrem GitHub-Repository hinzu.
2. Aktualisieren Sie Ihre Cloud Build-Konfiguration:

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

Schritt 8: Versionsverwaltung

1. Aktualisieren Sie die Version in setup.py.
2. Erstellen und laden Sie die neue Version hoch.
3. Anforderungen.txt sowohl in Cloud Functions als auch im Servercode aktualisieren.
4. Stellen Sie beide Komponenten bereit.

Best Practices

• Verwenden Sie semantische Versionierung für Ihr Paket.
• Bestimmte Versionen in „requirements.txt“ anpinnen.
• Testen Sie neue Versionen gründlich, bevor Sie sie bereitstellen.
• Führen Sie ein Änderungsprotokoll über Versionsänderungen.
• Verwenden Sie Umgebungsvariablen für PROJECT_ID und LOCATION.
• Fügen Sie Ihrem Paket eine umfassende Dokumentation bei.

Häufige Probleme und Lösungen

Authentifizierungsfehler

• Überprüfen Sie die Dienstkontoberechtigungen.
• Stellen Sie sicher, dass key.json ordnungsgemäß codiert ist.
• Überprüfen Sie die .pypirc-Konfiguration.

Paket nicht gefunden

• Repository-URL-Format überprüfen.
• Überprüfen Sie, ob das Paket erfolgreich hochgeladen wurde.
• Stellen Sie sicher, dass „requirements.txt“ das richtige URL-Format verwendet.

Versionskonflikte

• Bestimmte Versionen von Abhängigkeiten anpinnen.
• Verwenden Sie virtuelle Umgebungen zum Testen.
• Abhängigkeitsanforderungen klar dokumentieren.

Das obige ist der detaillierte Inhalt vonGCP veröffentlicht Python-Paket in der Produktion. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!