Begin met het Artefactregister

Important

Deze functie bevindt zich in de bètaversie. Om het te gebruiken, moet een workspace-beheerder Databricks Artifact Registry inschakelen vanaf de pagina Previews. Zie Azure Databricks previews beheren. Databricks zal de prijzen voor het Artifact Registry bekendmaken zodra deze algemeen beschikbaar is.

Gebruik Artifact Registry om containerimages te pushen met Docker en beheer ze in Unity Catalog.

Deze pagina laat zien hoe je authenticatie configureert, toegang verleent, een afbeelding pusht en ontdekt. Voor concepten en beperkingen, zie Artefactregister. Als een commando of operatie faalt, zie dan het Registratieregister voor Probleemoplossing van Artefacten.

Requirements

Voordat u begint, moet u het volgende hebben:

  • Een werkruimte in een regio die Artifact Registry ondersteunt. Zie Beperkingen.
  • De Databricks CLI (commandoregelinterface) versie 1.18.0 of hoger is geïnstalleerd op je lokale machine.
  • De Docker CLI is geïnstalleerd op je lokale machine.
  • Een bestaande Unity Catalog-catalogus en schema die toegankelijk zijn vanuit de werkruimte.
  • De Unity Catalog-privileges voor jouw operatie.

Docker-authenticatie instellen

De Databricks CLI bevat een experimenteel commando dat Docker configureert om inloggegevens op te vragen voor het werkruimteregister. De Docker-inlogeerhulper vereist een werkruimte OAuth-profiel dat is aangemaakt door databricks auth login. Het ondersteunt geen profielen die persoonlijke toegangstokens, OAuth machine-to-machine (M2M) inloggegevens of account-only authenticatie gebruiken.

  1. Maak een profiel aan of vernieuw een profiel voor de doelwerkruimte:

    databricks auth login --profile <profile>

  2. Configureer Docker-authenticatie voor het werkruimteregister:

    databricks auth docker configure --profile <profile>

    Laat --profile <profile> weg om je standaard Databricks CLI-profiel te gebruiken.

    De Databricks CLI leidt de registerregio af en print de hostnaam van het werkruimteregister. Gebruik deze hostnaam wanneer je een image pusht.

Machtigingen verlenen

Het Artefactregister maakt de catalogus of het schema niet aan. Beide moeten al bestaan in de Unity Catalog en toegankelijk zijn vanuit de werkruimte.

Artifact Registry gebruikt Unity Catalog-rechten om de toegang tot afbeeldingen te beheren. De volgende tabel geeft de machtigingen met minimale bevoegdheden voor elke actie weer. Bredere beheerprivileges kunnen ook bepaalde operaties autoriseren.

Bewerking Toekenning van minimale bevoegdheden
Een nieuw artefact verplaatsen USE CATALOG, USE SCHEMA en CREATE VOLUME
Push een nieuwe versie of verplaats een tag USE CATALOG, USE SCHEMA en WRITE VOLUME
Ontdek artefacten en versies USE CATALOG, USE SCHEMA en READ METADATA
Gebruik een image in een ondersteunde werklast USE CATALOG, USE SCHEMA en READ VOLUME

Voor een schema dat gewijd is aan Artifact Registry kan een beheerder de rechten op schema-niveau toekennen. Schema-niveau privileges gelden voor elk overeenkomend object in het schema, inclusief objecten die later worden aangemaakt. Gebruik aparte schema's voor uitgevers die elkaars artefacten niet mogen aanpassen. Verleen elke opdrachtgever alleen de privileges die nodig zijn voor zijn operaties. Vervang de voorbeeldwaarden en verwijder onnodige privilege-statements voordat je de volgende statements uitvoert:

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

Voor details over CREATE VOLUME, WRITE VOLUME, READ METADATA, en READ VOLUME, zie de referentie Unity Catalog privileges. Voor andere subsidiemethoden, zie Privileges tonen, toekennen en intrekken.

Een afbeelding uploaden

Gebruik de hostnaam van het workspace-register met de catalog.schema.artifact:tag naam van de afbeelding.

