Compartilhar via

az fleet

  • Referência

Observação

Essa referência faz parte da extensão de frota para a CLI do Azure (versão 2.61.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az fleet . Saiba mais sobre extensões.

Comandos para gerenciar frota.

Comandos

Nome Description Tipo Status
az fleet create

Cria ou atualiza uma frota.

 Extensão GA
az fleet delete

Exclui uma frota.

 Extensão GA
az fleet get-credentials

Para frotas hubful, obtém o kubeconfig para o cluster hub da frota.

 Extensão GA
az fleet list

Lista todas as frotas em um grupo de recursos.

 Extensão GA
az fleet member

Comandos para gerenciar membros.

 Extensão GA
az fleet member create

Cria ou atualiza um membro.

 Extensão GA
az fleet member delete

Exclui um membro da frota.

 Extensão GA
az fleet member list

Lista os membros de uma frota.

 Extensão GA
az fleet member reconcile

Reconcilia um membro.

 Extensão GA
az fleet member show

Obtém um membro da frota.

 Extensão GA
az fleet member update

Atualize um membro.

 Extensão GA
az fleet member wait

Aguarde até que um recurso de membro atinja um estado desejado.

 Extensão GA
az fleet reconcile

Reconcilia uma frota.

 Extensão GA
az fleet show

Recebe uma frota.

 Extensão GA
az fleet update

Corrige um recurso de frota.

 Extensão GA
az fleet updaterun

Comandos para gerenciar execuções de atualização.

 Extensão GA
az fleet updaterun create

Cria ou atualiza uma execução de atualização.

 Extensão GA
az fleet updaterun delete

Exclui uma execução de atualização.

 Extensão GA
az fleet updaterun list

Lista as execuções de atualização de uma frota.

 Extensão GA
az fleet updaterun show

Mostra uma execução de atualização.

 Extensão GA
az fleet updaterun skip

Define destinos a serem ignorados em um UpdateRun.

 Extensão GA
az fleet updaterun start

Inicia uma execução de atualização.

 Extensão GA
az fleet updaterun stop

Interrompe uma execução de atualização.

 Extensão GA
az fleet updaterun wait

Aguarde até que um recurso de execução de atualização atinja um estado desejado.

 Extensão GA
az fleet updatestrategy

Comandos para gerenciar estratégias de atualização.

 Extensão GA
az fleet updatestrategy create

Cria ou atualiza uma estratégia de atualização.

 Extensão GA
az fleet updatestrategy delete

Exclui uma estratégia de atualização.

 Extensão GA
az fleet updatestrategy list

Lista as estratégias de atualização da frota.

 Extensão GA
az fleet updatestrategy show

Mostra uma estratégia de atualização.

 Extensão GA
az fleet updatestrategy wait

Aguarde até que um recurso de estratégia de atualização atinja um estado desejado.

 Extensão GA
az fleet wait

Aguarde até que um recurso de frota atinja um estado desejado.

 Extensão GA

az fleet create

Cria ou atualiza uma frota.

az fleet create --name
                --resource-group
                [--agent-subnet-id]
                [--apiserver-subnet-id]
                [--assign-identity]
                [--dns-name-prefix]
                [--enable-hub]
                [--enable-managed-identity]
                [--enable-private-cluster]
                [--enable-vnet-integration]
                [--location]
                [--no-wait]
                [--tags]
                [--vm-size]

Exemplos

Crie uma frota sem hub.

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --tags "TagKey=TagValue"

Crie uma frota hubcheia.

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-hub --tags "TagKey=TagValue"

Crie uma frota com uma identidade de serviço gerenciado atribuída pelo sistema.

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-managed-identity

Crie uma frota com uma identidade de serviço gerenciado atribuída pelo usuário.

az fleet create -g MyFleetResourceGroup -l MyLocation -n MyFleetName --enable-managed-identity --assign-identity "/subscription/00000000-0000-0000-0000-000000000000/resourcegroup/MyFleetResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity"

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--agent-subnet-id

O ID da sub-rede na qual o nó do hub da Frota ingressará na inicialização.

--apiserver-subnet-id
Versão Prévia

A sub-rede a ser usada quando a integração apiserver vnet estiver habilitada.

--assign-identity

Com --enable-managed-identity, habilite a identidade gerenciada atribuída pelo usuário (MSI) no recurso de Frota especificando a ID do recurso da identidade atribuída pelo usuário.

--dns-name-prefix -p

Prefixo para nomes de host criados. Se não for especificado, gere um nome de host usando os nomes de cluster gerenciado e grupo de recursos.

--enable-hub

Se definido, a Frota será criada com um cluster de hub.

Valor padrão: False
--enable-managed-identity

Habilite a MSI (identidade gerenciada atribuída pelo sistema) no recurso de Frota.

Valor padrão: False
--enable-private-cluster

Se o hub da Frota deve ser criado como um cluster privado ou não.

Valor padrão: False
--enable-vnet-integration
Versão Prévia

Se a integração de vnet do apiserver deve ser habilitada para o hub de Frota ou não.

Valor padrão: False
--location -l

Local. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

--vm-size

O tamanho da máquina virtual do hub de frota.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet delete

Exclui uma frota.

az fleet delete --name
                --resource-group
                [--no-wait]
                [--yes]

Exemplos

Exclua uma frota específica.

az fleet delete -g MyFleetResourceGroup -n MyFleetName

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet get-credentials

Para frotas hubful, obtém o kubeconfig para o cluster hub da frota.

az fleet get-credentials --name
                         --resource-group
                         [--context]
                         [--file]
                         [--overwrite-existing]

Exemplos

Obtenha o cluster de hub kubeconfig de uma frota.

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName

Obtenha o cluster de hub kubeconfig de uma frota e salve-o em um arquivo específico.

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName -f ~/mykubeconfigfile.txt

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--context

Se especificado, substitua o nome do contexto padrão.

--file -f

Arquivo de configuração do Kubernetes a ser atualizado. Em vez disso, use "-" para imprimir YAML em stdout.

Valor padrão: ~\.kube\config
--overwrite-existing

Substitua qualquer entrada de cluster existente com o mesmo nome.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet list

Lista todas as frotas em um grupo de recursos.

az fleet list [--resource-group]

Exemplos

Liste todas as frotas com uma assinatura específica.

az fleet list

Liste todas as frotas existentes em uma assinatura e um grupo de recursos específicos.

az fleet list -g MyResourceGroup

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet reconcile

Reconcilia uma frota.

az fleet reconcile --name
                   --resource-group
                   [--no-wait]

Exemplos

Reconciliar uma frota.

az fleet reconcile -g MyFleetResourceGroup -n MyFleetName

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet show

Recebe uma frota.

az fleet show --name
              --resource-group

Exemplos

Mostre os detalhes de uma frota.

az fleet show -g MyFleetResourceGroup -n MyFleetName

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet update

Corrige um recurso de frota.

az fleet update --name
                --resource-group
                [--assign-identity]
                [--enable-managed-identity {false, true}]
                [--no-wait]
                [--tags]

Exemplos

Atualize as tags de uma frota.

az fleet update -g MyFleetResourceGroup -n MyFleetName --tags Key=Value

Atualize uma frota para usar uma identidade de serviço gerenciado atribuída pelo sistema.

az fleet update -g MyFleetResourceGroup -n MyFleetName --enable-managed-identity --tags Key=Value

Atualize uma frota para usar uma identidade de serviço gerenciado atribuída pelo usuário.

az fleet update -g MyFleetResourceGroup -n MyFleetName --enable-managed-identity --assign-identity "/subscription/00000000-0000-0000-0000-000000000000/resourcegroup/MyFleetResourceGroup/providers/Microsoft.ManagedIdentity/userAssignedIdentities/MyIdentity" --tags Key=Value

Parâmetros Exigidos

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--assign-identity

Com --enable-managed-identity, habilite a MSI (identidade gerenciada atribuída pelo usuário) no recurso Frota. Especifique o recurso de identidade atribuído pelo usuário existente.

--enable-managed-identity

Habilite a MSI (identidade gerenciada atribuída pelo sistema) no recurso de Frota.

Valores aceitos: false, true
--no-wait

Não aguarde a conclusão da operação de execução longa.

Valor padrão: False
--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as tags existentes.

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet wait

Aguarde até que um recurso de frota atinja um estado desejado.

Se uma operação na frota foi interrompida ou iniciada com --no-wait, use este comando para aguardar a conclusão.

az fleet wait --fleet-name
              --resource-group
              [--created]
              [--custom]
              [--deleted]
              [--exists]
              [--interval]
              [--timeout]
              [--updated]

Parâmetros Exigidos

--fleet-name

O nome do recurso Fleet. Obrigatória.

--resource-group -g

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

Parâmetros Opcionais

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Valor padrão: False
--custom

Aguarde até que a condição satisfaça uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Aguarde até ser excluído.

Valor padrão: False
--exists

Aguarde até que o recurso exista.

Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Valor padrão: 30
--timeout

Espera máxima em segundos.

Valor padrão: 3600
--updated

Aguarde até ser atualizado com provisioningState em 'Succeeded'.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas 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 o detalhamento do log. Use --debug para logs de depuração completos.