Configurer les référentiels de package Python par défaut

Les administrateurs d’espace de travail peuvent configurer des dépôts de paquets privés ou authentifiés au sein des espaces de travail en tant que configuration pip par défaut pour les notebooks sans serveur, les travaux sans serveur et le calcul traditionnel.

Si un espace de travail est configuré avec un dépôt de packages Python par défaut, les utilisateurs de l’espace de travail pourront installer des packages à partir de référentiels Python internes sans définir explicitement les valeurs index-url ou extra-index-url. Toutefois, si ces valeurs sont spécifiées dans le code ou dans un bloc-notes, elles sont prioritaires sur les valeurs par défaut de l’espace de travail.

Cette configuration utilise les secrets Databricks pour stocker et gérer en toute sécurité les URLs et les identifiants du référentiel. Les administrateurs d’espace de travail peuvent configurer la configuration à l’aide de la page des paramètres d’administration de l’espace de travail ou à l’aide d’une étendue secrète prédéfinie et des commandes de secrets CLI Databricks ou de l’API REST.

Configurer les dépendances par défaut pour un espace de travail

Les administrateurs d’espace de travail peuvent ajouter ou supprimer les référentiels de package Python par défaut à l’aide de la page des paramètres d’administration de l’espace de travail.

1. En tant qu’administrateur d’espace de travail, connectez-vous à l’espace de travail Databricks.
2. Cliquez sur votre nom d’utilisateur dans la barre supérieure de l’espace de travail Databricks, puis sélectionnez Paramètres.
3. Cliquez sur l’onglet Calcul.
4. À côté de Dépôts de paquets par défaut, cliquez sur Gérer.
5. (Facultatif) Ajoutez ou supprimez une URL d’index, des URL d’index supplémentaires ou un certificat SSL personnalisé.
6. Cliquez sur Enregistrer pour enregistrer les modifications.

Configurer à l’aide de l’interface CLI secrète ou de l’API REST

Pour configurer les référentiels de packages Python par défaut à l’aide de l’interface CLI ou de l’API REST, créez une étendue de secret prédéfinie et configurez les autorisations d’accès, puis ajoutez les secrets du dépôt de package.

Nom de l’étendue du secret prédéfini

Les administrateurs d’espace de travail peuvent définir des URL d’index pip par défaut ou des URL d’index supplémentaires, ainsi que des jetons d’authentification et des secrets dans une étendue de secret désignée sous des clés prédéfinies :

• Nom de l’étendue de secrets : databricks-package-management
• Clé secrète pour index-URL : pip-index-url
• Clé secrète pour les URL extra-index : pip-extra-index-urls
• Clé secrète pour le contenu de certification SSL : pip-cert

Créer l’étendue du secret

Une zone secrète peut être créée à l'aide de la CLI Databricks commandes secrets ou de l'API REST . Après avoir créé l’étendue du secret, configurez les listes de contrôle d’accès pour accorder à tous les utilisateurs de l’espace de travail un accès en lecture. Cela garantit que le référentiel reste sécurisé et ne peut pas être modifié par des utilisateurs individuels. L’étendue du secret doit utiliser le nom d’étendue du secret prédéfini 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

Ajouter les secrets du référentiel de package Python

Ajoutez les détails du référentiel de package Python à l’aide des noms de clés secrètes prédéfinis, avec les trois champs facultatifs.

# 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>"}'

Modifier ou supprimer des secrets de référentiel PyPI privés

Pour modifier les secrets du référentiel PyPI, utilisez la put-secret commande. Pour supprimer les secrets du référentiel PyPI, utilisez delete-secret comme indiqué ci-dessous :

# 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