View a markdown version of this page

Compila e testa pacchetti localmente - Deadline Cloud
PrerequisitiCreazione e pubblicazione di un pacchetto su un canale localeIl debugging costruisceTest del pacchettoRimozione di pacchetti dal canalePulizia

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Compila e testa pacchetti localmente

Prima di pubblicare pacchetti su Amazon S3 o configurare l' CI/CD automazione nella tua farm Deadline Cloud, puoi creare e testare pacchetti conda sulla tua workstation utilizzando un canale di file system locale. Questo approccio consente di iterare rapidamente a livello locale sulle ricette e verificare i pacchetti.

Il rattler-build publish comando crea una ricetta, copia il pacchetto risultante su un canale e indicizza il canale in un solo passaggio. Quando si sceglie come destinazione una directory del file system locale, rattler-build crea e inizializza automaticamente il canale se la directory non esiste.

Le seguenti istruzioni utilizzano la ricetta di esempio Blender 4.5 dal repository di esempi di Deadline Cloud sul sito Web. GitHub Puoi sostituire una ricetta diversa dall'archivio degli esempi o utilizzare la tua ricetta.

Prerequisiti

Prima di iniziare, installate i seguenti strumenti sulla vostra workstation:

  • pixi — Un gestore di pacchetti che usi per installare rattler-build e testare i pacchetti. Per le istruzioni di installazione, consulta pixi.sh sul sito web di Pixi.

  • rattler-build — Lo strumento di creazione di pacchetti utilizzato da Deadline Cloud conda recipes. Dopo aver installato pixi, esegui il seguente comando per installarlo. rattler-build

    pixi global install rattler-build

  • git — Necessario per clonare il repository degli esempi. SìWindows, Git for Windows sul sito Web Git for Windows fornisce anche una bash shell, richiesta da alcune ricette di Windows esempio.

Creazione e pubblicazione di un pacchetto su un canale locale

In questa procedura, cloni il repository di esempi di Deadline Cloud e lo utilizzi rattler-build publish per creare e pubblicare il pacchetto su un canale di file system locale.

Nota

Le applicazioni di grandi dimensioni possono richiedere decine di GB di spazio libero su disco per l'archivio di origine, i file estratti e l'output di compilazione. Assicuratevi di utilizzare un disco con spazio disponibile sufficiente per l'output di compilazione del pacchetto.

Per creare e pubblicare un pacchetto su un canale locale

  1. Clona il repository di esempi di Deadline Cloud.

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

  2. Passare alla directory conda_recipes.

    cd deadline-cloud-samples/conda_recipes

  3. Esegui il comando seguente per creare la ricetta Blender 4.5 e pubblicare il pacchetto in una directory di canale locale.

    Su Linux emacOS, esegui il seguente comando.

    rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to file://$HOME/my-conda-channel \
    --build-number=+1

    Su Windows (cmd), esegui il comando seguente.

    rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to file://%USERPROFILE%/my-conda-channel ^
    --build-number=+1

    Il rattler-build publish comando esegue le seguenti azioni:

    • Crea il pacchetto a partire dalla ricetta.

    • Crea la directory del canale se la directory non esiste.

    • Copia il file del pacchetto nel canale.

    • Indicizza il canale in modo che i gestori di pacchetti possano trovarlo.

    Se la ricetta del pacchetto dipende dai pacchetti di un particolare canale, come conda-forge sul sito web di conda-forge, aggiungila al comando. -c conda-forge

Informazioni sui numeri di build

L'--build-number=+1opzione seleziona automaticamente il numero di build successivo in base a ciò che già esiste nel canale di destinazione. La procedura migliore è non sovrascrivere mai un pacchetto in un canale. Compila sempre con un nuovo numero di build se altrimenti il pacchetto avrebbe lo stesso nome di file. L'utilizzo --build-number=+1 consente di ottenere questo risultato quando si crea su un canale di produzione o un canale di staging che rispecchia la produzione.

Se vuoi controllare direttamente il numero di build, puoi impostarlo con un valore specifico come. --build-number=7 Se si omette l'opzione, rattler-build viene utilizzato il numero di build definito nel recipe.yaml file.

Per ulteriori informazionirattler-build publish, consulta la documentazione di pubblicazione di rattler-build sul sito Web prefix.dev.

Il debugging costruisce

