Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In dieser Schnellstartanleitung verwenden Sie die Azure CLI und das Azure-Portal, um eine verbundene Registrierungsressource in Azure zu erstellen. Mit dem verbundenen Registrierungsfeature der Azure Container Registry können Sie eine Registrierung remote oder lokal bereitstellen und Bilder und andere Artefakte mit der Cloudregistrierung synchronisieren.
Hier erstellen Sie zwei verbundene Registrierungsressourcen für eine Cloudregistrierung: Eine verbundene Registrierung ermöglicht Lese- und Schreibfunktionen (Pull- und Pushvorgänge für Artefakte), die andere ermöglicht schreibgeschützte Funktionen.
Nachdem Sie eine verbundene Registrierung erstellt haben, können Sie andere Anleitungen befolgen, um sie in Ihrer lokalen oder Remoteinfrastruktur bereitzustellen und zu verwenden.
Voraussetzungen
- Azure Container-Registrierung – Wenn Sie noch keine Containerregistrierung haben, erstellen Sie eine (Premium-Stufe erforderlich) in einer Region , die verbundene Registrierungen unterstützt.
Verwenden Sie die Azure CLI, um Bilder in die Containerregistrierung zu importieren.
Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter "Erste Schritte mit Azure Cloud Shell".
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen möchten, installieren Sie die Azure CLI. Wenn Sie mit Windows oder macOS arbeiten, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Um den Authentifizierungsprozess abzuschließen, führen Sie die schritte aus, die in Ihrem Terminal angezeigt werden. Weitere Anmeldeoptionen finden Sie unter Authentifizieren bei Azure mithilfe der Azure CLI.
Wenn Sie dazu aufgefordert werden, installieren Sie die Azure CLI-Erweiterung bei der ersten Verwendung. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden und Verwalten von Erweiterungen mit der Azure CLI.
Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um auf die neueste Version zu aktualisieren.
Aktivieren des dedizierten Datenendpunkts für die Cloudregistrierung
Aktivieren Sie den dedizierten Datenendpunkt für die Azure-Containerregistrierung in der Cloud. Dieser Schritt ist erforderlich, damit eine verbundene Registrierung mit der Cloudregistrierung kommuniziert.
- Navigieren Sie im Azure-Portal zu Ihrer Containerregistrierung.
- Wählen Sie den öffentlichen Netzwerkzugriff > aus. Aktivieren Sie das Kontrollkästchen "Dedizierten Datenendpunkt aktivieren ".
- Wählen Sie Speichern aus.
Importieren von Bildern in Ihre Cloudregistrierung
Importieren Sie die folgenden Containerimages mithilfe des Az acr-Importbefehls in Ihre Cloudregistrierung. Überspringen Sie diesen Schritt, wenn Sie diese Bilder bereits importiert haben.
Verbundenes Registry-Abbild
Verwenden Sie den Befehl "az acr import ", um das verbundene Registrierungsimage in Ihre private Registrierung zu importieren.
# Use the REGISTRY_NAME variable in the following Azure CLI commands to identify the registry
REGISTRY_NAME=<container-registry-name>
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/acr/connected-registry:1.0.0
Bild "Hello-world"
Zum Testen der verbundenen Registrierung importieren Sie das hello-world Image. Dieses Repository wird mit der verbundenen Registrierung synchronisiert und von den verbundenen Registrierungsclients abgerufen.
az acr import \
--name $REGISTRY_NAME \
--source mcr.microsoft.com/hello-world:1.1.2
Erstellen einer verbundenen Registrierungsressource für Lese- und Schreibfunktionen
Die folgenden Schritte erstellen eine verbundene Registrierung im ReadWrite-Modus , die mit der Cloudregistrierung verknüpft ist.
- Navigieren Sie im Azure-Portal zu Ihrer Containerregistrierung.
- Wählen Sie verbundene Register (Vorschau) > + Erstellen aus.
- Geben Sie die Werte in der folgenden Tabelle ein, oder wählen Sie sie aus, und wählen Sie " Speichern" aus.
| Artikel | Description |
|---|---|
| Parent | Wählen Sie "Kein übergeordnetes Element " für eine verbundene Registrierung aus, die mit der Cloudregistrierung verknüpft ist. |
| Modus | Wählen Sie "ReadWrite" aus. |
| Name | Der verbundene Registrierungsname muss mit einem Buchstaben beginnen und nur alphanumerische Zeichen enthalten. Es muss 5 bis 40 Zeichen lang sein und in der Hierarchie dieser Azure-Containerregistrierung eindeutig sein. |
| Log-Eigenschaften | Übernehmen Sie die Standardeinstellungen. |
| Synchronisierungseigenschaften | Übernehmen Sie die Standardeinstellungen. Da standardmäßig kein Synchronisierungszeitplan definiert ist, werden die Repositorys ohne Unterbrechungen zwischen der Cloudregistrierung und der verbundenen Registrierung synchronisiert. |
| Repositorien | Wählen Sie die Namen der Repositorys aus, die Sie im vorherigen Schritt importiert haben, oder geben Sie sie ein. Die angegebenen Repositorys werden, sobald sie bereitgestellt sind, zwischen der Cloudregistrierung und der verbundenen Registrierung synchronisiert. |
Erstellen einer verbundenen Registrierungsressource für schreibgeschützte Funktionen
Die folgenden Schritte erstellen eine verbundene Registrierung im ReadOnly-Modus , dessen übergeordnetes Element die verbundene Registrierung ist, die Sie im vorherigen Abschnitt erstellt haben. Diese verbundene Registrierung ermöglicht nach der Bereitstellung schreibgeschützte Funktionen (Pullvorgänge für Artefakte).
- Navigieren Sie im Azure-Portal zu Ihrer Containerregistrierung.
- Wählen Sie Verbundene Registries (Vorschau) > + Erstellen aus.
- Geben Sie die Werte in der folgenden Tabelle ein, oder wählen Sie sie aus, und wählen Sie " Speichern" aus.
| Artikel | Description |
|---|---|
| Parent | Wählen Sie die zuvor erstellte verbundene Registrierung aus. |
| Modus | Wählen Sie "ReadOnly" aus. |
| Name | Der verbundene Registrierungsname muss mit einem Buchstaben beginnen und nur alphanumerische Zeichen enthalten. Es muss mindestens 5 und höchstens 40 Zeichen lang sein und in der Hierarchie für diese Azure-Containerregistrierung eindeutig sein. |
| Protokolleigenschaften | Übernehmen Sie die Standardeinstellungen. |
| Synchronisierungseigenschaften | Übernehmen Sie die Standardeinstellungen. Da standardmäßig kein Synchronisierungszeitplan definiert ist, werden die Repositorys ohne Unterbrechungen zwischen der Cloudregistrierung und der verbundenen Registrierung synchronisiert. |
| Repositorien | Wählen Sie die Namen der Repositorys aus, die Sie im vorherigen Schritt importiert haben, oder geben Sie sie ein. Die angegebenen Repositorys werden, sobald sie bereitgestellt sind, zwischen der übergeordneten Registrierung und der verbundenen Registrierung synchronisiert. |
Überprüfen, ob die Ressourcen erstellt wurden
Wählen Sie eine verbundene Registrierung im Portal aus, um ihre Eigenschaften anzuzeigen, wie z. B. ihren Verbindungsstatus (Offline, Online oder Unhealthy) und ob sie aktiviert (on-premises bereitgestellt) wurde. Im folgenden Beispiel wird das verbundene Register nicht eingesetzt. Der Verbindungsstatus von "Offline" gibt an, dass sie von der Cloud getrennt wurde.
In dieser Ansicht können Sie auch eine Verbindungszeichenfolge generieren und optional Kennwörter für das Synchronisierungstoken generieren. Eine Verbindungszeichenfolge enthält Konfigurationseinstellungen, die zum Bereitstellen einer verbundenen Registrierung und zum Synchronisieren von Inhalten mit einer übergeordneten Registrierung verwendet werden.
Nächste Schritte
In dieser Schnellstartanleitung haben Sie die Azure CLI und das Azure-Portal verwendet, um zwei verbundene Registrierungsressourcen in Azure zu erstellen. Diese neuen verbundenen Registrierungsressourcen sind an Ihre Cloudregistrierung gebunden und ermöglichen die Synchronisierung von Artefakten mit der Cloudregistrierung.
Lesen Sie weiter in den Bereitstellungshandbüchern für verbundene Registrierungen, um zu erfahren, wie Sie eine verbundene Registrierung in Ihrer Infrastruktur bereitstellen und verwenden.