Requisitos previos Publicar un paquete en un canal Amazon S3 Inicializar o reindexar un canal Probando el paquete Eliminar paquetes del canal 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 manera 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 (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.

nota

Las aplicaciones de gran tamaño pueden requerir decenas de GB de espacio libre en disco para el archivo fuente, los archivos extraídos y la generación de resultados. Asegúrese de utilizar un disco con suficiente espacio disponible para el resultado de la compilación del paquete.

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.
```
rattler-build publish blender-4.5/recipe/recipe.yaml --to s3://amzn-s3-demo-bucket/Conda/Default --build-number=+1
```
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.

Acerca de los números de compilación

La --build-number=+1 opción selecciona automáticamente el siguiente número de compilación en función de lo que ya existe en el canal de destino. La mejor práctica es no sobrescribir nunca un paquete en un canal. Cree siempre con un número de compilación nuevo si, de lo contrario, el paquete tendría el mismo nombre de archivo. Esto se --build-number=+1 consigue al crear un canal de producción o un canal provisional que refleje la producción.

Si quieres controlar el número de compilación directamente, puedes configurarlo con un valor específico, como--build-number=7. Si omite la opción, rattler-build utiliza el número de compilación definido en el recipe.yaml archivo.

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

Inicializar o reindexar un canal

Cuando se publica un paquete, el comando inicializa el canal automáticamente si el canal aún no existe. rattler-build publish En la mayoría de los casos, no es necesario inicializar o reindexar el canal manualmente.

Es posible que tengas que inicializar o reindexar un canal manualmente en las siguientes situaciones:

Quieres crear un canal vacío antes de publicar cualquier paquete, por ejemplo, para comprobar que tu entorno de colas de Deadline Cloud puede conectarse al canal.
Ha cargado o eliminado .conda archivos directamente con las herramientas de Amazon S3 en lugar de rattler-build publish utilizarlos y el índice de canales está desactualizado.

Inicializar un canal vacío

Para inicializar un canal vacío, cree un repodata.json archivo y cárguelo en el noarch subdirectorio del prefijo del canal. Reemplace amzn-s3-demo-bucket con el nombre del bucket.


echo '{"info":{"subdir":"noarch"},"packages":{},"packages.conda":{},"removed":[],"repodata_version":1}' > empty_channel_repodata.json
aws s3api put-object --body empty_channel_repodata.json --key Conda/Default/noarch/repodata.json --bucket amzn-s3-demo-bucket

El /Conda/Default prefijo debe coincidir con el prefijo del canal que utiliza el entorno de colas. Después de inicializar el canal, puede publicar paquetes en el canal utilizando. rattler-build publish

Reindexar un canal

Si el índice del canal está desactualizado, utilícelo rattler-index para reconstruir el índice a partir de los archivos del paquete del canal. Primero, instalerattler-index.


pixi global install rattler-index

A continuación, vuelva a indexar el canal. Reemplace amzn-s3-demo-bucket con el nombre del bucket.


rattler-index s3 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
```
El pixi runcomando activa el entorno conda para el directorio del proyecto y ejecuta el comando especificado en él. El entorno permanece en el directorio del proyecto, por lo que puede utilizar el mismo pixi run comando desde otros terminales.

Eliminar paquetes del canal

Evite eliminar paquetes de los canales que utiliza para la producción, ya que los archivos de bloqueo hacen referencia a paquetes específicos mediante un hash. Al eliminar un paquete, se impide volver a crear entornos a partir de esos archivos de bloqueo. En el caso de los canales de desarrollo y prueba, puedes eliminar un paquete específico si eliminas el .conda archivo del depósito y, a continuación, vuelves a indexar el canal.

Elimine el archivo del paquete y, a continuación, vuelva a indexar el canal. Reemplace amzn-s3-demo-bucket con el nombre del bucket.


aws s3 rm s3://amzn-s3-demo-bucket/Conda/Default/linux-64/blender-4.5.0-hb0f4dca_1.conda

Tras eliminar el archivo, vuelva a indexar el canal para actualizar los metadatos del canal. Para obtener instrucciones, consulte Reindexación de un canal.

Package files se almacenan en subdirectorios específicos de la plataforma, comolinux-64, o. win-64 osx-arm64 Para enumerar los paquetes de un subdirectorio, ejecute el siguiente comando.


aws s3 ls s3://amzn-s3-demo-bucket/Conda/Default/linux-64/

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