az fleet

Nota

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

Comandos

Name Description Tipo Estado
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 membro atinja o 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 da 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 Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros Opcionais

--agent-subnet-id
Pré-visualizar

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
Pré-visualizar

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

--assign-identity

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

--dns-name-prefix -p
Pré-visualizar

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 grupo de recursos.

--enable-hub
Pré-visualizar

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

valor predefinido: False
--enable-managed-identity

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

valor predefinido: False
--enable-private-cluster
Pré-visualizar

Criar o hub Fleet como um cluster privado ou não.

valor predefinido: False
--enable-vnet-integration
Pré-visualizar

Se deve ou não ativar a integração do apiserver vnet para o hub do Fleet.

valor predefinido: False
--location -l

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

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--tags

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

--vm-size
Pré-visualizar

O tamanho da máquina virtual do hub Fleet.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az fleet delete

Exclui uma frota.

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

Exemplos

Eliminar uma frota específica.

az fleet delete -g MyFleetResourceGroup -n MyFleetName

Parâmetros Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

o 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 espere que a operação de longa duração termine.

valor predefinido: False
--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

o 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. Em vez disso, use "-" para imprimir YAML para stdout.

valor predefinido: ~\.kube\config
--overwrite-existing

Substitua qualquer entrada de cluster existente com o mesmo nome.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 específica e um grupo de recursos.

az fleet list -g MyResourceGroup

Parâmetros Opcionais

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

o 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 espere que a operação de longa duração termine.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az fleet update

Corrige um recurso da 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 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 Obrigatórios

--name -n

Especifique o nome da frota.

--resource-group -g

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

--enable-managed-identity

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

valores aceites: false, true
--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--tags

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 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 Obrigatórios

--fleet-name

O nome do recurso Frota. Obrigatório.

--resource-group -g

o 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 predefinido: 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 predefinido: False
--exists

Aguarde até que o recurso exista.

valor predefinido: False
--interval

Intervalo de sondagem em segundos.

valor predefinido: 30
--timeout

Espera máxima em segundos.

valor predefinido: 3600
--updated

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

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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