Konfigurowanie domyślnych repozytoriów pakietów języka Python

Administratorzy obszaru roboczego mogą konfigurować prywatne lub uwierzytelnione repozytoria pakietów jako domyślną konfigurację pip dla notesów bezserwerowych, zadań bezserwerowych i klasycznych obliczeń w ramach obszarów roboczych.

Jeśli obszar roboczy jest skonfigurowany z domyślnym repozytorium pakietu języka Python, użytkownicy w obszarze roboczym będą mogli instalować pakiety z wewnętrznych repozytoriów języka Python bez jawnego definiowania index-url lub extra-index-url wartości. Jeśli jednak te wartości są określone w kodzie lub w notesie, mają pierwszeństwo przed domyślnymi ustawieniami obszaru roboczego.

Ta konfiguracja korzysta z tajemnic Databricks dla bezpiecznego przechowywania i zarządzania adresami URL oraz poświadczeniami repozytorium. Administratorzy obszaru roboczego mogą skonfigurować konfigurację przy użyciu strony ustawień administratora obszaru roboczego lub przy użyciu wstępnie zdefiniowanego zakresu wpisu tajnego oraz poleceń wpisów tajnych interfejsu wiersza polecenia usługi Databricks lub interfejsu API REST.

Konfigurowanie domyślnych zależności dla obszaru roboczego

Administratorzy obszaru roboczego mogą dodawać lub usuwać domyślne repozytoria pakietów języka Python przy użyciu strony ustawień administratora obszaru roboczego.

1. Jako administrator obszaru roboczego zaloguj się do obszaru roboczego usługi Databricks.
2. Kliknij swoją nazwę użytkownika na górnym pasku obszaru roboczego usługi Databricks i wybierz pozycję Ustawienia.
3. Kliknij kartę Compute.
4. Obok Domyślne Repozytoria Pakietów, kliknij Zarządzaj.
5. (Opcjonalnie) Dodaj lub usuń adres URL indeksu, dodatkowe adresy URL indeksu lub niestandardowy certyfikat SSL.
6. Kliknij przycisk Zapisz, aby zapisać zmiany.

Uwaga / Notatka

Modyfikacje lub usunięcia wpisów tajnych są stosowane po ponownym dołączeniu zasobu obliczeniowego do notesów lub ponownym uruchomieniu zadań.

Konfigurowanie przy użyciu CLI do zarządzania tajemnicami lub REST API

Aby skonfigurować domyślne repozytoria pakietów języka Python przy użyciu interfejsu wiersza polecenia lub interfejsu API REST, utwórz wstępnie zdefiniowany zakres wpisów tajnych i skonfiguruj uprawnienia dostępu, a następnie dodaj wpisy tajne repozytorium pakietów.

Wstępnie zdefiniowana nazwa tajnego zakresu

Administratorzy obszaru roboczego mogą ustawić domyślne adresy URL indeksu pip lub dodatkowe adresy URL indeksu, wraz z tokenami uwierzytelniania i hasłami, w wyznaczonym zakresie tajemnicy pod wcześniej zdefiniowanymi kluczami.

• Nazwa tajnego zakresu: databricks-package-management
• Klucz tajny dla adresu URL indeksu: pip-index-url
• Klucz tajny dla dodatkowych adresów URL indeksu: pip-extra-index-urls
• Klucz tajny zawartości certyfikacji SSL: pip-cert

Utwórz zakres tajny

Zakres tajny można utworzyć przy użyciu poleceń wpisów tajnych interfejsu wiersza polecenia Databricks lub interfejsu API REST. Po utworzeniu zakresu tajnego skonfiguruj listy kontroli dostępu, aby przyznać wszystkim użytkownikom obszaru roboczego uprawnienia dostępu do odczytu. Gwarantuje to, że repozytorium pozostaje bezpieczne i nie może zostać zmienione przez poszczególnych użytkowników. Zakres tajny musi używać wstępnie zdefiniowanej nazwy zakresu tajnego o nazwie 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

Dodaj tajne dane repozytorium pakietów Python

Dodaj szczegóły repozytorium pakietów języka Python przy użyciu wstępnie zdefiniowanych nazw kluczy tajnych, a wszystkie trzy pola są opcjonalne.

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

Uwaga / Notatka

Jeśli repozytorium wymaga nazwy użytkownika i hasła, użyj następującego formatu dla adresu URL indeksu: https://<username>:<password>@<index_url>

Modyfikowanie lub usuwanie sekretów prywatnego repozytorium PyPI

Aby zmodyfikować sekrety repozytorium PyPI, użyj put-secret polecenia. Aby usunąć tajne dane repozytorium PyPI, użyj delete-secret, jak pokazano poniżej:

# 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