az fleet

Observação

Essa referência faz parte da extensão de frota da CLI do Azure (versão 2.48.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 de hub da frota.

Extensão GA
az fleet list

Lista todas as frotas dentro de 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

Atualizar 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

Obtém 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 o 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 o estado desejado.

Extensão GA
az fleet wait

Aguarde até que um recurso da frota atinja o 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 hubful.

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 ao 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 ao 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
Versão Prévia

A ID da sub-rede à qual o nó do hub do Fleet ingressará na inicialização. Se isso não for especificado, uma vnet e uma sub-rede serão geradas e usadas.

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

A sub-rede a ser usada quando a integração vnet apiserver estiver habilitada. É necessário ao criar uma nova frota com BYO vnet.

--assign-identity

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

--dns-name-prefix -p
Versão Prévia

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

--enable-hub
Versão Prévia

Se definido, o Fleet será criado com um cluster de hub.

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

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

valor padrão: False
--enable-private-cluster
Versão Prévia

Se o hub do Fleet deve ser criado como um cluster privado ou não.

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

Se deve habilitar a integração apiserver vnet para o hub Fleet 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
Versão Prévia

O tamanho da máquina virtual do hub Fleet.

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

Excluir 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 de hub da frota.

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

Exemplos

Obtenha o kubeconfig do cluster de hub de uma frota.

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName

Obtenha o kubeconfig do cluster de hub 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 de contexto padrão.

--file -f

Arquivo de configuração do Kubernetes a ser atualizado. Use "-" para imprimir YAML para 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 dentro de 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 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

Obtém uma frota.

az fleet show --name
              --resource-group

Exemplos

Mostrar 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

Atualizar 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 ao 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 ao 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 identidade gerenciada (MSI) atribuída ao usuário no recurso Frota. Especifique o recurso de identidade atribuído ao usuário existente.

--enable-managed-identity

Habilite a identidade gerenciada (MSI) atribuída ao sistema no recurso 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 da frota atinja o estado desejado.

Se uma operação na frota foi interrompida ou foi iniciada com --no-waito , 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 Frota. 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é criar 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é que seja 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.