Requisitos previos Publicar un paquete en un canal Amazon S3 Probando el paquete Limpieza Depuración de compilaciones Creación de paquetes para otras plataformas Siguientes pasos

Publica paquetes en un canal conda de Amazon S3

Puede publicar paquetes conda en un depósito de Amazon Simple Storage Service (Amazon S3) para AWS que los trabajadores de Deadline Cloud (Deadline Cloud) puedan instalarlos para ejecutar tareas. El rattler-build publish comando funciona con Amazon S3 de la misma forma que con un canal de sistema de archivos local. El comando puede crear una receta y publicar el resultado, o publicar un archivo de paquete que ya haya creado. En ambos casos, el comando carga el paquete en el depósito e indexa el canal en un solo paso.

El rattler-build publish comando se autentica AWS mediante la cadena de credenciales estándar, por lo que utiliza la AWS configuración como cualquier otra herramienta. AWS Para obtener más información sobre la configuración de las credenciales, consulte los ajustes de configuración y del archivo de credenciales en la Guía del usuario de AWS Command Line Interface (AWS CLI).

Requisitos previos

Antes de publicar paquetes en Amazon S3, complete los siguientes requisitos previos:

pixi y rattler-build: instale pixi desde pixi.sh y, a continuación, instálelo. 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.
Depósito de Amazon S3: un depósito de Amazon S3 para usar como canal conda. Puedes usar el depósito de adjuntos de tareas de tu granja de Deadline Cloud o crear un depósito independiente.
AWS credenciales: configure las credenciales en su estación de trabajo mediante el aws configure comando o el aws login comando. Para obtener más información, consulte Configuración de AWS CLI en la Guía del usuario de AWS Command Line Interface .
Permisos de IAM: (opcional) Para reducir el alcance de los permisos que tienen sus credenciales, puede utilizar una política AWS Identity and Access Management (de IAM) que solo conceda los siguientes permisos en el bucket de Amazon S3 y el prefijo de canal que utilice (por ejemplo,): /Conda/*
- s3:GetObject
- s3:PutObject
- s3:DeleteObject
- s3:ListBucket
- s3:GetBucketLocation

Publicar un paquete en un canal Amazon S3

Úselo rattler-build publish con un s3:// destino para publicar un paquete en su canal conda de Amazon S3. Si el canal no existe en el bucket, lo rattler-build inicializa automáticamente. Antes de empezar, asegúrese de haber completado los requisitos previos.

El siguiente ejemplo publica la receta de muestras Blender 4.5 del repositorio de muestras de Deadline Cloud enGitHub. Puedes sustituirla por una receta diferente del repositorio de muestras o usar la tuya propia.

Para publicar un paquete en un canal Amazon S3

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 comando siguiente. Reemplace amzn-s3-demo-bucket con el nombre del bucket.

Active Linux y macOS ejecute el siguiente comando.
```
rattler-build publish blender-4.5/recipe/recipe.yaml \
    --to s3://amzn-s3-demo-bucket/Conda/Default
```
En Windows (cmd), ejecute el siguiente comando.
```
rattler-build publish blender-4.5/recipe/recipe.yaml ^
    --to s3://amzn-s3-demo-bucket/Conda/Default
```
El /Conda/Default prefijo organiza el canal dentro del depósito. Puedes usar un prefijo diferente, pero el prefijo debe ser coherente en todos los comandos y configuraciones de cola que hacen referencia al canal.

Para reconstruir y publicar un paquete actualizado, 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 s3://amzn-s3-demo-bucket/Conda/Default \
    --build-number=+1

Si la receta de su paquete depende de paquetes de un canal en particular, como conda-forge, añada -c conda-forge al comando.

También puede publicar un archivo de paquete que ya haya creado, por ejemplo, un .conda archivo de una compilación local. Reemplace amzn-s3-demo-bucket con el nombre del bucket.


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

Probando el paquete

Tras publicar el paquete, cree un proyecto pixi temporal para comprobar que el paquete funciona correctamente. El proyecto instala el paquete desde el canal Amazon S3.

Para probar el paquete

Cree un directorio de prueba temporal e inicialice un proyecto pixi con el canal Amazon S3. Reemplace amzn-s3-demo-bucket con el nombre del bucket.
```
mkdir package-test-env
cd package-test-env
pixi init --channel s3://amzn-s3-demo-bucket/Conda/Default
```
Añada el paquete al proyecto.
```
pixi add blender=4.5
```
Compruebe que el paquete funciona correctamente.
```
pixi run blender --version
```

Limpieza

Tras la prueba, elimine el directorio del proyecto de prueba.

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

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.

Creación de paquetes para otras plataformas

El rattler-build publish comando crea paquetes para el sistema operativo de la estación de trabajo en la que se ejecuta el comando. Si su flota de Deadline Cloud usa un sistema operativo diferente al de su estación de trabajo, o si su paquete tiene otros requisitos de host, tiene las siguientes opciones:

Se ejecuta rattler-build publish en un host que coincida con el sistema operativo de destino. Por ejemplo, utilice una instancia de Amazon Elastic Compute Cloud (Amazon EC2) que se Linux ejecute para crear paquetes para una flota. Linux
Usa una cola de creación de paquetes de Deadline Cloud para automatizar las compilaciones en la plataforma de destino. Consulte Crear una cola de creación de paquetes.
(Avanzado) Utilice la compilación cruzada para crear paquetes para una plataforma diferente a la de su estación de trabajo. Para obtener más información, consulte Compilación cruzada en la documentación de rattler-build.

Siguientes pasos

Después de publicar los paquetes en su canal conda de Amazon S3, configure sus colas de Deadline Cloud para usar el canal:

Configure los permisos de las colas de producción para paquetes conda personalizados: conceda a sus colas de producción acceso de solo lectura al canal conda de Amazon S3.
Añadir un canal conda a un entorno de cola: configure el entorno de cola para instalar paquetes desde el canal conda de Amazon S3.

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 y pruebe paquetes localmente

Cree un paquete conda para una aplicación o un complemento