Feedback

az acr connected-registry

  • Referenz

Verwalten von verbundenen Registrierungsressourcen mit Azure Container Registries.

Befehle

az acr connected-registry create

Erstellen Sie eine verbundene Registrierung für eine Azure Container Registry.
az acr connected-registry deactivate

Deaktivieren Sie eine verbundene Registrierung von Azure Container Registry.
az acr connected-registry delete

Löschen Sie eine verbundene Registrierung aus Azure Container Registry.
az acr connected-registry get-settings

Abrufen von Informationen, die zum Aktivieren einer verbundenen Registrierung erforderlich sind, und erstellt oder dreht die Anmeldeinformationen des Synchronisierungstokens.
az acr connected-registry install

Hilfe zum Zugreifen auf die erforderlichen Informationen zum Installieren einer verbundenen Registrierung. Unter https://aka.ms/acr/connected-registry finden Sie weitere Informationen.
az acr connected-registry install info

Abrufen von Informationen, die zum Aktivieren einer verbundenen Registrierung erforderlich sind.
az acr connected-registry install renew-credentials

Rufen Sie Informationen ab, die zum Aktivieren einer verbundenen Registrierung erforderlich sind, und verlängern Sie die Anmeldeinformationen des Synchronisierungstokens.
az acr connected-registry list

Listet alle verbundenen Registrierungen unter der aktuellen übergeordneten Registrierung auf.
az acr connected-registry list-client-tokens

Listet alle Clienttoken auf, die einer bestimmten verbundenen Registrierung zugeordnet sind.
az acr connected-registry permissions

Verwalten Sie die Repositoryberechtigungen für mehrere verbundene Registrierungen. Unter https://aka.ms/acr/connected-registry finden Sie weitere Informationen.
az acr connected-registry permissions show

Anzeigen der Informationen zur verbundenen Registrierungssynchronisierungsbereichszuordnung.
az acr connected-registry permissions update

Hinzufügen und Entfernen von Repositoryberechtigungen über alle erforderlichen verbundenen Registrierungssynchronisierungsbereichszuordnungen.
az acr connected-registry repo

Aktualisieren Aller erforderlichen verbundenen Registrierungssynchronisierungsbereichs-Repositoryberechtigungen.
az acr connected-registry show

Verbundene Registrierungsdetails anzeigen.
az acr connected-registry update

Aktualisieren einer verbundenen Registrierung für eine Azure Container Registry.

az acr connected-registry create

Bearbeiten

Erstellen Sie eine verbundene Registrierung für eine Azure Container Registry.

az acr connected-registry create --name
                                 --registry
                                 [--audit-logs-enabled {false, true}]
                                 [--client-tokens]
                                 [--log-level]
                                 [--mode {ReadOnly, ReadWrite}]
                                 [--notifications]
                                 [--parent]
                                 [--repository]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-token]
                                 [--sync-window]

Beispiele

Erstellen Sie eine verbundene Registrierung im Registrierungsmodus mit Zugriff auf repos app/hello-world und service/mycomponent. Es erstellt ein Synchronisierungstoken und eine Bereichszuordnung mit den richtigen Repositoryberechtigungen.

az acr connected-registry create --registry mycloudregistry --name myconnectedregistry \
    --repository "app/hello-world" "service/mycomponent"

Erstellen einer schreibgeschützten verbundenen Registrierung mit nur Leseberechtigungen und Übergeben des Synchronisierungstokens

az acr connected-registry create --registry mycloudregistry  --name myreadonlyacr \
    --mode readonly --parent myconnectedregistry --sync-token mySyncTokenName

Erstellen Sie eine schreibgeschützte verbundene Registrierung mit Clienttoken, die jeden Tag zu Mitte und Synchronisierungsfenster von 4 Stunden synchronisiert wird.

az acr connected-registry create -r mycloudregistry -n myreadonlyacr -p myconnectedregistry \
    --repository "app/mycomponent" -m ReadOnly -s "0 12 * * *" -w PT4H \
    --client-tokens myTokenName1 myTokenName2

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud-ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--audit-logs-enabled

