Začněte s Artifact Registry

Important

Tato funkce je v beta verzi. Pro jeho použití musí správce pracovního prostoru zapnout Databricks Artifact Registry na stránce Náhledy . Viz Manage Azure Databricks preview. Databricks oznámí ceny pro Artifact Registry, jakmile bude obecně dostupný.

Použijte Artifact Registry k posílání kontejnerových obrazů pomocí Dockeru a jejich správě v Unity Catalog.

Tato stránka vám ukáže, jak nastavit autentizaci, udělit přístup, poslat obrázek a objevit ho. Pro koncepty a omezení viz Registr artefaktů. Pokud příkaz nebo operace selže, viz Troubleshoot Artifact Registry.

Requirements

Než začnete, musíte mít:

Pracovní prostor v regionu, který podporuje Artifact Registry. Viz Omezení.
Databricks CLI (příkazové rozhraní) verze 1.18.0 nebo vyšší je nainstalovaná na vašem lokálním počítači.
Docker CLI nainstalovaný na vašem lokálním počítači.
Existující katalog a schéma Unity Catalog, které jsou přístupné z pracovního prostoru.
Výsady Unity Catalogu pro vaši operaci.

Nastavte Docker autentizaci

Databricks CLI obsahuje experimentální příkaz, který konfiguruje Docker tak, aby požadoval přihlašovací údaje pro registr pracovního prostoru. Pomocník pro přihlašovací údaje Dockeru vyžaduje profil OAuth pracovního prostoru vytvořený pomocí databricks auth login. Nepodporuje profily využívající osobní přístupové tokeny, přihlašovací údaje OAuth machine-to-machine (M2M) ani autentizaci pouze na základě účtu.

Vytvořte nebo obnovte profil pro cílový pracovní prostor:
```
databricks auth login --profile <profile>
```
Konfigurujte Docker autentizaci pro registr pracovního prostoru:
```
databricks auth docker configure --profile <profile>
```
Vynechte --profile <profile>, chcete-li použít svůj výchozí profil Databricks CLI.

Databricks CLI odvodí oblast registru a vytiskne název hostitele pracovního prostoru. Použijte toto jméno hostitele, když pushujete obrázek.

Udělit povolení

Archiv artefaktů katalog ani schéma nevytváře. Oba musí již existovat v Unity Catalog a být přístupné z pracovního prostoru.

Artifact Registry používá privilegia Unity Catalog k řízení přístupu k obrázkům. Následující tabulka ukazuje granty s nejmenším privilegiem pro každou operaci. Širší manažerská oprávnění mohou také povolit některé operace.

Operation	Granty s nejmenším privilegiem
Odeslat nový artefakt	`USE CATALOG`, `USE SCHEMA` a `CREATE VOLUME`
Nahrajte novou verzi nebo přesuňte značku	`USE CATALOG`, `USE SCHEMA` a `WRITE VOLUME`
Prozkoumejte artefakty a verze	`USE CATALOG`, `USE SCHEMA` a `READ METADATA`
Použijte obrázek v podporované zátěži	`USE CATALOG`, `USE SCHEMA` a `READ VOLUME`

