Veröffentlichen Sie Pakete in einem Amazon S3 S3-Conda-Kanal - Deadline Cloud
VoraussetzungenEin Paket auf einem Amazon S3 S3-Kanal veröffentlichenDas Paket testenBereinigenBuilds debuggenPakete für andere Plattformen erstellenNächste Schritte

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Veröffentlichen Sie Pakete in einem Amazon S3 S3-Conda-Kanal

Sie können Conda-Pakete in einem Amazon Simple Storage Service (Amazon S3) -Bucket veröffentlichen, sodass AWS Deadline Cloud-Mitarbeiter (Deadline Cloud) sie für die Ausführung von Jobs installieren können. Der rattler-build publish Befehl funktioniert mit Amazon S3 genauso wie mit einem lokalen Dateisystemkanal. Der Befehl kann ein Rezept erstellen und das Ergebnis veröffentlichen oder eine Paketdatei veröffentlichen, die Sie bereits erstellt haben. In beiden Fällen lädt der Befehl das Paket in den Bucket hoch und indexiert den Channel in einem Schritt.

Der rattler-build publish Befehl authentifiziert sich AWS mithilfe der standardmäßigen Anmeldeinformationskette, sodass er Ihre AWS Konfiguration wie jedes andere Tool verwendet. AWS Weitere Informationen zur Konfiguration von Anmeldeinformationen finden Sie unter Konfiguration und Einstellungen für Anmeldeinformationsdateien im AWS Command Line Interface (AWS CLI) -Benutzerhandbuch.

Voraussetzungen

