Zacznij z Rejestrem Artefaktów

Ważna

Ta funkcja jest dostępna w wersji beta. Aby z niego korzystać, administrator przestrzeni roboczej musi włączyć Databricks Artifact Registry na stronie Podglądów . Zobacz Zarządzanie wersjami zapoznawczami usługi Azure Databricks. Databricks ogłosi ceny Rejestru Artefaktów, gdy stanie się on powszechnie dostępny.

Użyj Artifact Registry, aby przesyłać obrazy kontenerów w Dockerze i zarządzać nimi w Unity Catalog.

Ta strona pokazuje, jak skonfigurować uwierzytelnianie, przyznać dostęp, wypchnąć obraz i go odkryć. W przypadku koncepcji i ograniczeń zobacz Rejestr Artefaktów. Jeśli polecenie lub operacja nie powiedzie się, zobacz Rozwiązywanie problemów z Artifact Registry.

Requirements

Przed rozpoczęciem musisz mieć następujące elementy:

Przestrzeń robocza w regionie obsługującym Rejestr Artefaktów. Zobacz Ograniczenia.
Databricks CLI (interfejs wiersza poleceń) w wersji 1.18.0 lub nowszej zainstalowany na twoim lokalnym komputerze.
Docker CLI zainstalowany na twoim lokalnym komputerze.
Istniejący katalog i schemat w Unity Catalog, dostępne z poziomu obszaru roboczego.
Uprawnienia katalogu Unity dla twojej operacji.

Ustaw uwierzytelnianie Docker

Databricks CLI zawiera eksperymentalne polecenie, które konfiguruje Dockera do żądania poświadczeń do rejestru przestrzeni roboczej. Pomocnik poświadczenia Docker wymaga profilu OAuth w przestrzeni roboczej utworzonego przez databricks auth login. Nie obsługuje profili wykorzystujących osobistych tokenów dostępu, uwierzytelnień OAuth machine-to-machine (M2M) ani uwierzytelniania wyłącznie konta.

Stwórz lub odśwież profil dla docelowej przestrzeni roboczej:
```
databricks auth login --profile <profile>
```
Konfiguruj uwierzytelnianie Dockera dla rejestru przestrzeni roboczej:
```
databricks auth docker configure --profile <profile>
```
Pomiń --profile <profile>, aby użyć domyślnego profilu interfejsu wiersza polecenia Databricks.

Databricks CLI określa region rejestru i wyświetla nazwę hosta rejestru obszaru roboczego. Używaj tej nazwy hosta, gdy wysyłasz obraz.

Udzielenie zezwoleń

Rejestr Artefaktów nie tworzy katalogu ani schematu. Oba muszą już istnieć w Unity Catalog i być dostępne z poziomu obszaru roboczego.

Rejestr artefaktów korzysta z uprawnień katalogu Unity do kontrolowania dostępu do obrazów. Poniższa tabela przedstawia uprawnienia o najmniejszym wymaganym zakresie dla każdej operacji. Szersze uprawnienia do zarządzania mogą również autoryzować niektóre operacje.

Działanie	Nadawanie najmniejszych uprawnień
Przepchnij nowy artefakt	`USE CATALOG`, `USE SCHEMA`i `CREATE VOLUME`
Wypchnij nową wersję lub przenieś tag	`USE CATALOG`, `USE SCHEMA`i `WRITE VOLUME`
Odkryj artefakty i wersje	`USE CATALOG`, `USE SCHEMA`i `READ METADATA`
Użyj obrazu w obsługiwanym obciążeniu roboczym	`USE CATALOG`, `USE SCHEMA`i `READ VOLUME`

Dla schematu dedykowanego Rejestrowi Artefaktów administrator może przyznać uprawnienia na poziomie schematu. Uprawnienia na poziomie schematu dotyczą każdego dopasowanego obiektu w schemie, w tym obiektów utworzonych później. Używaj oddzielnych schematów dla wydawców, którzy nie powinni mieć możliwości modyfikowania artefaktów innych wydawców. Każdemu zleceniodawcy przyznaj jedynie przywileje niezbędne do jego działalności. Zastąp przykładowe wartości i usuń niepotrzebne polecenia dotyczące uprawnień przed uruchomieniem następujących instrukcji:

GRANT USE CATALOG ON CATALOG <catalog> TO `<principal>`;
GRANT USE SCHEMA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT CREATE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT WRITE VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ METADATA ON SCHEMA <catalog>.<schema> TO `<principal>`;
GRANT READ VOLUME ON SCHEMA <catalog>.<schema> TO `<principal>`;

Szczegóły dotyczące CREATE VOLUME, WRITE VOLUME, READ METADATA i READ VOLUME można znaleźć w dokumencie informacje o uprawnieniach Unity Catalog. Aby poznać inne metody nadawania uprawnień, zobacz Wyświetlanie, nadawanie i cofanie uprawnień.

