View a markdown version of this page

Compila e testa pacchetti localmente - Deadline Cloud
PrerequisitiCreazione e pubblicazione di un pacchetto su un canale localeBuild di debugTest del pacchettoRimozione dei 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 CI/CD l'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 unico passaggio. Quando si sceglie come destinazione una directory del filesystem 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 contenuta nell'archivio degli esempi di Deadline Cloud. GitHub Puoi sostituire una ricetta diversa dall'archivio degli esempi o utilizzare la tua ricetta.

Prerequisiti

Prima di iniziare, installa i seguenti strumenti sulla tua workstation:

  • pixi — Un gestore di pacchetti utilizzato per installare rattler-build e testare i pacchetti. Installa pixi da pixi.sh.

  • rattler-build — Lo strumento per la creazione di pacchetti utilizzato dalle ricette conda di Deadline Cloud. Dopo aver installato pixi, esegui il seguente comando per l'installazione. rattler-build

    pixi global install rattler-build

  • git — Necessario per clonare il repository degli esempi. OnWindows, git for fornisce Windows 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 usi rattler-build publish per creare e pubblicare il pacchetto su un canale di filesystem 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 della build. Assicurati 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 dei canali se la directory non esiste.

    • Copia il file del pacchetto sul canale.

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

    Se la ricetta del pacchetto dipende dai pacchetti di un canale particolare, come 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 migliore pratica è quella di non sovrascrivere mai un pacchetto in un canale. Crea sempre con un nuovo numero di build se altrimenti il pacchetto avrebbe lo stesso nome di file. Using --build-number=+1 consente di raggiungere questo obiettivo quando si passa a un canale di produzione o a un canale di staging che rispecchia la produzione.

Se desideri controllare direttamente il numero di build, puoi impostarlo con un valore specifico come. --build-number=7 Se ometti l'opzione, rattler-build utilizza il numero di build definito nel recipe.yaml file.

Per ulteriori informazioni in meritorattler-build publish, consulta la documentazione di rattler-build publish.

Build di debug

Se una compilazione fallisce, rattler-build conserva la directory di compilazione in modo da poter indagare. Esegui il comando seguente per aprire una shell interattiva nell'ambiente di compilazione con tutte le variabili di ambiente impostate com'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 nella documentazione di rattler-build.

Test del pacchetto

Dopo aver creato e pubblicato il pacchetto, create un progetto pixi temporaneo. Utilizzate 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 runcomando attiva l'ambiente conda per la directory del progetto ed esegue il comando specificato al suo interno. L'ambiente persiste nella directory del progetto, quindi è possibile utilizzare lo stesso pixi run comando da altri terminali.

Quando sei soddisfatto del pacchetto, puoi pubblicarlo su un canale conda di Amazon S3 in modo che gli operatori di Deadline Cloud possano installare il pacchetto. Vedi Pubblicare pacchetti su un canale conda S3.

Rimozione dei pacchetti dal canale

Evitate di rimuovere i pacchetti dai canali utilizzati per la produzione, perché i lockfile fanno riferimento a pacchetti specifici tramite hash. La rimozione di un pacchetto impedisce di ricreare ambienti da quei file di blocco. Per i canali di sviluppo e test, è possibile 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.

Su Linux emacOS, esegui 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 del pacchetto vengono archiviati in sottodirectory specifiche della piattaforma come, o. linux-64 win-64 osx-arm64 Elenca il contenuto di queste sottodirectory per trovare il nome esatto 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. Rimuovi la directory del progetto di test.

    Su Linux emacOS, esegui il seguente comando.

    rm -rf package-test-env

    Su Windows (cmd), esegui il comando seguente.

    rmdir /s /q package-test-env

  2. Rimuovi la directory del canale conda locale.

    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) Rimuove la directory rattler-build di output che contiene il file del pacchetto creato.

    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