Compartilhar via


az fleet

Note

Essa referência faz parte da extensão de frota da CLI do Azure (versão 2.61.0 ou superior). A extensão instalará 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 autoupgradeprofile

Comandos para gerenciar perfis de atualização automática.

Extension GA
az fleet autoupgradeprofile create

Cria ou atualiza um perfil de atualização automática.

Extension GA
az fleet autoupgradeprofile delete

Exclui um perfil de atualização automática.

Extension GA
az fleet autoupgradeprofile generate-update-run

Gera uma execução de atualização para um determinado perfil de atualização automática.

Extension GA
az fleet autoupgradeprofile list

Lista todos os perfis de atualização automática para uma determinada frota.

Extension GA
az fleet autoupgradeprofile show

Mostra um perfil de atualização automática.

Extension GA
az fleet autoupgradeprofile wait

Aguarde até que um recurso de atualização automática atinja um estado desejado.

Extension GA
az fleet create

Cria ou atualiza uma frota.

Extension GA
az fleet delete

Exclui uma frota.

Extension GA
az fleet gate

Comandos para gerenciar portões.

Extension Preview
az fleet gate approve

Aprova uma porta e define o estado do portão como Concluído. Isso modifica o estado do portão da mesma forma que o comando de atualização de uso geral, no entanto, é mais simples de usar.

Extension Preview
az fleet gate list

Lista todos os portões sob uma frota.

Extension Preview
az fleet gate show

Mostra uma porta específica.

Extension Preview
az fleet gate update

Atualiza um portão. Atualmente, somente o estado do portão pode ser atualizado. Os valores válidos são ('Concluído').

Extension Preview
az fleet get-credentials

Para frotas hubful, obtém o kubeconfig para o cluster de hub da frota. Para membros da frota, obtém kubeconfig do cluster gerenciado do membro.

Extension GA
az fleet list

Lista todas as frotas.

Extension GA
az fleet member

Comandos para gerenciar membros.

Extension GA
az fleet member create

Cria ou atualiza um membro.

Extension GA
az fleet member delete

Exclui um membro da frota.

Extension GA
az fleet member list

Lista os membros de uma frota.

Extension GA
az fleet member reconcile

Reconcilia um membro.

Extension GA
az fleet member show

Obtém um membro da frota.

Extension GA
az fleet member update

Atualize um membro.

Extension GA
az fleet member wait

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

Extension GA
az fleet namespace

Comandos para gerenciar namespaces gerenciados pela frota.

Extension Preview
az fleet namespace create

Cria um namespace gerenciado por frota.

Extension Preview
az fleet namespace delete

Exclui um namespace gerenciado pela frota.

Extension Preview
az fleet namespace get-credentials

Obtenha kubeconfig para um namespace de frota, com o contexto de namespace pré-configurado.

Extension Preview
az fleet namespace list

Lista os namespaces gerenciados de uma frota.

Extension Preview
az fleet namespace show

Obtém um namespace gerenciado pela frota.

Extension Preview
az fleet namespace update

Atualiza um namespace gerenciado pela frota.

Extension Preview
az fleet namespace wait

Aguarde até que um namespace gerenciado pela frota atinja um estado desejado.

Extension Preview
az fleet reconcile

Reconcilia uma frota.

Extension GA
az fleet show

Obtém uma frota.

Extension GA
az fleet update

Remenda um recurso de frota.

Extension GA
az fleet updaterun

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

Extension GA
az fleet updaterun create

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

Extension GA
az fleet updaterun delete

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

Extension GA
az fleet updaterun list

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

Extension GA
az fleet updaterun show

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

Extension GA
az fleet updaterun skip

Define os destinos a serem ignorados em um UpdateRun.

Extension GA
az fleet updaterun start

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

Extension GA
az fleet updaterun stop

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

Extension GA
az fleet updaterun wait

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

Extension GA
az fleet updatestrategy

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

Extension GA
az fleet updatestrategy create

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

Extension GA
az fleet updatestrategy delete

Exclui uma estratégia de atualização.

Extension GA
az fleet updatestrategy list

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

Extension GA
az fleet updatestrategy show

Mostra uma estratégia de atualização.

Extension GA
az fleet updatestrategy wait

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

Extension GA
az fleet wait

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

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--agent-subnet-id

A ID da sub-rede na qual o nó do Hub fleet ingressará na inicialização.

--apiserver-subnet-id

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

--assign-identity

Com --enable-managed-identity, habilite a MSI (identidade gerenciada) atribuída pelo usuário no recurso Fleet especificando a ID de 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 o cluster gerenciado e os nomes do grupo de recursos.

--enable-hub

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

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

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

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

Se o Hub fleet deve ser criado como um cluster privado ou não.

Propriedade Valor
Valor padrão: False
--enable-vnet-integration

Se deseja habilitar a integração de vnet do apiserver para o Hub fleet ou não.

Propriedade Valor
Valor padrão: False
--location -l

Location. 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 prolongada.

Propriedade Valor
Valor padrão: False
--tags

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

--vm-size

O tamanho da máquina virtual do Hub fleet.

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

Propriedade Valor
Valor padrão: False
--yes -y

Não solicite confirmação.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az fleet get-credentials

Para frotas hubful, obtém o kubeconfig para o cluster de hub da frota. Para membros da frota, obtém kubeconfig do cluster gerenciado do membro.

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

Exemplos

Obtenha o kubeconfig do cluster de hub de uma frota.

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName

Obtenha um kubeconfig de 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

Obtenha kubeconfig do cluster gerenciado de um membro da frota específico.

az fleet get-credentials -g MyFleetResourceGroup -n MyFleetName --member MyFleetMember

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 em stdout.

Propriedade Valor
Valor padrão: ~\.kube\config
--member -m

Especifique o nome do membro da frota para obter credenciais de seu cluster gerenciado associado.

--overwrite-existing

Substitua qualquer entrada de cluster existente com o mesmo nome.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az fleet list

Lista todas as frotas.

az fleet list [--resource-group]

Exemplos

Liste todas as frotas em sua assinatura atual.

az fleet list

Liste todas as frotas que existem em sua assinatura atual e no grupo de recursos escolhido.

az fleet list -g MyResourceGroup

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

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

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az fleet show

Obtém 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az fleet update

Remenda um recurso de frota.

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

Exemplos

Atualize as marcas de uma frota.

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

Atualize uma frota para usar uma identidade de serviço gerenciada 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 gerenciada 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

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--assign-identity

Com --enable-managed-identity, habilite a MSI (identidade gerenciada) atribuída pelo usuário no recurso Fleet. 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 Fleet.

Propriedade Valor
Valores aceitos: false, true
--no-wait

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

Propriedade Valor
Valor padrão: False
--tags

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

Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

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

--resource-group -g

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--custom

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

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
--deleted

Aguarde até ser excluído.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--exists

Aguarde até que o recurso exista.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
--interval

Intervalo de sondagem em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 30
--timeout

Espera máxima em segundos.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: 3600
--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade Valor
Grupo de parâmetros: Wait Condition Arguments
Valor padrão: False
Parâmetros Globais
--debug

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False