Compartilhar via

az containerapp github-action

  • Referência

Nota

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Comandos para gerenciar o GitHub Actions.

Comandos

Nome Description Tipo Status
az containerapp github-action add

Adicione um fluxo de trabalho do GitHub Actions a um repositório para implantar um aplicativo de contêiner.

 Núcleo GA
az containerapp github-action add (containerapp extensão)

Adicione um fluxo de trabalho do GitHub Actions a um repositório para implantar um aplicativo de contêiner.

 Extensão GA
az containerapp github-action delete

Remova um fluxo de trabalho do GitHub Actions dos Aplicativos de Contêiner configurados anteriormente de um repositório.

 Núcleo GA
az containerapp github-action show

Mostrar a configuração do GitHub Actions em um aplicativo de contêiner.

 Núcleo GA

az containerapp github-action add

Editar

Adicione um fluxo de trabalho do GitHub Actions a um repositório para implantar um aplicativo de contêiner.

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]

Exemplos

Adicione o GitHub Actions usando o Registro de Contêiner do Azure e o token de acesso pessoal.

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

Adicione o GitHub Actions usando o Registro de Contêiner do Azure e faça logon no fluxo do GitHub para recuperar o token de acesso pessoal.

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

Adicione o GitHub Actions usando o Hub do Docker e faça logon no fluxo do GitHub para recuperar o token de acesso pessoal.

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

Parâmetros Exigidos

--repo-url

O repositório GitHub ao qual o arquivo de fluxo de trabalho será adicionado. No formato: https://github.com/<owner>/<repository-name>.

Parâmetros Opcionais

--branch -b

O branch do repositório Github. Supõe-se que seja o branch padrão do repositório Github, se não especificado.

--context-path

Caminho no repositório do qual executar o build do Docker. O padrão é "./".

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--image -i

Nome da imagem do contêiner que a Ação do Github deve usar. O padrão é o nome do Aplicativo de Contêiner.

--login-with-github

Faça logon interativamente com o Github para recuperar o Token de Acesso Pessoal.

Valor padrão: False
--name -n

O nome do Aplicativo de Contêineres. Um nome deve consistir em caracteres alfanuméricos de minúsculas ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

--registry-password

A senha do registro. Se estiver usando o Registro de Contêiner do Azure, tentaremos inferir as credenciais se não forem fornecidas.

--registry-url

O servidor do Registro de Contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de usuário do registro. Se estiver usando o Registro de Contêiner do Azure, tentaremos inferir as credenciais se não forem fornecidas.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service-principal-client-id

A ID do cliente da entidade de serviço.

--service-principal-client-secret

O segredo do cliente da entidade de serviço.

--service-principal-tenant-id

A ID do locatário da entidade de serviço.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--token

Um Token de Acesso Pessoal com acesso de gravação ao repositório especificado. Para obter mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az containerapp github-action add (containerapp extensão)

Adicione um fluxo de trabalho do GitHub Actions a um repositório para implantar um aplicativo de contêiner.

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]

Exemplos

Adicione o GitHub Actions usando o Registro de Contêiner do Azure e o token de acesso pessoal.

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

Adicione o GitHub Actions, usando o Registro de Contêiner do Azure e o token de acesso pessoal, configure o build de imagem por meio de variáveis de ambiente de build.

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

Adicione o GitHub Actions usando o Registro de Contêiner do Azure e faça logon no fluxo do GitHub para recuperar o token de acesso pessoal.

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

Adicione o GitHub Actions usando o Hub do Docker e faça logon no fluxo do GitHub para recuperar o token de acesso pessoal.

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

Parâmetros Exigidos

--repo-url

O repositório GitHub ao qual o arquivo de fluxo de trabalho será adicionado. No formato: https://github.com/<owner>/<repository-name>.

Parâmetros Opcionais

--branch -b

O branch do repositório Github. Supõe-se que seja o branch padrão do repositório Github, se não especificado.

--build-env-vars
Versão Prévia

Uma lista de variáveis de ambiente para o build. Valores separados por espaço no formato 'key=value'.

--context-path

Caminho no repositório do qual executar o build do Docker. O padrão é "./".

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--image -i

Nome da imagem do contêiner que a Ação do Github deve usar. O padrão é o nome do Aplicativo de Contêiner.

--login-with-github

Faça logon interativamente com o Github para recuperar o Token de Acesso Pessoal.

Valor padrão: False
--name -n

O nome do Aplicativo de Contêineres. Um nome deve consistir em caracteres alfanuméricos de minúsculas ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

--registry-password

A senha do registro. Se estiver usando o Registro de Contêiner do Azure, tentaremos inferir as credenciais se não forem fornecidas.

--registry-url

O servidor do Registro de Contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de usuário do registro. Se estiver usando o Registro de Contêiner do Azure, tentaremos inferir as credenciais se não forem fornecidas.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--service-principal-client-id

A ID do cliente da entidade de serviço.

--service-principal-client-secret

O segredo do cliente da entidade de serviço.

--service-principal-tenant-id

A ID do locatário da entidade de serviço.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--token

Um Token de Acesso Pessoal com acesso de gravação ao repositório especificado. Para obter mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az containerapp github-action delete

Editar

Remova um fluxo de trabalho do GitHub Actions dos Aplicativos de Contêiner configurados anteriormente de um repositório.

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

Exemplos

Remova o GitHub Actions usando um token de acesso pessoal.

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

Remova o GitHub Actions usando o fluxo de logon no GitHub para recuperar o token de acesso pessoal.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--login-with-github

Faça logon interativamente com o Github para recuperar o Token de Acesso Pessoal.

Valor padrão: False
--name -n

O nome do Aplicativo de Contêineres. Um nome deve consistir em caracteres alfanuméricos de minúsculas ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--token

Um Token de Acesso Pessoal com acesso de gravação ao repositório especificado. Para obter mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

az containerapp github-action show

Editar

Mostrar a configuração do GitHub Actions em um aplicativo de contêiner.

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

Exemplos

Mostrar a configuração do GitHub Actions em um Aplicativo de Contêineres.

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

Parâmetros Opcionais

--ids

Uma ou mais IDs de recurso (delimitadas por espaço). Deve ser uma ID de recurso completa que contém todas as informações de argumentos de 'ID do recurso'. Você deve fornecer --ids ou outros argumentos de 'ID de recurso'.

--name -n

O nome do Aplicativo de Contêineres. Um nome deve consistir em caracteres alfanuméricos de minúsculas ou '-', começar com uma letra, terminar com um caractere alfanumérico, não pode ter '--' e deve ter menos de 32 caracteres.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Apenas mostrar erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.