Geben Sie an, ob die Überwachungsprotokollsynchronisierung aktiviert ist. Es ist standardmäßig aktiviert.

Zulässige Werte: false, true
--client-tokens

Geben Sie den Clientzugriff auf die Repositorys in der verbundenen Registrierung an. Sie kann im Format [TOKEN_NAME01] [TOKEN_NAME02]...

--log-level

Legen Sie die Protokollebene für die Protokollierung in der Instanz fest. Akzeptierte Protokollebenen sind Debug, Information, Warnung, Fehler und Keine.

Standardwert: Information
--mode -m

Bestimmen Sie den Zugriff, über den sie bei der Synchronisierung verfügen soll.

Zulässige Werte: ReadOnly, ReadWrite
Standardwert: ReadWrite
--notifications

Liste des Artefaktmusters, für das Benachrichtigungen generiert werden müssen. Verwenden Sie das Format "--notifications [PATTERN1 PATTERN2 ...]".

--parent -p

Der Name der verbundenen übergeordneten Registrierung.

--repository

Geben Sie die Repositorys an, die mit der verbundenen Registrierung synchronisiert werden müssen. Es kann sich im Format [REPO01] [REPO02] befinden...

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sync-message-ttl

Bestimmen Sie, wie lange die Synchronisierungsnachrichten in der Cloud aufbewahrt werden. Verwendet das ISO 8601-Dauerformat.

Standardwert: P2D
--sync-schedule -s

Optionaler Parameter zum Definieren des Synchronisierungszeitplans. Verwendet cron-Ausdruck, um den Zeitplan zu bestimmen. Wenn nicht angegeben, wird die Instanz immer online betrachtet und versucht, jede Minute zu synchronisieren.

--sync-token

Gibt das Synchronisierungstoken an, das zum Synchronisieren der verbundenen Registrierung mit seinem übergeordneten Element verwendet wird. Es verfügt am meisten über nur Repositoryberechtigungen und zumindest die für den Modus erforderlichen Aktionen. Sie kann Zugriff auf mehrere Repositorys enthalten.

--sync-window -w

Erforderlicher Parameter, wenn "-sync-schedule" vorhanden ist. Wird verwendet, um die Zeitplandauer zu bestimmen. Verwendet das ISO 8601-Dauerformat.

az acr connected-registry deactivate

Bearbeiten

Deaktivieren Sie eine verbundene Registrierung von Azure Container Registry.

az acr connected-registry deactivate --name
                                     --registry
                                     [--resource-group]
                                     [--yes]

Beispiele

Deaktivieren Sie eine verbundene Registrierung "myconnectedregistry".

az acr connected-registry deactivate -r mycloudregistry -n myconnectedregistry

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud-ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

az acr connected-registry delete

Bearbeiten

Löschen Sie eine verbundene Registrierung aus Azure Container Registry.

az acr connected-registry delete --name
                                 --registry
                                 [--cleanup]
                                 [--resource-group]
                                 [--yes]

Beispiele

Löschen Sie eine schreibgeschützte verbundene Registrierung "myconnectedregistry" aus der übergeordneten Registrierung "mycloudregistry".

az acr connected-registry delete --registry mycloudregistry --name myconnectedregistry

Löschen Sie eine schreibgeschützte verbundene Registrierung "myconnectedregistry", und es ist Synchronisierungstoken und Bereichszuordnung aus der übergeordneten Registrierung "mycloudregistry".

az acr connected-registry delete -r mycloudregistry -n myconnectedregistry --cleanup

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud-ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--cleanup

Es wird aslo das Synchronisierungstoken und die Bereichszuordnungsressourcen gelöscht.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

az acr connected-registry get-settings

Bearbeiten

Abrufen von Informationen, die zum Aktivieren einer verbundenen Registrierung erforderlich sind, und erstellt oder dreht die Anmeldeinformationen des Synchronisierungstokens.

