Partilhar via


az containerapp github-action

Note

Este 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 ações do GitHub.

Comandos

Name Description Tipo Status
az containerapp github-action add

Adicione um fluxo de trabalho de Ações do GitHub a um repositório para implantar um aplicativo de contêiner.

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

Adicione um fluxo de trabalho de Ações do GitHub a um repositório para implantar um aplicativo de contêiner.

Extension disponibilidade geral
az containerapp github-action delete

Remova um fluxo de trabalho de Ações do GitHub de Aplicativos de Contêiner configurado anteriormente de um repositório.

Core disponibilidade geral
az containerapp github-action show

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

Core disponibilidade geral

az containerapp github-action add

Adicione um fluxo de trabalho de Ações do GitHub 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 Ações do GitHub, 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 Ações do GitHub, 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 ações do GitHub, usando o Docker Hub, e faça login 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 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 tornar-se necessários para que o comando seja executado com êxito.

--branch -b

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

--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 usando o Registro de Contêiner do Azure, 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 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

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)

Adicione um fluxo de trabalho de Ações do GitHub 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 Ações do GitHub, 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 Ações do GitHub, usando o Registro de Contêiner do Azure e token de acesso pessoal, configure a criação de imagem por meio de variáveis de 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 Ações do GitHub, 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 ações do GitHub, usando o Docker Hub, e faça login 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 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 tornar-se necessários para que o comando seja executado com êxito.

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

--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 usando o Registro de Contêiner do Azure, 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 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

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

Remova um fluxo de trabalho de Ações do GitHub de 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 as Ações do GitHub usando um token de acesso pessoal.

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

Remova as Ações do GitHub usando o 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.

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

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

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

Exemplos

Mostrar a configuração de Ações do GitHub em um 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