Artefactenregister

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.

Artifact Registry slaat containerafbeeldingen op als bestuurde assets in Unity Catalog. De afbeeldingen worden opgeslagen in hetzelfde gebied als de Unity Catalog metastore. Gebruik het om images te pushen met standaard Docker-commando's, beheer toegang met Unity Catalog-rechten en maak images beschikbaar voor ondersteunde Azure Databricks-workloads.

belangrijke concepten

• Artefact: Een benoemde containerafbeelding opgeslagen in Unity Catalog, geïdentificeerd door een drie-niveau naam in het formaat catalog.schema.artifact.
• Tag: Een veranderlijke alias die verwijst naar een artefactversie met het formaat catalog.schema.artifact:tag. Een tag opnieuw pushen kan de versie veranderen waarnaar de tag verwijst. Voor herhaalbare implementaties vermijd veranderbare tags zoals latest en verwijs naar een digest wanneer de workload digestreferenties accepteert.
• Beelddigest: Een onveranderlijke, inhoudsgerichte identificatie voor een specifieke versie van een artefact.
• Beeldversnelling: Een optimalisatie die Azure Databricks automatisch toepast nadat je een geschikte afbeelding naar het Artifact Registry hebt gestuurd. Dit proces zet de afbeelding om in een formaat dat is ontworpen om de pull latency voor ondersteunde workloads te verminderen. Om de beeldversnellingsstatus van een artefactversie te controleren, zie Bekijk beeldversnellingsstatus.

Hoe Artefactregister werkt

Uitgevers en gebruikers werken met containerafbeeldingen in Artifact Registry gedurende de volgende levenscyclus:

1. Bouwen en pushen: Een uitgever bouwt een afbeelding, tagt deze met een drie-niveau Unity Catalog-naam in dat formaat catalog.schema.artifact:tagen pusht deze naar het werkruimteregister. Zie vereisten voor artefactnamen en Een image pushen.
2. Regelen: Artifact Registry slaat de afbeelding op onder de gespecificeerde Unity Catalog-catalogus en het schema. Unity Catalog-privileges bepalen wie de afbeelding kan publiceren, ontdekken en lezen. Zie Toekenningsvergunningen.
3. Ontdek: Gebruikers roepen de Software Artifacts API aan om beschikbare afbeeldingen en versies te ontdekken en om de status van beeldversnelling te controleren. Zie Discover-afbeeldingen en versies.
4. Gebruik: Gebruikers verwijzen naar een image wanneer ze ondersteunde Azure Databricks workloads maken, zoals jobs die aangepaste containerimages uitvoeren. Zie Gebruik afbeeldingen in ondersteunde Azure Databricks workloads.

Beperkingen

De volgende beperkingen zijn van toepassing:

Availability

• Je werkruimte en de Unity Catalog metastore moeten in dezelfde regio zitten. Als de regio's verschillen, kun je Artifact Registry niet vanuit die werkruimte gebruiken.

• Artefactregister is beschikbaar in de volgende regio's:

  • australiaeast
  • brazilsouth
  • canadacentral
  • centralindia
  • centralus
  • eastasia
  • eastus
  • eastus2
  • francecentral
  • germanywestcentral
  • japaneast
  • koreacentral
  • northcentralus
  • northeurope
  • southcentralus
  • southeastasia
  • swedencentral
  • switzerlandnorth
  • uaenorth
  • uksouth
  • ukwest
  • westcentralus
  • westeurope
  • westus
  • westus2
  • westus3

Ondersteund gebruik

• Je kunt images gebruiken in Artifact Registry alleen met ondersteunde Azure Databricks workloads. Zie Afbeeldingen gebruiken in ondersteunde Azure Databricks-workloads.
• Je kunt Docker of een andere registerclient niet gebruiken om deze afbeeldingen direct op te halen of afbeeldingsblobs te downloaden.

Authentication

• Het workspace OAuth-toegangstoken dat wordt gebruikt voor Docker-authenticatie verloopt na een uur. Een push die langer duurt, kan ervoor zorgen dat de autorisatie mislukt voor een laag die na het verlopen is geüpload. Probeer de push opnieuw zodat de helper van de Docker-inloggegevens een nieuw token aanvraagt.

Afbeeldingsversnelling

• Afbeeldingen groter dan 30 GB kunnen niet worden omgezet voor beeldversnelling.
• Beeldversnelling onthult geen mislukte conversietoestand. Zie Status van beeldversnelling controleren.

Ontdekking en beheer

• Catalog Explorer biedt geen interface voor afbeeldingen.
• Het register-endpoint ondersteunt geen Open Container Initiative (OCI) taglijstverzoeken of verwijderverzoeken.
• De Software Artifacts API geeft maximaal 10 tags terug voor een versie wanneer meer dan 10 tags naar dezelfde digest verwijzen.

Namen van artefacten

• Artefactnamen hebben beperkingen op tekens en opmaak. Zie vereisten voor artefactnaam.

Aanvullende bronnen

• Om authenticatie te configureren, toegang te verlenen, een image te pushen en de versies ervan te ontdekken, zie Get Started with Artifact Registry.
• Om veelvoorkomende problemen met bèta-toegang, authenticatie, push, ontdekking en beeldversnelling op te lossen, zie Troubleshoot Artifact Registry.