Se una compilazione fallisce, rattler-build conserva la directory di compilazione in modo che tu possa esaminarla. Eseguite il comando seguente per aprire una shell interattiva nell'ambiente di compilazione con tutte le variabili di ambiente impostate così come erano durante la compilazione.

rattler-build debug shell

Dalla shell di debug, puoi modificare i file, eseguire singoli comandi di compilazione e aggiungere dipendenze per isolare il problema. Per ulteriori informazioni, consulta Debugging build sul sito Web prefix.dev.

Test del pacchetto

Dopo aver creato e pubblicato il pacchetto, crea un progetto pixi temporaneo. Usa il progetto per installare il pacchetto dal canale locale e verificare che funzioni correttamente.

Per testare il pacchetto

  1. Crea una directory di test temporanea e inizializza un progetto pixi con il canale locale.

    Su Linux emacOS, esegui i seguenti comandi.

    mkdir package-test-env
cd package-test-env
pixi init --channel file://$HOME/my-conda-channel

    Su Windows (cmd), esegui i seguenti comandi.

    mkdir package-test-env
cd package-test-env
pixi init --channel file://%USERPROFILE%/my-conda-channel

  2. Aggiungi il pacchetto al progetto.

    pixi add blender=4.5

  3. Verifica che il pacchetto funzioni correttamente.

    pixi run blender --version

    Il pixi run comando attiva l'ambiente conda per la directory del progetto ed esegue il comando specificato al suo interno. L'ambiente rimane nella directory del progetto, quindi è possibile utilizzare lo stesso pixi run comando da altri terminali. Per ulteriori informazioni, consulta il pixi run comando sul sito web di Pixi.

Quando sei soddisfatto del pacchetto, puoi pubblicarlo su un canale conda Amazon S3 in modo che i lavoratori di Deadline Cloud possano installarlo. Vedi Pubblicare pacchetti su un canale conda S3.

Rimozione di pacchetti dal canale

Evita di rimuovere i pacchetti dai canali che usi per la produzione, perché i lockfile fanno riferimento a pacchetti specifici tramite hash. La rimozione di un pacchetto impedisce di ricreare ambienti a partire da quei lockfile. Per i canali di sviluppo e test, puoi rimuovere un pacchetto specifico eliminando il .conda file dalla directory del canale e quindi reindicizzando il canale. Innanzitutto, installa. rattler-index

pixi global install rattler-index

Quindi elimina il file del pacchetto e reindicizza il canale.

LinuxAttivate macOS e eseguite i seguenti comandi.

rm $HOME/my-conda-channel/linux-64/blender-4.5.0-hb0f4dca_1.conda
rattler-index fs $HOME/my-conda-channel

Su Windows (cmd), esegui i seguenti comandi.

del %USERPROFILE%\my-conda-channel\win-64\blender-4.5.0-hb0f4dca_1.conda
rattler-index fs %USERPROFILE%\my-conda-channel

I file dei pacchetti vengono archiviati in sottodirectory specifiche della piattaforma, ad esempio, o. linux-64 win-64 osx-arm64 Elenca il contenuto di queste sottodirectory per trovare il nome esatto del file del pacchetto che desideri rimuovere.

Pulizia

Dopo il test, puoi rimuovere il progetto di test e il canale locale.

Per ripulire le risorse di test

  1. Rimuovere la directory del progetto di test.

    Su Linux emacOS, esegui il comando seguente.

    rm -rf package-test-env

    Su Windows (cmd), esegui il comando seguente.

    rmdir /s /q package-test-env

  2. Rimuovi la directory locale del canale conda.

    Su Linux emacOS, esegui il seguente comando.

    rm -rf $HOME/my-conda-channel

    Su Windows (cmd), esegui il comando seguente.

    rmdir /s /q %USERPROFILE%\my-conda-channel

  3. (Facoltativo) Rimuovi la directory rattler-build di output che contiene il file del pacchetto compilato.

    Su Linux emacOS, esegui il comando seguente.

    rm -rf deadline-cloud-samples/conda_recipes/output

    Su Windows (cmd), esegui il comando seguente.

    rmdir /s /q deadline-cloud-samples\conda_recipes\output

Per i plugin supportati con esempi di sincronizzazione dei plug-in, consulta. Sincronizza i plugin con i lavoratori di Deadline Cloud