Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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 los paquetes de conda en su estación de trabajo mediante un canal de sistema de archivos local. Este enfoque le permite repetir 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 instrucciones siguientes utilizan la receta de ejemplo Blender 4.5 del repositorio de muestras de Deadline Cloud del
Requisitos previos
Antes de empezar, instale las siguientes herramientas en su estación de trabajo:
-
pixi: un administrador de paquetes que se usa para instalar
rattler-buildy probar paquetes. Para obtener instrucciones de instalación, consulta pixi.shen el sitio web de Pixi. -
rattler-build: la herramienta de creación de paquetes utilizada por Deadline Cloud conda recipes. Después de instalar pixi, ejecuta el siguiente comando para instalarlo.
rattler-buildpixi global install rattler-build -
git: necesario para clonar el repositorio de muestras. AdemásWindows, Git for Windows
on del sitio web de Git para Windows también incluye una bashconsola, que es necesaria en algunas de las recetas de Windows ejemplo.
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.
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 salida de compilación. Asegúrese de usar un disco con suficiente espacio disponible para la salida de compilación del paquete.
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.
En Linux ymacOS, ejecute el siguiente comando.
rattler-build publish blender-4.5/recipe/recipe.yaml \ --to file://$HOME/my-conda-channel \ --build-number=+1En Windows (cmd), ejecute el siguiente comando.
rattler-build publish blender-4.5/recipe/recipe.yaml ^ --to file://%USERPROFILE%/my-conda-channel ^ --build-number=+1El
rattler-build publishcomando realiza las siguientes acciones:-
Crea 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 encontrar el paquete.
Si la receta de su paquete depende de los paquetes de un canal en particular, como conda-forge
en el sitio web de conda-forge, añádala al comando. -c conda-forge -
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. Compila siempre con un nuevo número de compilación si, de lo contrario, el paquete tendría el mismo nombre de archivo. Con el uso se --build-number=+1 consigue creando un canal de producción o un canal de ensayo 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 omites la opción, rattler-build usa el número de compilación definido en el recipe.yaml archivo.
Para obtener más información al respectorattler-build publish, consulta la documentación de publicación de
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 la consola 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 Cómo depurar compilaciones
Probando el paquete
Después de crear y publicar el paquete, crea un proyecto pixi temporal. Usa el proyecto para instalar el paquete desde el canal local y comprobar que funciona correctamente.
Para probar el paquete
-
Crea un directorio de prueba temporal e inicializa un proyecto pixi con el canal local.
En Linux ymacOS, ejecuta los siguientes comandos.
mkdir package-test-env cd package-test-env pixi init --channel file://$HOME/my-conda-channelEn Windows (cmd), ejecute los siguientes comandos.
mkdir package-test-env cd package-test-env pixi init --channel file://%USERPROFILE%/my-conda-channel -
Agregue el paquete al proyecto.
pixi add blender=4.5 -
Compruebe que el paquete funciona correctamente.
pixi run blender --versionEl
pixi runcomando activa el entorno de conda para el directorio del proyecto y ejecuta el comando especificado dentro de él. El entorno permanece en el directorio del proyecto, por lo que puede usar el mismopixi runcomando desde otros terminales. Para obtener más información, consulta elpixi runcomandoen el sitio web de Pixi.
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.
Eliminar paquetes del canal
Evita eliminar paquetes de los canales que utilizas para la producción, ya que los archivos de bloqueo hacen referencia a paquetes específicos mediante un hash. Al eliminar un paquete, se evita volver a crear entornos a partir de esos archivos de bloqueo. En el caso de los canales de desarrollo y prueba, puede eliminar un paquete específico eliminando el .conda archivo del directorio del canal y, a continuación, volviendo a indexar el canal. Primero, instálalo. rattler-index
pixi global install rattler-index
A continuación, borre el archivo del paquete y vuelva a indexar el canal.
A Linux continuaciónmacOS, ejecute los siguientes comandos.
rm $HOME/my-conda-channel/linux-64/blender-4.5.0-hb0f4dca_1.conda rattler-index fs $HOME/my-conda-channel
En Windows (cmd), ejecute los siguientes comandos.
del %USERPROFILE%\my-conda-channel\win-64\blender-4.5.0-hb0f4dca_1.conda rattler-index fs %USERPROFILE%\my-conda-channel
Los archivos de paquetes se almacenan en subdirectorios específicos de la plataforma, como, o. linux-64 win-64 osx-arm64 Enumere el contenido de estos subdirectorios para encontrar el nombre de archivo exacto del paquete que desea eliminar.
Limpieza
Tras 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.
En Linux ymacOS, ejecute el siguiente comando.
rm -rf package-test-envEn Windows (cmd), ejecute el siguiente comando.
rmdir /s /q package-test-env -
Elimine el directorio local de canales de conda.
En Linux ymacOS, ejecute el siguiente comando.
rm -rf $HOME/my-conda-channelEn Windows (cmd), ejecute el siguiente comando.
rmdir /s /q %USERPROFILE%\my-conda-channel -
(Opcional) Elimine el directorio
rattler-buildde salida que contiene el archivo del paquete creado.En Linux ymacOS, ejecute el siguiente comando.
rm -rf deadline-cloud-samples/conda_recipes/outputEn Windows (cmd), ejecute el siguiente comando.
rmdir /s /q deadline-cloud-samples\conda_recipes\output
Para ver los complementos compatibles con ejemplos de sincronización de complementos, consulteSincronice los complementos con los trabajadores de Deadline Cloud.
