Configuración de repositorios de paquetes de Python predeterminados

Los administradores del área de trabajo pueden configurar repositorios de paquetes privados o autenticados dentro de áreas de trabajo como la configuración de pip predeterminada para cuadernos sin servidor, trabajos sin servidor y proceso clásico.

Si un área de trabajo está configurada con un repositorio de paquetes de Python predeterminado, los usuarios del área de trabajo podrán instalar paquetes desde repositorios internos de Python sin definir index-url explícitamente ni extra-index-url valores. Sin embargo, si estos valores se especifican en el código o en un cuaderno, tienen prioridad sobre los valores predeterminados del área de trabajo.

Esta configuración aprovecha secretos de Databricks para almacenar y administrar de forma segura las direcciones URL y las credenciales del repositorio. Los administradores del área de trabajo pueden configurar la configuración mediante la página de configuración del administrador del área de trabajo o mediante un ámbito secreto predefinido y los comandos secretos de la CLI de Databricks o la API REST.

Configuración de dependencias predeterminadas para un área de trabajo

Los administradores del área de trabajo pueden agregar o quitar los repositorios de paquetes de Python predeterminados mediante la página de configuración del administrador del área de trabajo.

1. Como administrador del área de trabajo, inicie sesión en el área de trabajo de Databricks.
2. Haga clic en el nombre de usuario en la barra superior del área de trabajo de Databricks y seleccione Configuración.
3. Haga clic en la pestaña Proceso.
4. Junto a los Repositorios de paquetes predeterminados, haga clic en Administrar.
5. (Opcional) Agregue o quite una dirección URL de índice, direcciones URL de índice adicionales o un certificado SSL personalizado.
6. Haga clic en Guardar para guardar los cambios.

Nota:

Las modificaciones o eliminaciones de secretos se aplican después de volver a asociar el recurso de proceso a cuadernos o volver a ejecutar los trabajos.

Configurar mediante la CLI de secretos o la API de REST

Para configurar repositorios de paquetes de Python predeterminados mediante la CLI o la API REST, cree un ámbito secreto predefinido y configure los permisos de acceso y agregue los secretos del repositorio de paquetes.

Nombre de ámbito de secreto predefinido

Los administradores del área de trabajo pueden establecer direcciones URL de índice pip predeterminadas o direcciones URL de índice adicionales junto con tokens de autenticación y secretos en un ámbito secreto designado en claves predefinidas:

• Nombre del ámbito del secreto: databricks-package-management
• Clave secreta para index-url: pip-index-url
• Clave secreta para direcciones URL de índice extra: pip-extra-index-urls
• Clave secreta para el contenido de la certificación SSL: pip-cert

Crear el ámbito del secreto

Se puede crear un ámbito secreto mediante los comandos de secretos de la CLI de Databricks o la API REST . Después de crear el ámbito de secreto, configure listas de control de acceso para conceder a todos los usuarios del área de trabajo acceso de lectura. Esto garantiza que el repositorio permanece seguro y no se puede modificar por parte de usuarios individuales. El ámbito secreto debe usar el nombre de ámbito de secreto predefinido databricks-package-management.

databricks secrets create-scope databricks-package-management
databricks secrets put-acl databricks-package-management admins MANAGE
databricks secrets put-acl databricks-package-management users READ

Adición de secretos del repositorio de paquetes de Python

Agregue los detalles del repositorio de paquetes de Python mediante los nombres de clave secreta predefinidos, con los tres campos que son opcionales.

# Add index URL.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-index-url", "string_value":"<index-url-value>"}'

# Add extra index URLs. If you have multiple extra index URLs, separate them using white space.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-extra-index-urls", "string_value":"<extra-index-url-1 extra-index-url-2>"}'

# Add cert content. If you want to pip configure a custom SSL certificate, put the cert file content here.
databricks secrets put-secret --json '{"scope": "databricks-package-management", "key": "pip-cert", "string_value":"<cert-content>"}'

Nota:

Si el repositorio requiere un nombre de usuario y una contraseña, use el formato siguiente para index-url: https://<username>:<password>@<index_url>

Modifica o elimina secretos privados del repositorio PyPI

Para modificar los secretos del repositorio pyPI, use el put-secret comando . Para eliminar secretos del repositorio pyPI, use delete-secret como se muestra a continuación:

# delete secret
databricks secrets delete-secret databricks-package-management pip-index-url

databricks secrets delete-secret databricks-package-management pip-extra-index-urls

databricks secrets delete-secret databricks-package-management pip-cert

# delete scope
databricks secrets delete-scope databricks-package-management