Haal de hostnaam van het register op

Gebruik de registerhostnaam die door databricks auth docker configureis afgedrukt. Om later de hostnaam van een profiel te vinden en te controleren of de Docker-credential helper is geconfigureerd, voer je uit:

databricks auth docker host --profile <profile>

Als je de hostnaam handmatig moet samenstellen, gebruik dan de numerieke werkruimte-ID en de werkruimteregio. Om de workspace-ID te vinden, zie Workspace instance names, URL's en ID's.

Om de werkruimteregio te vinden, open je de werkruimteschakelaar in de bovenste navigatiebalk. De regio verschijnt onder de naam van de werkruimte. U vindt deze ook in de accountconsole onder Werkruimten.

Gebruik de volgende hostnaam:

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

Vereisten voor artefactnaam

Important

Artefactnamen moeten volledig gekwalificeerde Unity-catalogusnamen zijn in het formaat <catalog>.<schema>.<artifact>. Gebruik geen slashes in de naam. Zie de Unity Catalog objecthiërarchie.

Het <artifact> segment kan tot 255 tekens bevatten. Gebruik alleen kleine letters, cijfers, onderstrepen en koppeltekens. Het moet beginnen en eindigen met een letter of cijfer. Gebruik niet meer dan twee opeenvolgende onderstreken en plaats geen onderstreep naast een koppelteken.

Tag de image en upload deze

Warning

Voeg geen inloggegevens of andere gevoelige gegevens toe aan een afbeelding. Controleer de afbeelding voordat je erop drukt. Artefactversies zijn onveranderlijk en verwijderverzoeken worden niet ondersteund. Als je gevoelige gegevens pusht, vervang ze dan onmiddellijk of trek ze in en vraag een beheerder om eventuele READ VOLUME-machtigingen die van toepassing zijn op het getroffen artefact in te perken. Stop met het gebruik van de betrokken digest en elke tag die naar die digest verwijst, en raadpleeg vervolgens de informatie die je moet vermelden wanneer je om hulp vraagt.

  1. Tag een lokale afbeelding voor Artifact Registry:

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

  2. Druk op het beeld:

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

Ontdek afbeeldingen en versies

Gebruik de Software Artifacts API om artefacten in een catalogus en schema te vermelden en vervolgens de versies van een artefact te vermelden.

Note

Speciale Databricks CLI-commando's voor het vermelden en beheren van Artifact Registry-afbeeldingen zijn niet beschikbaar. Gebruik databricks api om de Software Artifacts API aan te roepen.

De volgende voorbeelden gebruiken het profiel dat je hebt geconfigureerd voor Docker-authenticatie. Laat het --profile <profile> weg als het je standaard Databricks CLI-profiel is.

Artefacten weergeven

Om artefacten te vermelden, voer je het volgende commando uit:

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

Het antwoord bevat de naam en eigenaar van het artefact. Als het antwoord bevat next_page_token, geef de waarde in de page_token queryparameter om de volgende pagina op te halen, bijvoorbeeld, &page_token=<next_page_token>.

Versies weergeven

Om versies van een artefact te vermelden, voer je het volgende commando uit:

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

De reactie bevat de afbeeldingsdigest, tags en image_acceleration_details.status voor elke versie. Voor responslimieten, zie Beperkingen.

Controleer de status van beeldversnelling

Lees image_acceleration_details.status uit de reactie van de artefactversie:

Status Meaning
SUCCESS Beeldversnelling is succesvol voltooid.
UNSPECIFIED Er is geen geslaagd resultaat voor de versnelling van afbeeldingen geregistreerd. Deze status duidt niet op een mislukking.

Gebruik images in ondersteunde Azure Databricks workloads

Nadat je een image naar Artifact Registry hebt gestuurd, verwijs je ernaar wanneer je een ondersteunde Azure Databricks workload aanmaakt.

Om een image te gebruiken in een AI Runtime-werklast, zie Gebruik aangepaste Docker-images met AI Runtime.

Aanvullende bronnen

  • Laatst bijgewerkt om