Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
U kunt eenvoudig containerinstallatiekopieën importeren (kopiëren) naar een Azure containerregister zonder Docker-opdrachten te gebruiken. U kunt bijvoorbeeld installatiekopieën uit een ontwikkelingsregister importeren in een productieregister of basisinstallatiekopieën uit een openbaar register kopiëren.
Azure Container Registry ondersteunt veelvoorkomende scenario's voor het kopiëren van images en andere artefacten vanuit een bestaand register:
Importeer images uit een openbaar register.
Importeer images of OCI-artefacten, waaronder Helm 3-charts, uit een ander Azure-containerregister binnen hetzelfde Azure-abonnement, dezelfde Azure-tenant of in verschillende abonnementen en tenants.
Containerimages importeren uit een privécontainerregister buiten Azure.
Het importeren van installatiekopieën in een Azure containerregister heeft de volgende voordelen in vergelijking met het gebruik van Docker CLI-opdrachten:
Als uw clientomgeving geen lokale Docker-installatie nodig heeft, kunt u elke containerinstallatiekopie importeren, ongeacht het ondersteunde type besturingssysteem.
Als u installatiekopieën met meerdere architectuur (zoals officiële Docker-installatiekopieën) importeert, worden installatiekopieën voor alle architecturen en platforms die zijn opgegeven in de manifestlijst gekopieerd.
Als u toegang hebt tot het doelregister, hebt u het openbare eindpunt van het register niet nodig.
Belangrijk
Voor het importeren van images is ondersteuning door een externe registry voor RFC 7233 vereist. Als u fouten wilt voorkomen, gebruikt u een register dat RFC 7233-bereiken ondersteunt tijdens het gebruik van de az acr import opdracht met de register-URI.
Beperkingen
Het maximum aantal manifesten voor een geïmporteerde afbeelding is 50.
Azure Container Registry ondersteunt het importeren van images uit verschillende bronregisters van diverse cloudproviders. Als de importbron een ACR is, kunt u alleen importeren uit de basisregio van de bron-ACR. De regionale eindpunten van de bron-ACR worden niet ondersteund als importbronnen. Geef het globale eindpunt van de bron-ACR op bij het importeren uit een bron-ACR. Daarnaast schrijft een importbewerking altijd inhoud naar de thuisregio van de downstream-ACR. Zie Azure Container Registry eindpuntreferentie.
Als u containerinstallatiekopieën wilt importeren, voert u de Azure CLI uit in Azure Cloud Shell of lokaal.
Notitie
Als u identieke containerinstallatiekopieën wilt distribueren over meerdere Azure-regio's, biedt Azure Container Registry ook ondersteuning voor geo-replicatie. Door een register geografisch te repliceren (Premium-servicelaag vereist), kunt u vanuit één register meerdere regio's bedienen met identieke image- en tagnamen.
Belangrijk
Als u wilt importeren naar of uit een Azure-containerregister met netwerkbeperkingen, moet het register met beperkingen toegang door vertrouwde services toestaan om het netwerk te omzeilen. De instelling is standaard ingeschakeld, dus importeren werkt. Als u een register maakt met een privé-eindpunt of met firewallregels voor het register en de instelling niet inschakelt, mislukt het importeren.
Vereisten
Als u nog geen Azure-containerregister hebt, maakt u een register. Zie Quickstart: Een privécontainerregister maken met behulp van de Azure CLI voor stappen.
Om een afbeelding te importeren in een Azure Container Registry, moet uw identiteit machtigingen hebben om importbewerkingen te triggert in het doelregister (Container Registry Data Importer and Data Reader rol). Zie het overzicht van Azure Container Registry Entra-machtigingen en -rollen.
Containerimages importeren uit een openbaar register
Belangrijk
Als u wilt importeren uit een openbaar register naar een door het netwerk beperkt Azure containerregister, moet het beperkte register toegang toestaan door vertrouwde services om het netwerk te omzeilen. Deze instelling is standaard ingeschakeld, dus import werkt. Als u deze instelling uitschakelt in een nieuw gemaakt register met een privé-eindpunt of met firewallregels voor het register, mislukt het importeren.
Containerinstallatiekopieën importeren uit Docker Hub
Gebruik bijvoorbeeld het commando az acr import om de multi-architectuur afbeelding hello-world:latest uit Docker Hub te importeren in een register met de naam myregistry. Omdat hello-world een officiële image van Docker Hub is, staat deze image in de standaardrepository library. Neem de naam van de repository en eventueel een tag op in de waarde van de afbeeldingsparameter --source. (U kunt desgewenst een image identificeren aan de hand van de manifest-digest in plaats van via een tag, wat een specifieke versie van een image garandeert.)
az acr import \
--name myregistry \
--source docker.io/library/hello-world:latest \
--image hello-world:latest
U kunt controleren of er meerdere manifesten zijn gekoppeld aan deze installatiekopieën door de opdracht az acr manifest list-metadata uit te voeren:
az acr manifest list-metadata \
--name hello-world \
--registry myregistry
Een artefact importeren op basis van digest zonder een tag toe te voegen:
az acr import \
--name myregistry \
--source docker.io/library/hello-world@sha256:abc123 \
--repository hello-world
Als u een Docker Hub-account hebt, gebruikt u de referenties bij het importeren van een afbeelding uit Docker Hub. Geef de Docker Hub-gebruikersnaam en het wachtwoord of een persoonlijk toegangstoken door als parameters.az acr import In het volgende voorbeeld wordt een openbare image uit de tensorflow-repository in Docker Hub geïmporteerd met behulp van Docker Hub-inloggegevens:
az acr import \
--name myregistry \
--source docker.io/tensorflow/tensorflow:latest-gpu \
--image tensorflow:latest-gpu \
--username <Docker Hub user name> \
--password <Docker Hub token>
Containerinstallatiekopieën importeren uit Microsoft Container Registry
Importeer bijvoorbeeld de ltsc2022 Windows Server Core-image uit de windows-repository in Microsoft Container Registry.
az acr import \
--name myregistry \
--source mcr.microsoft.com/windows/servercore:ltsc2022\
--image servercore:ltsc2022
Containerinstallatiekopieën importeren uit een Azure containerregister in dezelfde Microsoft Entra tenant
U kunt een installatiekopie importeren vanuit een Azure-containerregister in dezelfde Microsoft Entra-tenant met geïntegreerde Microsoft Entra-machtigingen.
Uw identiteit moet machtigingen hebben voor het bekijken en ophalen van afbeeldingen, tags en OCI-verwijzingen uit het bronregister (
Container Registry Data Importer and Data Readerrol toegewezen aan het bronregister).Uw identiteit moet ook machtigingen hebben voor zowel het lezen van afbeeldingen als het importen activeren op het doelregister (
Container Registry Data Importer and Data Readertoegekende rol aan het doelregister).Het register kan zich in hetzelfde of een ander Azure-abonnement in dezelfde Microsoft Entra tenant bevinden.
Openbare toegang tot het bronregister is uitgeschakeld. Als openbare toegang is uitgeschakeld, geeft u het bronregister op resource-id op in plaats van op de aanmeldingsservernaam van het register.
Het bronregister en/of het doelregister met een privé-eindpunt of registerfirewallregels moeten ervoor zorgen dat het beperkte register vertrouwde services toegang geeft tot het netwerk.
Containerimages importeren uit een containerregister in hetzelfde abonnement
Importeer bijvoorbeeld de aci-helloworld:latest afbeelding uit een bronregister mysourceregistry naar myregistry binnen hetzelfde Azure-abonnement.
In het volgende voorbeeld wordt de aci-helloworld:latest installatiekopie geïmporteerd in myregistry uit een bronregister mysourceregistry waarin de toegang tot het openbare eindpunt van het register is uitgeschakeld. Geef de resource-id van het bronregister op met de --registry parameter. U ziet dat de --source parameter alleen de bronopslagplaats en tag opgeeft, niet de naam van de aanmeldingsserver van het register.
Als u Microsoft Entra identiteitsverificatie wilt gebruiken voor het bronregister, neemt u de --registry <source-registry-resource-id> vlag op.
az acr import \
--name myregistry \
--source aci-helloworld:latest \
--image aci-helloworld:latest \
--registry /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry
Containerimages importeren uit een register in een ander abonnement
Notitie
Als u een installatiekopieën van het ene register naar het andere wilt importeren, moeten de bron- en doelregisters ervoor zorgen dat beide regio's zijn geregistreerd voor Azure Container Registry (ACR) onder de resourceproviders van het abonnement.
In het volgende voorbeeld bevindt mysourceregistry zich in een ander abonnement dan mijn register in dezelfde tenant. Geef de resource-id van het bronregister op met behulp van de --registry parameter. De --source parameter geeft alleen de bronopslagplaats en tag op, niet de naam van de registeraanmeldingsserver.
az acr import \
--name myregistry \
--source aci-helloworld:latest \
--image aci-hello-world:latest \
--registry /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/mysourceregistry
Containerimages vanuit een register importeren met aanmeldingsgegevens van een service-principal
Als u wilt importeren uit een register waartoe u geen toegang hebt met behulp van geïntegreerde Active Directory machtigingen, gebruikt u service-principalreferenties (indien beschikbaar) voor het bronregister. Voer de app-id en het wachtwoord in van een Microsoft Entra service-principal met de juiste roltoewijzingstoegang tot het bronregister.
- Voor Microsoft Entra service-principals moet u ervoor zorgen dat
Container Registry Repository Reader(voor registers met ABAC-functionaliteit) ofAcrPull(voor niet-ABAC-registers) is toegewezen.
Het gebruik van een service-principal is handig voor buildsystemen en andere onbeheerde systemen die images in uw register moeten importeren.
az acr import \
--name myregistry \
--source sourceregistry.azurecr.io/sourcerepo:tag \
--image targetimage:tag \
--username <SP_App_ID> \
--password <SP_Passwd>
Container-images importeren uit een Azure-containerregister in een andere tenant
Als u installatiekopieën wilt importeren uit een Azure containerregister in een andere Microsoft Entra tenant, geeft u het bronregister op basis van de aanmeldingsservernaam op en geeft u referenties op waarmee pull-toegang tot het register mogelijk is.
Import tussen tenants wordt niet ondersteund via een register waarvoor openbare toegang is uitgeschakeld.
Tenantoverschrijdende import met gebruikersnaam en wachtwoord
Gebruik bijvoorbeeld een niet-Microsoft Entra-repository-scoped token en wachtwoord, of de appID en het wachtwoord van een Microsoft Entra service-principal met de juiste roltoewijzingen voor het bronregister.
- Voor Microsoft Entra service-principals moet u ervoor zorgen dat
Container Registry Repository Reader(voor registers met ABAC-functionaliteit) ofAcrPull(voor niet-ABAC-registers) is toegewezen aan het bronregister.
az acr import \
--name myregistry \
--source sourceregistry.azurecr.io/sourcerepo:tag \
--image targetimage:tag \
--username <SP_App_ID> \
--password <SP_Passwd>
Tenantoverschrijdend importeren met een toegangstoken
Als u toegang wilt krijgen tot het bronregister met behulp van een identiteit in de brontenant met registermachtigingen, haalt u een toegangstoken op:
# Login to Azure CLI with the identity, for example a user-assigned managed identity
az login --identity --username <identity_ID>
# Get access token returned by `az account get-access-token`
az account get-access-token
Geef in de doeltenant het toegangstoken als een wachtwoord door aan de az acr import opdracht. Het bronregister geeft de naam van de aanmeldingsserver op. Er is geen gebruikersnaam nodig in deze opdracht:
az acr import \
--name myregistry \
--source sourceregistry.azurecr.io/sourcerepo:tag \
--image targetimage:tag \
--password ($token|ConvertFrom-Json).accessToken
Containerinstallatiekopieën importeren uit een niet-Azure privécontainerregister
Importeer een installatiekopie uit een niet-Azure-privéregister door referenties op te geven die pull-toegang tot het register mogelijk maken. Haal bijvoorbeeld een installatiekopie op uit een persoonlijk Docker-register:
az acr import \
--name myregistry \
--source docker.io/sourcerepo/sourceimage:tag \
--image sourceimage:tag \
--username <username> \
--password <password>
Problemen bij het importeren van containerimages oplossen
Als er een fout optreedt bij het importeren van een afbeelding, raadpleegt u de volgende tabel voor meer informatie.
| Foutmelding | Explanation |
|---|---|
The remote server may not be RFC 7233 compliant |
Met de distributiespecificatie is de vorm van een bereikkoptekst toegestaan.Range: bytes=<start>-<end> De externe server is echter mogelijk niet compatibel met RFC 7233. |
Unexpected response status code |
Er is een onverwachte antwoordstatuscode opgehaald uit de bronopslagplaats bij het uitvoeren van een bereikquery. |
Unexpected length of body in response |
De lengte van de ontvangen inhoud komt niet overeen met de verwachte grootte. De verwachte grootte wordt bepaald door de grootte van de blob en de Range-header. |
Volgende stappen
In dit artikel hebt u geleerd hoe u containerinstallatiekopieën importeert in een Azure-containerregister vanuit een openbaar register of een ander privéregister.
Zie voor aanvullende opties voor het importeren van containerimages de referentie voor az acr import of Import-AzContainerRegistryImage.
Met het importeren van installatiekopieën kunt u inhoud verplaatsen naar een containerregister in een andere Azure-regio, een ander abonnement of een Microsoft Entra-tenant. Zie Een containerregister handmatig verplaatsen naar een andere regio voor meer informatie.
Export van artefacten uitschakelen uit een containerregister met netwerkbeperking.