Standaardopslagplaatsen voor Python-pakketten configureren

Werkruimtebeheerders kunnen privé- of geverifieerde pakketopslagplaatsen in werkruimten configureren als de standaard pip-configuratie voor serverloze notebooks, serverloze taken en klassieke compute.

Als een werkruimte is geconfigureerd met een standaardopslagplaats voor Python-pakketten, kunnen gebruikers in de werkruimte pakketten installeren vanuit interne Python-opslagplaatsen zonder expliciet te definiëren index-url of extra-index-url waarden. Als deze waarden echter worden opgegeven in code of in een notebook, hebben ze voorrang op de standaardwaarden van de werkruimte.

Deze configuratie maakt gebruik van Databricks-geheimen om url's en referenties van opslagplaatsen veilig op te slaan en te beheren. Werkruimtebeheerders kunnen de installatie configureren met behulp van de pagina met instellingen voor de werkruimtebeheerder of met behulp van een vooraf gedefinieerd geheim bereik en de opdrachten voor Databricks CLI-geheimen of de REST API.

Standaardafhankelijkheden instellen voor een werkruimte

Werkruimtebeheerders kunnen de standaardopslagplaatsen voor Python-pakketten toevoegen of verwijderen met behulp van de pagina met werkruimtebeheerdersinstellingen.

1. Meld u als werkruimtebeheerder aan bij de Databricks-werkruimte.
2. Klik op uw gebruikersnaam in de bovenste balk van de Databricks-werkruimte en selecteer Instellingen.
3. Klik op het tabblad Compute.
4. Naast Standaardpakketopslagplaatsen, klik op Beheren.
5. (Optioneel) Een index-URL, extra index-URL's of een aangepast SSL-certificaat toevoegen of verwijderen.
6. Klik op Opslaan om de wijzigingen op te slaan.

Opmerking

Wijzigingen of verwijderingen in geheimen worden toegepast nadat de rekenbron opnieuw aan notebooks is gekoppeld of nadat de taken opnieuw zijn uitgevoerd.

Instellen met behulp van de geheimen CLI of REST API

Als u standaardopslagplaatsen voor Python-pakketten wilt configureren met behulp van de CLI of REST API, maakt u een vooraf gedefinieerd geheimbereik en configureert u toegangsmachtigingen en voegt u vervolgens de geheimen van de pakketopslagplaats toe.

Vooraf gedefinieerde naam van geheim bereik

Werkruimtebeheerders kunnen standaard pip-index-URL's of extra index-URL's instellen, in combinatie met verificatietokens en geheimen in een aangewezen geheimbereik bij vooraf gedefinieerde sleutels.

• Naam van geheim bereik: databricks-package-management
• Geheime sleutel voor index-URL: pip-index-url
• Geheime sleutel voor extra index-URL's: pip-extra-index-urls
• Geheime sleutel voor SSL-certificeringsinhoud: pip-cert

De geheime scope maken

Een geheim bereik kan worden gemaakt met behulp van de Databricks CLI-geheimenopdrachten of de REST API. Nadat u het geheime bereik hebt gemaakt, configureert u toegangsbeheerlijsten om alle werkruimtegebruikers leestoegang te verlenen. Dit zorgt ervoor dat de opslagplaats veilig blijft en niet kan worden gewijzigd door afzonderlijke gebruikers. Het geheime bereik moet de vooraf gedefinieerde naam van het geheime bereik gebruiken 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

Geheimen voor Python-pakketopslagplaats toevoegen

Voeg de details van de Python-pakketopslagplaats toe met behulp van de vooraf gedefinieerde geheime sleutelnamen, waarbij alle drie de velden optioneel zijn.

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

Opmerking

Als uw opslagplaats een gebruikersnaam en wachtwoord vereist, gebruikt u de volgende indeling voor de index-URL: https://<username>:<password>@<index_url>

Persoonlijke PyPI-opslagplaatsgeheimen wijzigen of verwijderen

Gebruik de put-secret opdracht om geheimen van pyPI-opslagplaatsen te wijzigen. Als u geheimen van pyPI-opslagplaatsen wilt verwijderen, gebruikt u delete-secret zoals hieronder wordt weergegeven:

# 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