Freigeben über


az containerapp github-action

Note

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Erfahren Sie mehr über Erweiterungen.

Befehle zum Verwalten von GitHub Actions.

Befehle

Name Beschreibung Typ Status
az containerapp github-action add

Fügen Sie einem Repository einen GitHub Actions Workflow hinzu, um eine Container-App bereitzustellen.

Core GA
az containerapp github-action add (containerapp Erweiterung)

Fügen Sie einem Repository einen GitHub Actions Workflow hinzu, um eine Container-App bereitzustellen.

Extension GA
az containerapp github-action delete

Entfernen Sie einen zuvor konfigurierten Container-Apps-GitHub Actions Workflow aus einem Repository.

Core GA
az containerapp github-action show

Zeigt die GitHub Actions Konfiguration in einer Container-App an.

Core GA

az containerapp github-action add

Fügen Sie einem Repository einen GitHub Actions Workflow hinzu, um eine Container-App bereitzustellen.

az containerapp github-action add --repo-url
                                  [--acquire-policy-token]
                                  [--branch]
                                  [--change-reference]
                                  [--context-path]
                                  [--ids]
                                  [--image]
                                  [--login-with-github]
                                  [--name]
                                  [--registry-password]
                                  [--registry-url]
                                  [--registry-username]
                                  [--resource-group]
                                  [--service-principal-client-id]
                                  [--service-principal-client-secret]
                                  [--service-principal-tenant-id]
                                  [--subscription]
                                  [--token]

Beispiele

Fügen Sie GitHub Actions mithilfe von Azure Container Registry und persönlichem Zugriffstoken hinzu.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-url myregistryurl.azurecr.io --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --token MyAccessToken

Fügen Sie GitHub Actions hinzu, indem Sie Azure Container Registry verwenden und sich bei GitHub Ablauf anmelden, um persönliche Zugriffstoken abzurufen.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-url myregistryurl.azurecr.io --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --login-with-github

Fügen Sie GitHub Actions hinzu, indem Sie Docker Hub verwenden und sich beim GitHub Fluss anmelden, um persönliche Zugriffstoken abzurufen.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-username MyUsername --registry-password MyPassword --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --login-with-github

Erforderliche Parameter

--repo-url

Das GitHub Repository, dem die Workflowdatei hinzugefügt wird. Im Format: https://github.com/<owner>/<repository-name>.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--branch -b

Die Verzweigung des Github-Repositorys. Wird angenommen, dass es sich um die Standardbranch des GitHub-Repositorys handelt, falls nicht angegeben.

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--context-path

Pfad im Repository, aus dem der Docker-Build ausgeführt werden soll. Der Standardwert ist "./".

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--image -i

Containerimagename, den die Github-Aktion verwenden soll. Standardmäßig wird der Container-App-Name verwendet.

--login-with-github

Melden Sie sich interaktiv mit Github an, um das persönliche Zugriffstoken abzurufen.

Eigenschaft Wert
Standardwert: False
--name -n

Der Name der Containerapp. Ein Name muss aus alphanumerischen Zeichen in Kleinbuchstaben oder "-" bestehen, mit einem Buchstaben beginnen, mit einem alphanumerischen Zeichen enden, darf "--" nicht aufweisen und muss kleiner als 32 Zeichen sein.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--registry-password

Das Kennwort der Registrierung. Wenn sie Azure Container Registry verwenden, versuchen wir, die Anmeldeinformationen abzuleiten, wenn sie nicht angegeben werden.

--registry-url

Der Containerregistrierungsserver, z. B. myregistry.azurecr.io.

--registry-username

Der Benutzername der Registrierung. Wenn sie Azure Container Registry verwenden, versuchen wir, die Anmeldeinformationen abzuleiten, wenn sie nicht angegeben werden.

--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--service-principal-client-id

Die Client-ID des Dienstprinzipals.

--service-principal-client-secret

Das Clientgeheimnis für den Dienstprinzipal.

--service-principal-tenant-id

Die Mandanten-ID des Dienstprinzipals.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--token

Ein persönliches Zugriffstoken mit Schreibzugriff auf das angegebene Repository. Weitere Informationen:https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az containerapp github-action add (containerapp Erweiterung)

Fügen Sie einem Repository einen GitHub Actions Workflow hinzu, um eine Container-App bereitzustellen.

az containerapp github-action add --repo-url
                                  [--acquire-policy-token]
                                  [--branch]
                                  [--build-env-vars]
                                  [--change-reference]
                                  [--context-path]
                                  [--ids]
                                  [--image]
                                  [--login-with-github]
                                  [--name]
                                  [--registry-password]
                                  [--registry-url]
                                  [--registry-username]
                                  [--resource-group]
                                  [--service-principal-client-id]
                                  [--service-principal-client-secret]
                                  [--service-principal-tenant-id]
                                  [--subscription]
                                  [--token]

Beispiele

Fügen Sie GitHub Actions mithilfe von Azure Container Registry und persönlichem Zugriffstoken hinzu.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-url myregistryurl.azurecr.io --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --token MyAccessToken

