Personalización de plantillas de entorno

Puede cambiar el nombre, la descripción y la configuración de hardware de una plantilla de entorno que ha creado. Puede personalizar la configuración de software de las plantillas de entorno de un cuaderno Jupyter a través de canales de conda o utilizando pip. Puede proporcionar una lista de paquetes conda, una lista de paquetes pip o una combinación de ambos. Al utilizar paquetes conda, puede proporcionar una lista de ubicaciones de canal conda adicionales a través de las cuales se pueden obtener los paquetes.

Permisos necesarios

Debe tener el rol Admin o Editor en el proyecto para personalizar una plantilla de entorno.

Restricciones

No puede cambiar el idioma de una plantilla de entorno existente.

No puede personalizar la configuración de software de una plantilla de entorno Spark que ha creado.

Para personalizar una plantilla de entorno que ha creado:

1. En la pestaña Gestionar del proyecto, pulse la página Entornos.

2. En la sección Tiempos de ejecución activos, compruebe que no hay ningún tiempo de ejecución activo para la plantilla de entorno que desea cambiar.

3. En la sección Plantillas de entorno, pulse la plantilla de entorno que desea personalizar.

4. Efectúe los cambios.

   Para una plantilla de entorno de cuaderno Jupyter, seleccione la creación de una personalización y especifique las bibliotecas que se han de añadir a los paquetes estándar que están disponibles de forma predeterminada. También puede utilizar la personalización para actualizar o degradar los paquetes que forman parte de la configuración de software estándar.

   Las bibliotecas que se añaden a una plantilla de entorno mediante la personalización no persisten; no obstante, se instalan automáticamente cada vez que se inicia el tiempo de ejecución del entorno. Tenga en cuenta que si añade una biblioteca utilizando pip install a través de una celda del cuaderno y no a través de la personalización, solo podrá utilizar esta biblioteca. La biblioteca no está disponible para cualquier otro usuario que utilice la plantilla de entorno.

   Si lo desea puede utilizar la plantilla proporcionada para añadir bibliotecas personalizadas. Hay una plantilla diferente para Python y para R. El siguiente ejemplo muestra cómo añadir paquetes de Python:

   # Modify the following content to add a software customization to an environment.
   # To remove an existing customization, delete the entire content and click Apply.
   
   # Add conda channels below defaults, indented by two spaces and a hyphen.
   channels:
    - defaults
   
   # To add packages through conda or pip, remove the comment on the following line.
   # dependencies:
   
   # Add conda packages here, indented by two spaces and a hyphen.
   # Remove the comment on the following line and replace sample package name with your package name:
   #  - a_conda_package=1.0
   
   # Add pip packages here, indented by four spaces and a hyphen.
   # Remove the comments on the following lines  and replace sample package name with your package name.
   #  - pip:
   #    - a_pip_package==1.0
   

   Importante durante la personalización:

   • Antes de personalizar un paquete, verifique que los cambios que está planificando tengan el efecto previsto.
     • conda puede notificar los cambios necesarios para instalar un paquete específico. Puede verificar los cambios desde su cuaderno. Por ejemplo, para la biblioteca Plotly:
       • En un cuaderno Python, especifique: !conda install --dry-run plotly
       • En un cuaderno R, escriba: print(system2("conda", args=c("install","--dry-run","r-plotly"), stdout=TRUE))
     • pip instala el paquete. No obstante, cuando se vuelve a reiniciar el tiempo de ejecución después de la verificación se eliminará el paquete. Aquí también verifica los cambios desde su cuaderno. Por ejemplo, para la biblioteca Plotly:
       • En un cuaderno Python, especifique: !pip install plotly
       • En un cuaderno R, escriba: print(system2("pip", args="install plotly", stdout=TRUE))
   • Si puede obtener un paquete a través de conda desde los canales predeterminados y a través de pip desde PyPI, el método preferido es a través de conda desde los canales predeterminados.
   • Conda realiza una comprobación de dependencias al instalar paquetes que puede utilizar mucha memoria si añade muchos paquetes a la personalización. Asegúrese de que selecciona un entorno con suficiente RAM para habilitar la comprobación de dependencias en el momento en que se inicia el tiempo de ejecución.
   • Para evitar una comprobación de dependencias innecesaria si solo desea paquetes de un canal Conda, excluya los canales predeterminados eliminando defaults de la lista de canales de la plantilla y añadiendo nodefaults.
   • Además del canal principal de Anaconda, se pueden encontrar muchos paquetes para R en el canal R de Anaconda. En entornos R, este canal ya forma parte de los canales predeterminados, por lo que no es necesario añadirlo por separado.
   • Si añade paquetes sólo a través de pip o sólo a través de conda a la plantilla de personalización, debe asegurarse de que dependencies no esté comentado en la plantilla.
   • Cuando especifique una versión de paquete, utilice un único = para paquetes conda y == para paquetes pip. Siempre que sea posible, especifique un número de versión, ya que reducirá significativamente el tiempo de instalación y el consumo de memoria. Si no especifica una versión, es posible que el gestor de paquetes seleccione la versión más reciente disponible o conserve la versión que está disponible en el paquete.
   • No puede añadir extensiones arbitrarias del cuaderno como una personalización ya que las extensiones del cuaderno deben estar preinstaladas.

5. Aplique sus cambios.