Partager via


az containerapp github-action

Note

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. Apprenez-en davantage sur les extensions.

Commandes pour gérer GitHub Actions.

Commandes

Nom Description Type État
az containerapp github-action add

Ajoutez un flux de travail GitHub Actions à un référentiel pour déployer une application conteneur.

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

Ajoutez un flux de travail GitHub Actions à un référentiel pour déployer une application conteneur.

Extension GA
az containerapp github-action delete

Supprimez un flux de travail GitHub Actions Container Apps précédemment configuré à partir d’un référentiel.

Core GA
az containerapp github-action show

Afficher la configuration GitHub Actions sur une application conteneur.

Core GA

az containerapp github-action add

Ajoutez un flux de travail GitHub Actions à un référentiel pour déployer une application conteneur.

az containerapp github-action add --repo-url
                                  [--branch]
                                  [--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]

Exemples

Ajoutez GitHub Actions, à l’aide d’Azure Container Registry et d’un jeton d’accès personnel.

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

Ajoutez GitHub Actions, à l’aide d’Azure Container Registry et connectez-vous au flux GitHub pour récupérer le jeton d’accès personnel.

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

Ajoutez GitHub Actions, à l’aide de Docker Hub et connectez-vous au flux GitHub pour récupérer le jeton d’accès personnel.

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

Paramètres obligatoires

--repo-url

Dépôt GitHub auquel le fichier de flux de travail sera ajouté. Au format : https://github.com/<owner>/<repository-name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--branch -b

Branche du dépôt Github. Supposé être le branche par défaut du dépôt Github s’il n’est pas spécifié.

--context-path

Chemin d’accès dans le référentiel à partir duquel exécuter la build Docker. La valeur par défaut est « ./ ».

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--image -i

Nom de l’image conteneur que l’action Github doit utiliser. La valeur par défaut est le nom de l’application conteneur.

--login-with-github

Connectez-vous de manière interactive avec Github pour récupérer le jeton d’accès personnel.

Propriété Valeur
Valeur par défaut: False
--name -n

Nom de Containerapp. Un nom doit se composer de caractères alphanumériques minuscules ou « - », commencer par une lettre, se terminer par un caractère alphanumérique, ne peut pas avoir « - » et doit être inférieur à 32 caractères.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--registry-password

Mot de passe du Registre. Si vous utilisez Azure Container Registry, nous tenterons de déduire les informations d’identification si elles ne sont pas fournies.

--registry-url

Le serveur de registre de conteneurs, par exemple, myregistry.azurecr.io.

--registry-username

Nom d’utilisateur du Registre. Si vous utilisez Azure Container Registry, nous tenterons de déduire les informations d’identification si elles ne sont pas fournies.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--service-principal-client-id

ID de client du principal du service.

--service-principal-client-secret

Secret client du principal du service.

--service-principal-tenant-id

L’ID de locataire du principal du service.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--token

Jeton d’accès personnel avec accès en écriture au référentiel spécifié. Pour plus d’informations : https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az containerapp github-action add (containerapp extension)

Ajoutez un flux de travail GitHub Actions à un référentiel pour déployer une application conteneur.

az containerapp github-action add --repo-url
                                  [--branch]
                                  [--build-env-vars]
                                  [--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]

Exemples

Ajoutez GitHub Actions, à l’aide d’Azure Container Registry et d’un jeton d’accès personnel.

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

Ajoutez GitHub Actions, à l’aide d’Azure Container Registry et d’un jeton d’accès personnel, configurez la génération d’images via des variables d’environnement de génération.

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

Ajoutez GitHub Actions, à l’aide d’Azure Container Registry et connectez-vous au flux GitHub pour récupérer le jeton d’accès personnel.

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

Ajoutez GitHub Actions, à l’aide de Docker Hub et connectez-vous au flux GitHub pour récupérer le jeton d’accès personnel.

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

Paramètres obligatoires

--repo-url

Dépôt GitHub auquel le fichier de flux de travail sera ajouté. Au format : https://github.com/<owner>/<repository-name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--branch -b

Branche du dépôt Github. Supposé être le branche par défaut du dépôt Github s’il n’est pas spécifié.

--build-env-vars
Préversion

Liste des variables d’environnement pour la build. Valeurs séparées par l’espace au format « key=value ».

--context-path

Chemin d’accès dans le référentiel à partir duquel exécuter la build Docker. La valeur par défaut est « ./ ».

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--image -i

Nom de l’image conteneur que l’action Github doit utiliser. La valeur par défaut est le nom de l’application conteneur.

--login-with-github

Connectez-vous de manière interactive avec Github pour récupérer le jeton d’accès personnel.

Propriété Valeur
Valeur par défaut: False
--name -n

Nom de Containerapp. Un nom doit se composer de caractères alphanumériques minuscules ou « - », commencer par une lettre, se terminer par un caractère alphanumérique, ne peut pas avoir « - » et doit être inférieur à 32 caractères.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--registry-password

Mot de passe du Registre. Si vous utilisez Azure Container Registry, nous tenterons de déduire les informations d’identification si elles ne sont pas fournies.

--registry-url

Le serveur de registre de conteneurs, par exemple, myregistry.azurecr.io.

--registry-username

Nom d’utilisateur du Registre. Si vous utilisez Azure Container Registry, nous tenterons de déduire les informations d’identification si elles ne sont pas fournies.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--service-principal-client-id

ID de client du principal du service.

--service-principal-client-secret

Secret client du principal du service.

--service-principal-tenant-id

L’ID de locataire du principal du service.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--token

Jeton d’accès personnel avec accès en écriture au référentiel spécifié. Pour plus d’informations : https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az containerapp github-action delete

Supprimez un flux de travail GitHub Actions Container Apps précédemment configuré à partir d’un référentiel.

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

Exemples

Supprimez GitHub Actions à l’aide d’un jeton d’accès personnel.

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

Supprimez GitHub Actions à l’aide de la connexion au flux GitHub pour récupérer le jeton d’accès personnel.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--login-with-github

Connectez-vous de manière interactive avec Github pour récupérer le jeton d’accès personnel.

Propriété Valeur
Valeur par défaut: False
--name -n

Nom de Containerapp. Un nom doit se composer de caractères alphanumériques minuscules ou « - », commencer par une lettre, se terminer par un caractère alphanumérique, ne peut pas avoir « - » et doit être inférieur à 32 caractères.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--token

Jeton d’accès personnel avec accès en écriture au référentiel spécifié. Pour plus d’informations : https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False

az containerapp github-action show

Afficher la configuration GitHub Actions sur une application conteneur.

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

Exemples

Affichez la configuration GitHub Actions sur une application Conteneur.

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

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de Containerapp. Un nom doit se composer de caractères alphanumériques minuscules ou « - », commencer par une lettre, se terminer par un caractère alphanumérique, ne peut pas avoir « - » et doit être inférieur à 32 caractères.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--verbose

Augmentez le niveau de verbosité de la journalisation. Utilisez --debug pour les journaux de débogage complets.

Propriété Valeur
Valeur par défaut: False