Fügen Sie GitHub Actions mithilfe von Azure Container Registry und persönlichem Zugriffstoken hinzu, konfigurieren Sie den Imagebuild über Buildumgebungsvariablen.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-url myregistryurl.azurecr.io --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --token MyAccessToken --build-env-vars BP_JVM_VERSION=21 BP_MAVEN_VERSION=4

Fügen Sie GitHub Actions hinzu, indem Sie Azure Container Registry verwenden und sich bei GitHub Ablauf anmelden, um persönliche Zugriffstoken abzurufen.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-url myregistryurl.azurecr.io --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --login-with-github

Fügen Sie GitHub Actions hinzu, indem Sie Docker Hub verwenden und sich beim GitHub Fluss anmelden, um persönliche Zugriffstoken abzurufen.

az containerapp github-action add -g MyResourceGroup -n my-containerapp --repo-url https://github.com/userid/repo --branch main --registry-username MyUsername --registry-password MyPassword --service-principal-client-id 00000000-0000-0000-0000-00000000 --service-principal-tenant-id 00000000-0000-0000-0000-00000000 --service-principal-client-secret ClientSecret --login-with-github

Erforderliche Parameter

--repo-url

Das GitHub Repository, dem die Workflowdatei hinzugefügt wird. Im Format: https://github.com/<owner>/<repository-name>.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--branch -b

Die Verzweigung des Github-Repositorys. Wird angenommen, dass es sich um die Standardbranch des GitHub-Repositorys handelt, falls nicht angegeben.

--build-env-vars
Vorschau

Eine Liste der Umgebungsvariablen für den Build. Leerzeichentrennte Werte im Format "key=value".

--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--context-path

Pfad im Repository, aus dem der Docker-Build ausgeführt werden soll. Der Standardwert ist "./".

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--image -i

Containerimagename, den die Github-Aktion verwenden soll. Standardmäßig wird der Container-App-Name verwendet.

--login-with-github

Melden Sie sich interaktiv mit Github an, um das persönliche Zugriffstoken abzurufen.

Eigenschaft Wert
Standardwert: False
--name -n

Der Name der Containerapp. Ein Name muss aus alphanumerischen Zeichen in Kleinbuchstaben oder "-" bestehen, mit einem Buchstaben beginnen, mit einem alphanumerischen Zeichen enden, darf "--" nicht aufweisen und muss kleiner als 32 Zeichen sein.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--registry-password

Das Kennwort der Registrierung. Wenn sie Azure Container Registry verwenden, versuchen wir, die Anmeldeinformationen abzuleiten, wenn sie nicht angegeben werden.

--registry-url

Der Containerregistrierungsserver, z. B. myregistry.azurecr.io.

--registry-username

Der Benutzername der Registrierung. Wenn sie Azure Container Registry verwenden, versuchen wir, die Anmeldeinformationen abzuleiten, wenn sie nicht angegeben werden.

--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--service-principal-client-id

Die Client-ID des Dienstprinzipals.

--service-principal-client-secret

Das Clientgeheimnis für den Dienstprinzipal.

--service-principal-tenant-id

Die Mandanten-ID des Dienstprinzipals.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--token

Ein persönliches Zugriffstoken mit Schreibzugriff auf das angegebene Repository. Weitere Informationen:https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az containerapp github-action delete

Entfernen Sie einen zuvor konfigurierten Container-Apps-GitHub Actions Workflow aus einem Repository.

az containerapp github-action delete [--acquire-policy-token]
                                     [--change-reference]
                                     [--ids]
                                     [--login-with-github]
                                     [--name]
                                     [--resource-group]
                                     [--subscription]
                                     [--token]

Beispiele

Entfernen Sie GitHub Actions mithilfe eines persönlichen Zugriffstokens.

az containerapp github-action delete -g MyResourceGroup -n MyContainerapp --token MyAccessToken

Entfernen Sie GitHub Actions mithilfe der Anmeldung zum GitHub Fluss zum Abrufen des persönlichen Zugriffstokens.

az containerapp github-action delete -g MyResourceGroup -n MyContainerapp --login-with-github

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--login-with-github

Melden Sie sich interaktiv mit Github an, um das persönliche Zugriffstoken abzurufen.

Eigenschaft Wert
Standardwert: False
--name -n

Der Name der Containerapp. Ein Name muss aus alphanumerischen Zeichen in Kleinbuchstaben oder "-" bestehen, mit einem Buchstaben beginnen, mit einem alphanumerischen Zeichen enden, darf "--" nicht aufweisen und muss kleiner als 32 Zeichen sein.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--token

Ein persönliches Zugriffstoken mit Schreibzugriff auf das angegebene Repository. Weitere Informationen:https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az containerapp github-action show

Zeigt die GitHub Actions Konfiguration in einer Container-App an.

az containerapp github-action show [--ids]
                                   [--name]
                                   [--resource-group]
                                   [--subscription]

Beispiele

Zeigt die GitHub Actions-Konfiguration in einer Containerapp an.

az containerapp github-action show -g MyResourceGroup -n MyContainerapp

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Der Name der Containerapp. Ein Name muss aus alphanumerischen Zeichen in Kleinbuchstaben oder "-" bestehen, mit einem Buchstaben beginnen, mit einem alphanumerischen Zeichen enden, darf "--" nicht aufweisen und muss kleiner als 32 Zeichen sein.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False