az acr connected-registry get-settings --name
                                       --parent-protocol {http, https}
                                       --registry
                                       [--generate-password {1, 2}]
                                       [--resource-group]
                                       [--yes]

Beispiele

Rufen Sie die Einstellungen ab, die zum Installieren einer verbundenen Registrierung ohne kennwort erforderlich sind.

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --parent-protocol http

Generieren Sie ein neues Synchronisierungstokenkennwort 1, oder drehen Sie das Kennwort, wenn es bereits vorhanden ist, und ruft die Einstellungen ab, die zum Installieren einer verbundenen Registrierung erforderlich sind.

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --generate-password 1 --parent-protocol https

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud-ACR-Hierarchie eindeutig sein.

--parent-protocol

Geben Sie das Protokoll an, das für die Kommunikation mit dem übergeordneten Protokoll verwendet wird.

Zulässige Werte: http, https
--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--generate-password

Wählen Sie aus, welches Kennwort Sie generieren möchten, und es ist erforderlich, das Kennwort aus dem Synchronisierungstoken abzurufen.

Zulässige Werte: 1, 2
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--yes -y

Nicht zur Bestätigung auffordern

az acr connected-registry list

Bearbeiten

Listet alle verbundenen Registrierungen unter der aktuellen übergeordneten Registrierung auf.

az acr connected-registry list --registry
                               [--no-children]
                               [--parent]
                               [--resource-group]

Beispiele

Listet alle verbundenen Registrierungen der "mycloudregistry" im Tabellenformat auf.

az acr connected-registry list --registry mycloudregistry --output table

Listet nur die untergeordneten Untergeordneten von "mycloudregistry" in erweiterter Form in einer Tabelle auf.

az acr connected-registry list --registry mycloudregistry --no-children --output table

Listet alle Nachkommen von "myconnectedregistry" in erweiterter Form in einer Tabelle auf.

az acr connected-registry list -r mycloudregistry -p myconnectedregistry --output table

Erforderliche Parameter

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--no-children

Wird verwendet, um alle untergeordneten Elemente aus der Liste zu entfernen.

--parent -p

Der Name der übergeordneten verbundenen Registrierung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az acr connected-registry list-client-tokens

Bearbeiten

Listet alle Clienttoken auf, die einer bestimmten verbundenen Registrierung zugeordnet sind.

az acr connected-registry list-client-tokens --name
                                             --registry
                                             [--resource-group]

Beispiele

Listet alle Clienttoken von "myreadonlyacr" auf.

az acr connected-registry list-client-tokens -r mycloudregistry -n myreadonlyacr -o table

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az acr connected-registry repo

Bearbeiten

Aktualisieren Sie alle erforderlichen Berechtigungen für die Synchronisierung des Registrierungssynchronisierungsbereichs.

az acr connected-registry repo --name
                               --registry
                               [--add]
                               [--remove]
                               [--resource-group]

Beispiele

Fügen Sie Berechtigungen zum Synchronisieren von Bildern aus "repo1" und "repo2" zur verbundenen Registrierung "myconnectedregistry" und ihren Vorgängern hinzu.

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --add repo1 repo2

Entfernen Sie Berechtigungen zum Synchronisieren von Bildern aus "repo1" und "repo2" in die verbundene Registrierung "myconnectedregistry" und deren Untergeordneten.

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --remove repo1 repo2

Entfernen Sie Berechtigungen zum Synchronisieren von "Repo1"-Bildern und fügt Berechtigungen für "Repo2"-Bilder hinzu.

az acr connected-registry repo -r mycloudregistry -n myconnectedregistry --remove repo1 --add repo2

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--add

Repositoryberechtigungen, die der gezielten verbundenen Registrierung hinzugefügt werden sollen, und es ist die Synchronisierungsbereichszuordnungen. Verwenden Sie das Format "-add [REPO1 REPO2...]" pro Flag. Gültige Aktionen sind {'content/write', 'content/delete', 'metadaten/write', 'content/read', 'metadaten/read'}.

--remove

