Prerequisiti Creazione e pubblicazione di un pacchetto su un canale locale Compilazioni di debug Test del pacchetto Pulizia

Compila e testa i 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.

Per creare e pubblicare un pacchetto su un canale locale

Clona il repository di esempi di Deadline Cloud.


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

Passare alla directory conda_recipes.
```
cd deadline-cloud-samples/conda_recipes
```
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
```
Su Windows (cmd), esegui il comando seguente.
```
rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to file://%USERPROFILE%/my-conda-channel
```
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

Per ricostruire il pacchetto dopo aver apportato modifiche alla ricetta, aggiungi per --build-number=+1 incrementare automaticamente il numero di build.


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

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

Compilazioni 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

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

Aggiungi il pacchetto al progetto.
```
pixi add blender=4.5
```
Verifica che il pacchetto funzioni correttamente.
```
pixi run blender --version
```

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.

Pulizia

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

Per ripulire le risorse di test

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

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Crea un canale conda usando S3

Pubblica pacchetti su un canale conda Amazon S3