U schématu věnovaného Artifact Registry může administrátor udělit oprávnění na úrovni schématu. Na každý odpovídající objekt ve schématu, včetně objektů vytvořených později, platí práva na úrovni schématu. Používejte samostatná schémata pro vydavatele, kteří by neměli být schopni upravovat artefakty ostatních. Každému principálovi udělte pouze oprávnění potřebná pro jeho provoz. Před spuštěním následujících příkazů nahraďte příkladové hodnoty a odstraňte zbytečné příkazy oprávnění:

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>`;

Podrobnosti o READ VOLUME, , READ METADATA a WRITE VOLUME naleznete v CREATE VOLUME. Další způsoby udělování oprávnění najdete v části Zobrazení, udělení a odebrání oprávnění.

Nahrát bitovou kopii

Použijte název registru pracovního prostoru s názvem obrázku catalog.schema.artifact:tag .

Získejte název hostitele registru

Použijte název hostitele registru vypsaný pomocí databricks auth docker configure. Chcete-li později najít název hostitele profilu a zkontrolovat, zda je jeho pomocník pro přihlašovací údaje v Dockeru nakonfigurován, spusťte:

databricks auth docker host --profile <profile>

Pokud potřebujete ručně vytvořit hostitelské jméno, použijte číselné ID pracovního prostoru a oblast pracovního prostoru. Pro nalezení ID pracovního prostoru viz názvy instancí, URL a ID pracovního prostoru.

Pro nalezení oblasti pracovního prostoru otevřete přepínač pracovního prostoru v horním navigačním panelu. Region se objevuje pod názvem pracovního prostoru. Najdete ho také v konzole účtu v části Pracovní prostory.

Použijte následující název hostitele:

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

Požadavky na název artefaktu

Important

Názvy artefaktů musí být plně kvalifikované názvy služby Unity Catalog ve formátu <catalog>.<schema>.<artifact>. V rámci názvu nepoužívejte lomítko. Viz hierarchie objektů v katalogu Unity.

Segment <artifact> může obsahovat až 255 znaků. Používejte pouze malá písmena, čísla, podtržítka a pomlčky. Musí začínat a končit písmenem nebo číslem. Používejte maximálně dvě po sobě jdoucí podtržítka a neumisťujte podtržítko vedle pomlčky.

Otagujte image a nahrajte ji do repozitáře

Warning

Do obrázku neuvádějte přihlašovací údaje ani jiné citlivé údaje. Než ho zatlačíte, zkontrolujte obrázek. Verze artefaktů jsou neměnné a žádosti o smazání nejsou podporovány. Pokud pošlete citlivá data, okamžitě je otočte nebo zrušte a požádejte administrátora, aby omezil jakékoli READ VOLUME granty týkající se postiženého artefaktu. Přestaňte používat dotčený digest a všechny tagy, které na něj odkazují, a poté si přečtěte informace, které je třeba uvést při žádosti o pomoc.

Označte místní obrázek pro Registr artefaktů:

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

Nahrajte bitovou kopii:

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

Objevte obrázky a verze

Použijte Software Artifacts API k vypisu artefaktů v katalogu a schématu a poté k vyjmenování verzí artefaktu.

Note

Dedikované příkazy Databricks CLI pro výpis a správu obrázků z registru artefaktů nejsou k dispozici. Použijte databricks api k volání Software Artifacts API.

Následující příklady používají profil, který jste nastavili pro autentizaci v Dockeru. Vynechejte --profile <profile>, pokud je to váš výchozí profil pro Databricks CLI.

Seznam artefaktů

Pro vyjmenování artefaktů spusťte následující příkaz:

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

Odpověď obsahuje jméno artefaktu a jeho majitele. Pokud odpověď obsahuje next_page_token, předejte její hodnotu v parametru page_token dotazu pro získání další stránky, například &page_token=<next_page_token>.

Výpis verzí

Pro vyjmenování verzí artefaktu spusťte následující příkaz:

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

Odpověď obsahuje image digest, tagy a image_acceleration_details.status pro každou verzi. Pro limity odezvy viz Omezení.

Zkontrolujte stav akcelerace obrazu

Načtěte image_acceleration_details.status z odpovědi verze artefaktu:

Status	Význam
`SUCCESS`	Akcelerace obrazu byla úspěšně dokončena.
`UNSPECIFIED`	Nebyl zaznamenán žádný úspěšný výsledek akcelerace obrazu. Tento stav neznamená selhání.

Používejte image v podporovaných úlohách Azure Databricks

Poté, co pošlete image do Artifact Registry, odkazujte na něj při vytváření podporované pracovní zátěže Azure Databricks.

Pro použití image v úloze AI Runtime viz Použití vlastních imagí Dockeru s AI Runtime.

Dodatečné zdroje

Váš názor

Byla tato stránka užitečná?

Poslední aktualizace v 2026-10-06