Respsitory-Berechtigungen, die aus der gezielten verbundenen Registrierung entfernt werden sollen, und es ist Synchronisierungsbereichszuordnungen. Verwenden Sie das Format "-remove [REPO1 REPO2...]" pro Flag. Gültige Aktionen sind {'content/write', 'content/delete', 'metadaten/write', 'content/read', 'metadaten/read'}.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az acr connected-registry show

Bearbeiten

Zeigen Sie verbundene Registrierungsdetails an.

az acr connected-registry show --name
                               --registry
                               [--resource-group]

Beispiele

Zeigen Sie alle Details der Registrierung "myreadonlyacr" in Tabellenformular an.

az acr connected-registry show --registry mycloudregistry --name myreadonlyacr --output table

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az acr connected-registry update

Bearbeiten

Aktualisieren sie eine verbundene Registrierung für eine Azure Container Registry.

az acr connected-registry update --name
                                 --registry
                                 [--add-client-tokens]
                                 [--add-notifications]
                                 [--audit-logs-enabled {false, true}]
                                 [--log-level]
                                 [--remove-client-tokens]
                                 [--remove-notifications]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-window]

Beispiele

Aktualisieren Sie die verbundenen Registrierungsclienttoken.

az acr connected-registry update --registry mycloudregistry --name myconnectedregistry \
    --remove-client-tokens myTokenName1 --add-client-tokens myTokenName2 myTokenName3

Aktualisieren Sie die Synchronisierungs- und Fensterzeit einer verbundenen Registrierung.

az acr connected-registry update --registry mycloudregistry --name myreadonlyacr \
    --sync-schedule "0 12 * * *" --sync-window PT4H

Erforderliche Parameter

--name -n

Name für die verbundene Registrierung. Der Name muss zwischen 5 und 40 Zeichen lang sein, beginnt mit einem Buchstaben und enthält nur alphanumerische Zeichen (einschließlich '_' oder '-'). Der Name muss unter der Cloud ACR-Hierarchie eindeutig sein.

--registry -r

Der Anmeldeserver der Cloud ACR-Registrierung. Muss der FQDN sein, um auch Azure Stack zu unterstützen.

Optionale Parameter

--add-client-tokens

Clienttoken, die hinzugefügt werden sollen. Verwenden Sie das Format "-add-add-client-token [TOKEN_NAME1 TOKEN_NAME2 ...]" pro Token-ID.

--add-notifications

Liste des Artefaktemusters, das zur Benachrichtigungsliste hinzugefügt werden soll. Verwenden Sie das Format "-add-notifications [PATTERN1 PATTERN2...]".

--audit-logs-enabled

Geben Sie an, ob die Überwachungsprotokollsynchronisierung aktiviert ist. Es ist standardmäßig aktiviert.

Zulässige Werte: false, true
--log-level

Legen Sie die Protokollebene für die Protokollierung in der Instanz fest. Akzeptierte Protokollebenen sind Debug, Information, Warnung, Fehler und Keine.

--remove-client-tokens

Clienttoken, die entfernt werden sollen. Verwenden Sie das Format "-remove-client-token [TOKEN_NAME1 TOKEN_NAME2 ...]" pro Token-ID.

--remove-notifications

Liste des Artefaktemusters, das aus der Benachrichtigungsliste entfernt werden soll. Verwenden Sie das Format "-remove-notifications [PATTERN1 PATTERN2...]".

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--sync-message-ttl

Bestimmen Sie, wie lange die Synchronisierungsnachrichten in der Cloud aufbewahrt werden. Verwendet das ISO 8601-Dauerformat.

--sync-schedule -s

Optionaler Parameter zum Definieren des Synchronisierungszeitplans. Verwendet den Cron-Ausdruck, um den Zeitplan zu bestimmen. Wenn nicht angegeben, wird die Instanz immer online betrachtet und versucht, jede Minute zu synchronisieren.

--sync-window -w

Wird verwendet, um die Zeitplandauer zu bestimmen. Verwendet das ISO 8601-Dauerformat.