Rozwiązywanie problemów z Artifact Registry

Użyj tej strony, aby rozwiązać typowe problemy z Rejestrem Artefaktów. Pełny proces konfiguracji i przesyłania obrazów znajdziesz w artykule Jak zacząć z rejestrem artefaktów.

Problemy z dostępem do beta

Rejestr artefaktów nie jest włączony

Poproś administratora przestrzeni roboczej o włączenie rejestru artefaktów Databricks na stronie podglądów przestrzeni roboczej. Jeśli podgląd nie jest dostępny, sprawdź, czy przestrzeń robocza znajduje się w regionie obsługującym Rejestr Artefaktów. Zobacz Ograniczenia.

Status podglądu jest tymczasowo niedostępny

Spróbuj ponownie wykonać operację. Jeśli błąd nadal występuje, przygotuj szczegóły błędu oraz identyfikator żądania, jeśli jest dostępny, podczas zgłaszania prośby o pomoc.

Problemy z uwierzytelnianiem dockerów

Polecenie uwierzytelniania Dockera jest niedostępne

Zainstaluj lub zaktualizuj Databricks CLI (interfejs wiersza poleceń) do minimalnej obsługiwanej wersji w Wymagania, a następnie uruchom databricks auth docker configure ponownie.

Docker nie może uzyskać danych uwierzytelniających do rejestru

Utwórz lub odśwież profil OAuth w przestrzeni roboczej, skonfiguruj Docker dla rejestru przestrzeni roboczej i spróbuj ponownie uruchomić operację Docker. Uruchom następujące polecenia:

databricks auth login --profile <profile>
databricks auth docker configure --profile <profile>

Sprawdź, czy wskazuje <profile> na docelową przestrzeń pracy. Jeśli używasz domyślnego profilu, pomiń --profile <profile> w poleceniu uwierzytelniania Dockera.

Pomocnik poświadczeń Docker nie obsługuje profili wykorzystujących osobistych tokenów dostępu, uwierzytelnień OAuth machine-to-machine (M2M) ani uwierzytelniania wyłącznie dla konta. Pełne kroki uwierzytelniania można znaleźć w artykule Ustaw uwierzytelnianie Docker.

Długotrwałe wypychanie powoduje błąd autoryzacji

Pomocnik do uwierzytelniania Docker dostarcza krótkotrwały token dostępu OAuth do przestrzeni roboczej. Jeśli długo trwające wypychanie zwróci błąd autoryzacji, ponów próbę docker push, aby pomocnik poświadczeń zażądał nowego tokenu. O czasie trwania uprawnień zobacz Ograniczenia.

Nazwa hosta rejestru nie pasuje do siebie

Uruchom databricks auth docker host --profile <profile>, aby sprawdzić nazwę hosta rejestru i stan pomocnika poświadczeń Dockera dla wybranego profilu. Sprawdź, czy profil wskazuje na zamierzoną przestrzeń roboczą. Oznacz obraz poprawną nazwą hosta rejestru , zanim spróbujesz ponownie push.

Problemy z wypychaniem obrazu

Push zwraca błąd uprawnień

Sprawdź, czy główny podmiot posiada uprawnienia wymagane do operacji push. Zobacz sekcję Nadawanie uprawnień.

Nazwa obrazu zostaje odrzucona

Użyj formatu <registry-hostname>/<catalog>.<schema>.<artifact>:<tag>. Aby uzyskać wymagania dotyczące segmentu artefaktu, zobacz wymagania dotyczące nazwy artefaktu.

Katalog lub schemat nie istnieje

Rejestr Artefaktów nie tworzy katalogów ani schematów. Docelowy katalog i schemat muszą już istnieć w Unity Catalog i być dostępne z przestrzeni roboczej. Stwórz brakujący obiekt lub użyj istniejącego katalogu i schematu, a następnie sprawdź wymagane uprawnienia przed ponowną próbą push.

Problemy z wykrywaniem obrazów

Obraz lub wersja nie pojawia się

Potwierdź, że polecenie `docker push` zakończyło się pomyślnie oraz że podajesz ten sam katalog, schemat i nazwę artefaktu, które zostały przesłane. Użyj interfejsu Software Artifacts API zamiast punktu końcowego rejestru, aby wyświetlić listę artefaktów i wersji. Zobacz obrazy i wersje produktu Discover.

Operacja rejestru nie jest obsługiwana

Endpoint rejestru nie obsługuje tej operacji. Użyj API Software Artifacts, aby odkrywać obrazy i wersje. O ograniczeniach zobacz Ograniczenia.

Problemy z przyspieszaniem obrazu

Przyspieszenie obrazu pozostaje UNSPECIFIED

UNSPECIFIED nie identyfikuje awarii. Zobacz Ograniczenia dotyczące uprawnień do przyspieszania obrazu, w tym limit rozmiaru obrazu. Konwersja większych obrazów spełniających wymagania trwa dłużej. Sprawdź status jeszcze raz później. Jeśli kwalifikujący się obraz nie dotrze SUCCESS po kilku godzinach, skontaktuj się z pomocą techniczną Databricks. Definicje statusu można znaleźć w sekcji Sprawdź status przyspieszenia obrazu.

Szukaj pomocy

Gdy prosisz o pomoc, podaj następujące informacje:

• Chmura, region, adres URL obszaru roboczego oraz wersja interfejsu wiersza polecenia Databricks.
• Polecenie, które zawiodło, i jego pełny komunikat o błędzie.
• Nazwa hosta rejestru i nazwa catalog.schema.artifact:tag.
• Skrót obrazu, identyfikator żądania API oraz znacznik czasu operacji, jeśli jest dostępny.

Udostępniaj te informacje wyłącznie za pośrednictwem prywatnego kanału wsparcia. Nie publikuj adresów URL przestrzeni roboczych, nazw hostów w rejestrze, nazw artefaktów ani nie wprowadzaj całkowitych błędów na publicznych forach.

Usuń tokeny, hasła i poświadczenia do rejestru z komunikatów o błędach, danych wyjściowych poleceń i innych danych diagnostycznych przed ich udostępnieniem.