Przesuń obraz

Użyj nazwy hosta rejestru obszaru roboczego wraz z nazwą obrazu catalog.schema.artifact:tag.

Pobierz nazwę hosta rejestru

Użyj nazwy hosta rejestru wyświetlonej przez databricks auth docker configure. Aby później znaleźć nazwę hosta profilu i sprawdzić, czy pomocnik poświadczenia Docker jest skonfigurowany, uruchom następująco:

databricks auth docker host --profile <profile>

Jeśli musisz ręcznie utworzyć nazwę hosta, użyj numerycznego identyfikatora obszaru roboczego i regionu obszaru roboczego. Aby znaleźć identyfikator workspace, zobacz nazwy instancji, adresy URL i identyfikatory Workspace.

Aby znaleźć obszar workspace, otwórz przełącznik workspace w górnym pasku nawigacyjnym. Region pojawia się pod nazwą przestrzeni roboczej. Można go również znaleźć w konsoli konta w obszarze Obszary robocze.

Użyj następującej nazwy hosta:

<workspace-id>.container.<region>.azuredatabricks.net

Wymagania dotyczące nazwy artefaktów

Ważna

Nazwy artefaktów muszą być w pełni kwalifikowanymi nazwami Unity Catalog w formacie <catalog>.<schema>.<artifact>. Nie używaj ukośników w nazwie. Zobacz hierarchię obiektów w katalogu Unity.

Segment może <artifact> zawierać do 255 znaków. Używaj tylko małych liter, cyfr, podkreśleń i łączników. Musi się zaczynać i kończyć na literze lub cyfry. Używaj nie więcej niż dwóch kolejnych podkreśleń i nie umieszczaj podkreślenia obok łącznika.

Oznacz i przepchnij obraz

Warning

Nie umieszczaj w obrazie danych uwierzytelniających ani innych wrażliwych danych. Sprawdź obraz, zanim go nacisniesz. Wersje artefaktów są niezmienne, a żądania usunięcia nie są obsługiwane. Jeśli prześlesz dane wrażliwe, natychmiast je zmień lub unieważnij i poproś administratora o ograniczenie wszelkich READ VOLUME uprawnień, które dotyczą artefaktu objętego problemem. Przestań używać tego skrótu oraz wszystkich tagów, które na niego wskazują, a następnie zapoznaj się z informacjami, które należy podać podczas proszenia o pomoc.

Oznacz lokalny obraz dla Rejestru Artefaktów:

docker tag <local-image>:<local-tag> \
  <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>

Przesuń obraz:

docker push <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>

Odkryj obrazy i wersje

Użyj interfejsu Software Artifacts API do wyświetlenia artefaktów w katalogu i w schemacie, a następnie do wyświetlenia wersji artefaktu.

Note

Dedykowane polecenia Databricks CLI do wyświetlania i zarządzania obrazami Rejestru Artefaktów nie są dostępne. Używaj databricks api do wywoływania API Software Artifacts.

Poniższe przykłady wykorzystują profil, który skonfigurowałeś do uwierzytelniania Docker. Pomiń --profile <profile>, jeśli jest to twój domyślny profil Databricks CLI.

Lista artefaktów

Aby wypisać artefakty, wykonaj następujące polecenie:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts?parent=schemas/<catalog>.<schema>"

Odpowiedź zawiera nazwę artefaktu i właściciela. Jeśli odpowiedź zawiera next_page_token, przekaż jej wartość w parametrze zapytania, page_token aby pobrać następną stronę, na przykład &page_token=<next_page_token>.

Lista wersji

Aby wypisać wersje artefaktu, wykonaj następujące polecenie:

databricks api get --profile <profile> \
  "/api/2.1/unity-catalog/software-artifacts/<catalog>.<schema>.<artifact>/versions"

Odpowiedź zawiera skrót obrazu, tagi oraz image_acceleration_details.status dla każdej wersji. Dla limitów odpowiedzi zobacz Ograniczenia.

Sprawdź status przyspieszenia obrazu

Odczytaj image_acceleration_details.status z odpowiedzi wersji artefaktu:

Status	Meaning
`SUCCESS`	Przyspieszenie obrazu zakończyło się pomyślnie.
`UNSPECIFIED`	Nie odnotowano żadnego udanego wyniku przyspieszania obrazu. Ten status nie oznacza awarii.

Używaj obrazów w obsługiwanych obciążeniach Azure Databricks

Po wysłaniu obrazu do Artifact Registry odwołaj się do niego podczas tworzenia obsługiwanego obciążenia roboczego Azure Databricks.

Aby użyć obrazu Docker w obciążeniu AI Runtime, zobacz Używanie niestandardowych obrazów Docker z AI Runtime.

Dodatkowe zasoby

Opinia

Czy ta strona była pomocna?

Ostatnia aktualizacja o 2026-10-06