Bevor Sie Pakete in Amazon S3 veröffentlichen, müssen Sie die folgenden Voraussetzungen erfüllen:

  • pixi and rattler-build — Installieren Sie Pixi aus pixi.sh und installieren Sie es anschließend. rattler-build

    pixi global install rattler-build

  • git — Erforderlich, um das Beispiel-Repository zu klonen. OnWindows, git for bietet Windows auch eine bash Shell, die einige der Windows Beispielrezepte benötigen.

  • Amazon S3 S3-Bucket — Ein Amazon S3 S3-Bucket, der als Conda-Kanal verwendet werden soll. Sie können den Bucket für Jobanhänge aus Ihrer Deadline Cloud-Farm verwenden oder einen separaten Bucket erstellen.

  • AWS Anmeldeinformationen — Konfigurieren Sie die Anmeldeinformationen auf Ihrer Workstation mithilfe des aws configure Befehls oder des aws login Befehls. Weitere Informationen finden Sie unter Einrichten von AWS CLI im AWS Command Line Interface -Benutzerhandbuch.

  • IAM-Berechtigungen — (Optional) Um den Umfang der Berechtigungen zu reduzieren, über die Ihre Anmeldeinformationen verfügen, können Sie eine AWS Identity and Access Management (IAM-) Richtlinie verwenden, die nur die folgenden Berechtigungen für den Amazon S3 S3-Bucket und das von Ihnen verwendete Kanalpräfix gewährt (z. B./Conda/*):

    • s3:GetObject

    • s3:PutObject

    • s3:DeleteObject

    • s3:ListBucket

    • s3:GetBucketLocation

Ein Paket auf einem Amazon S3 S3-Kanal veröffentlichen

Verwenden Sie rattler-build publish mit einem s3:// Ziel, um ein Paket in Ihrem Amazon S3 S3-Conda-Kanal zu veröffentlichen. Wenn der Kanal nicht im Bucket vorhanden ist, wird der Kanal rattler-build automatisch initialisiert. Bevor Sie beginnen, stellen Sie sicher, dass Sie die Voraussetzungen erfüllt haben.

Im folgenden Beispiel wird das Blender 4.5-Beispielrezept aus dem Deadline Cloud-Beispiel-Repository am veröffentlichtGitHub. Sie können ein anderes Rezept aus dem Samples-Repository verwenden oder Ihr eigenes Rezept verwenden.

Um ein Paket auf einem Amazon S3 S3-Kanal zu veröffentlichen

  1. Klonen Sie das Deadline Cloud-Beispiel-Repository.

    git clone https://github.com/aws-deadline/deadline-cloud-samples.git

  2. Wechseln Sie in das conda_recipes-Verzeichnis.

    cd deadline-cloud-samples/conda_recipes

  3. Führen Sie den folgenden Befehl aus. amzn-s3-demo-bucketErsetzen Sie es durch Ihren Bucket-Namen.

    Führen Sie macOS unter Linux und den folgenden Befehl aus.

    rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to s3://amzn-s3-demo-bucket/Conda/Default

    Führen Sie auf Windows (cmd) den folgenden Befehl aus.

    rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to s3://amzn-s3-demo-bucket/Conda/Default

    Das /Conda/Default Präfix organisiert den Kanal innerhalb des Buckets. Sie können ein anderes Präfix verwenden, aber das Präfix muss in allen Befehlen und Warteschlangenkonfigurationen, die auf den Kanal verweisen, konsistent sein.

Um ein aktualisiertes Paket neu zu erstellen und zu veröffentlichen, fügen Sie --build-number=+1 die Build-Nummer hinzu, um sie automatisch zu erhöhen.

rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to s3://amzn-s3-demo-bucket/Conda/Default \
    --build-number=+1

Wenn Ihr Paketrezept von Paketen aus einem bestimmten Channel abhängt, wie z. B. conda-forge, fügen Sie dem Befehl etwas -c conda-forge hinzu.

Sie können auch eine Paketdatei veröffentlichen, die Sie bereits erstellt haben, z. B. eine .conda Datei aus einem lokalen Build. amzn-s3-demo-bucketErsetzen Sie es durch Ihren Bucket-Namen.

rattler-build publish output/linux-64/blender-4.5.0-hb0f4dca_0.conda \
    --to s3://amzn-s3-demo-bucket/Conda/Default

Das Paket testen

Nachdem Sie das Paket veröffentlicht haben, erstellen Sie ein temporäres Pixi-Projekt, um zu überprüfen, ob das Paket ordnungsgemäß funktioniert. Das Projekt installiert das Paket aus dem Amazon S3 S3-Channel.

Um das Paket zu testen

  1. Erstellen Sie ein temporäres Testverzeichnis und initialisieren Sie ein Pixi-Projekt mit dem Amazon S3 S3-Kanal. Ersetzen Sie es amzn-s3-demo-bucket durch Ihren Bucket-Namen.

    mkdir package-test-env
cd package-test-env
pixi init --channel s3://amzn-s3-demo-bucket/Conda/Default

  2. Fügen Sie das Paket dem Projekt hinzu.

    pixi add blender=4.5

  3. Stellen Sie sicher, dass das Paket ordnungsgemäß funktioniert.

    pixi run blender --version

Bereinigen

Entfernen Sie nach dem Testen das Testprojektverzeichnis.

Um Testressourcen zu bereinigen

  • Entfernen Sie das Testprojektverzeichnis.

    Führen Sie macOS unter Linux und den folgenden Befehl aus.

    rm -rf package-test-env

    Führen Sie auf Windows (cmd) den folgenden Befehl aus.

    rmdir /s /q package-test-env

Builds debuggen

Wenn ein Build fehlschlägt, wird rattler-build das Build-Verzeichnis beibehalten, sodass Sie es untersuchen können. Führen Sie den folgenden Befehl aus, um eine interaktive Shell in der Build-Umgebung zu öffnen, in der alle Umgebungsvariablen so eingerichtet sind, wie sie während des Builds waren.

rattler-build debug shell

In der Debug-Shell können Sie Dateien ändern, einzelne Build-Befehle ausführen und Abhängigkeiten hinzufügen, um das Problem zu isolieren. Weitere Informationen finden Sie unter Debuggen von Builds in der Rattler-Build-Dokumentation.

Pakete für andere Plattformen erstellen

Der rattler-build publish Befehl erstellt Pakete für das Betriebssystem der Workstation, auf der der Befehl ausgeführt wird. Wenn Ihre Deadline Cloud-Flotte ein anderes Betriebssystem als Ihre Workstation verwendet oder wenn Ihr Paket andere Hostanforderungen hat, haben Sie die folgenden Optionen:

  • rattler-build publishAuf einem Host ausführen, der dem Zielbetriebssystem entspricht. Verwenden Sie beispielsweise eine Amazon Elastic Compute Cloud (Amazon EC2) -Instance, die ausgeführt wirdLinux, um Pakete für eine Linux Flotte zu erstellen.

  • Verwenden Sie eine Deadline Cloud-Warteschlange zur Paketerstellung, um Builds auf der Zielplattform zu automatisieren. Weitere Informationen finden Sie unter Erstellen einer Warteschlange zur Paketerstellung.

  • (Fortgeschritten) Verwenden Sie Cross-Compilierung, um Pakete für eine andere Plattform als Ihre Workstation zu erstellen. Weitere Informationen finden Sie unter Cross-Compilierung in der Rattler-Build-Dokumentation.

Nächste Schritte

Nachdem Sie Pakete in Ihrem Amazon S3 S3-Conda-Kanal veröffentlicht haben, konfigurieren Sie Ihre Deadline Cloud-Warteschlangen so, dass sie den Kanal verwenden: