Compartilhar via

az containerapp github-action

Note

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 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.

 Core 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.

 Extension GA
az containerapp github-action delete

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

 Core GA
az containerapp github-action show

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

 Core 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--branch -b

A ramificação do repositório do Github. Presume-se que seja o branch padrão do repositório do Github, se não for especificado.

--context-path

Caminho no repositório do qual executar a compilação 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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--branch -b

A ramificação do repositório do Github. Presume-se que seja o branch padrão do repositório do Github, se não for especificado.

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

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

--context-path

Caminho no repositório do qual executar a compilação 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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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>.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp github-action delete

Editar

Remova um fluxo de trabalho do GitHub Actions dos Aplicativos de Contêiner configurado 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--login-with-github

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

Propriedade Valor
Valor padrão: False
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--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.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False

az containerapp github-action show

Editar

Mostre 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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'.

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--name -n

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--resource-group -g

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
--subscription

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

Propriedade Valor
Grupo de parâmetros: Resource Id Arguments
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

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

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

--verbose

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

Propriedade Valor
Valor padrão: False