Partilhar via

az containerapp github-action

Note

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

Comandos para gerir GitHub Actions.

Comandos

Name Description Tipo Status
az containerapp github-action add

Adiciona um fluxo de trabalho do GitHub Actions a um repositório para implementar uma aplicação de contentores.

 Core disponibilidade geral
az containerapp github-action add (containerapp extensão)

Adiciona um fluxo de trabalho do GitHub Actions a um repositório para implementar uma aplicação de contentores.

 Extension disponibilidade geral
az containerapp github-action delete

Remover um fluxo de trabalho de GitHub Actions de Aplicações de Container previamente configurado de um repositório.

 Core disponibilidade geral
az containerapp github-action show

Mostra a configuração do GitHub Actions numa aplicação de contentores.

 Core disponibilidade geral

az containerapp github-action add

Editar

Adiciona um fluxo de trabalho do GitHub Actions a um repositório para implementar uma aplicação de contentores.

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]

Exemplos

Adicionar GitHub Actions, usando o Azure Container Registry e 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 GitHub Actions, usando o Azure Container Registry e inicie sessão 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 GitHub Actions, usando o Docker Hub e inicie sessão 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 Obrigatórios

--repo-url

O repositório do GitHub ao qual o ficheiro 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--branch -b

O ramo do repositório Github. Assumido como a ramificação padrão do repositório Github se não for especificado.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--context-path

Caminho no repositório a partir do qual executar a compilação do docker. O padrão é "./".

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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 login interativamente com o Github para recuperar o Token de Acesso Pessoal.

Propriedade Valor
Default value: 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 a usar o Azure Container Registry, tentaremos inferir as credenciais se não forem fornecidas.

--registry-url

O servidor de registro de contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de utilizador do registo. Se estiver a usar o Azure Container Registry, 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

O ID do cliente da entidade de serviço.

--service-principal-client-secret

O segredo do cliente principal do serviço.

--service-principal-tenant-id

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

--subscription

Nome ou ID da subscrição. 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 mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

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

Adiciona um fluxo de trabalho do GitHub Actions a um repositório para implementar uma aplicação de contentores.

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]

Exemplos

Adicionar GitHub Actions, usando o Azure Container Registry e 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

Adicionar GitHub Actions, usar o Azure Container Registry e token de acesso pessoal, configurar a construção da imagem através das variáveis do ambiente de compilação.

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 GitHub Actions, usando o Azure Container Registry e inicie sessão 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 GitHub Actions, usando o Docker Hub e inicie sessão 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 Obrigatórios

--repo-url

O repositório do GitHub ao qual o ficheiro 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--branch -b

O ramo do repositório Github. Assumido como a ramificação padrão do repositório Github se não for especificado.

--build-env-vars
Pré-visualizar

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

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--context-path

Caminho no repositório a partir do qual executar a compilação do docker. O padrão é "./".

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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 login interativamente com o Github para recuperar o Token de Acesso Pessoal.

Propriedade Valor
Default value: 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 a usar o Azure Container Registry, tentaremos inferir as credenciais se não forem fornecidas.

--registry-url

O servidor de registro de contêiner, por exemplo, myregistry.azurecr.io.

--registry-username

O nome de utilizador do registo. Se estiver a usar o Azure Container Registry, 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

O ID do cliente da entidade de serviço.

--service-principal-client-secret

O segredo do cliente principal do serviço.

--service-principal-tenant-id

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

--subscription

Nome ou ID da subscrição. 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 mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az containerapp github-action delete

Editar

Remover um fluxo de trabalho de GitHub Actions de Aplicações de Container previamente configurado de um repositório.

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

Exemplos

Remover as ações do GitHub Actions usando um token de acesso pessoal.

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

Remover GitHub Actions usando login no fluxo do 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 tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade Valor
Grupo de parâmetros: Global Policy Arguments
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

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

Propriedade Valor
Default value: 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 subscrição. 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 mais informações: https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line.

Parâmetros de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False

az containerapp github-action show

Editar

Mostra a configuração do GitHub Actions numa aplicação de contentores.

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

Exemplos

Mostra a configuração do GitHub Actions numa Containerapp.

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 tornar-se necessários para que o comando seja executado com êxito.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo que contenha todas as informações dos argumentos do 'ID de recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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 subscrição. 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 de Globais
--debug

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

Propriedade Valor
Default value: False
--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Default value: False
--output -o

Formato de saída.

Propriedade Valor
Default value: json
Valores aceites: 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

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

Propriedade Valor
Default value: False