Requisitos previos Crear y publicar un paquete en un canal local Depuración de compilaciones Probando el paquete Limpieza

Cree y pruebe paquetes localmente

Antes de publicar paquetes en Amazon S3 o configurar la CI/CD automatización en su granja de Deadline Cloud, puede crear y probar paquetes conda en su estación de trabajo mediante un canal de sistema de archivos local. Este enfoque le permite iterar rápidamente las recetas de forma local y verificar los paquetes.

El rattler-build publish comando crea una receta, copia el paquete resultante en un canal e indexa el canal en un solo paso. Cuando se dirige a un directorio del sistema de archivos local, rattler-build crea e inicializa el canal automáticamente si el directorio no existe.

Las siguientes instrucciones utilizan la receta de ejemplo Blender 4.5 del repositorio de muestras de Deadline Cloud en adelante. GitHub Puedes sustituirla por una receta diferente del repositorio de muestras o usar la tuya propia.

Requisitos previos

Antes de empezar, instale las siguientes herramientas en su estación de trabajo:

pixi: un administrador de paquetes que se utiliza para instalar rattler-build y probar paquetes. Instala pixi desde pixi.sh.
rattler-build: la herramienta de creación de paquetes utilizada por las recetas conda de Deadline Cloud. Después de instalar pixi, ejecuta el siguiente comando para instalarlo. rattler-build
```
pixi global install rattler-build
```
git: necesario para clonar el repositorio de muestras. SíWindows, git for Windows también proporciona un bash intérprete de comandos, que requieren algunas de las recetas de Windows muestra.

Crear y publicar un paquete en un canal local

En este procedimiento, se clona el repositorio de muestras de Deadline Cloud y se utiliza rattler-build publish para crear y publicar el paquete en un canal del sistema de archivos local.

Para crear y publicar un paquete en un canal local

Clona el repositorio de muestras de Deadline Cloud.


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

Cambie al directorio de conda_recipes.
```
cd deadline-cloud-samples/conda_recipes
```
Ejecute el siguiente comando para crear la receta Blender 4.5 y publicar el paquete en un directorio de canales local.

Active Linux y macOS ejecute el siguiente comando.
```
rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to file://$HOME/my-conda-channel
```
En Windows (cmd), ejecute el siguiente comando.
```
rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to file://%USERPROFILE%/my-conda-channel
```
El rattler-build publish comando realiza las siguientes acciones:
- Construye el paquete a partir de la receta.
- Crea el directorio de canales si el directorio no existe.
- Copia el archivo del paquete en el canal.
- Indexa el canal para que los administradores de paquetes puedan encontrarlo.
Si la receta de su paquete depende de los paquetes de un canal en particular, como conda-forge, añada -c conda-forge al comando.

Para reconstruir el paquete después de realizar cambios en la receta, agréguelo --build-number=+1 para incrementar automáticamente el número de compilación.


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

Para obtener más información al respectorattler-build publish, consulte la documentación de publicación de rattler-build.

Depuración de compilaciones

Si una compilación falla, rattler-build conserva el directorio de compilación para que puedas investigarlo. Ejecuta el siguiente comando para abrir un shell interactivo en el entorno de compilación con todas las variables de entorno configuradas tal y como estaban durante la compilación.


rattler-build debug shell

Desde el shell de depuración, puedes modificar archivos, ejecutar comandos de compilación individuales y añadir dependencias para aislar el problema. Para obtener más información, consulta la sección Depuración de compilaciones en la documentación de rattler-build.

Probando el paquete

Después de crear y publicar el paquete, crea un proyecto pixi temporal. Utilice el proyecto para instalar el paquete desde el canal local y comprobar que funciona correctamente.

Para probar el paquete

Cree un directorio de prueba temporal e inicialice un proyecto pixi con el canal local.

Active Linux y ejecute macOS los siguientes comandos.


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

En Windows (cmd), ejecute los siguientes comandos.


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

Añada el paquete al proyecto.
```
pixi add blender=4.5
```
Compruebe que el paquete funciona correctamente.
```
pixi run blender --version
```

Cuando esté satisfecho con el paquete, puede publicarlo en un canal conda de Amazon S3 para que los trabajadores de Deadline Cloud puedan instalarlo. Consulte Publicar paquetes en un canal conda de S3.

Limpieza

Después de la prueba, puede eliminar el proyecto de prueba y el canal local.

Para limpiar los recursos de prueba

Elimine el directorio del proyecto de prueba.

Active Linux y macOS ejecute el siguiente comando.
```
rm -rf package-test-env
```
En Windows (cmd), ejecute el siguiente comando.
```
rmdir /s /q package-test-env
```
Elimine el directorio de canales conda local.

Active Linux y macOS ejecute el siguiente comando.
```
rm -rf $HOME/my-conda-channel
```
En Windows (cmd), ejecute el siguiente comando.
```
rmdir /s /q %USERPROFILE%\my-conda-channel
```
(Opcional) Elimine el directorio rattler-build de salida que contiene el archivo del paquete creado.

Active Linux y macOS ejecute el siguiente comando.
```
rm -rf deadline-cloud-samples/conda_recipes/output
```
En Windows (cmd), ejecute el siguiente comando.
```
rmdir /s /q deadline-cloud-samples\conda_recipes\output
```

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Cree un canal conda con S3

Publica paquetes en un canal conda de Amazon S3