Compartilhar via

az k8s-configuration flux

  • Referência

Observação

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

Comandos para gerenciar configurações do Flux v2 Kubernetes.

Comandos

Nome Description Tipo Status
az k8s-configuration flux create

Crie uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux delete

Exclua uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux deployed-object

Comandos para ver objetos implantados associados às configurações do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux deployed-object list

Listar objetos implantados associados a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux deployed-object show

Mostrar um objeto implantado associado a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization

Comandos para gerenciar Kustomizations associadas às configurações do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization create

Crie uma Kustomização associada a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization delete

Exclua uma Kustomização associada a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization list

Listar Kustomizações associadas a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization show

Mostrar uma Kustomização associada a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux kustomization update

Atualize uma Kustomização associada a uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux list

Liste todas as configurações do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux show

Mostrar uma configuração do Kubernetes Flux v2.

 Extensão GA
az k8s-configuration flux update

Atualize uma configuração do Kubernetes Flux v2.

 Extensão GA

az k8s-configuration flux create

Crie uma configuração do Kubernetes Flux v2.

az k8s-configuration flux create --cluster-name
                                 --cluster-type {connectedClusters, managedClusters, provisionedClusters}
                                 --name
                                 --resource-group
                                 --url
                                 [--account-key]
                                 [--branch]
                                 [--bucket-access-key]
                                 [--bucket-insecure {false, true}]
                                 [--bucket-name]
                                 [--bucket-secret-key]
                                 [--cluster-resource-provider]
                                 [--commit]
                                 [--container-name]
                                 [--https-ca-cert]
                                 [--https-ca-cert-file]
                                 [--https-key]
                                 [--https-user]
                                 [--interval]
                                 [--kind {azblob, bucket, git}]
                                 [--known-hosts]
                                 [--known-hosts-file]
                                 [--kustomization]
                                 [--local-auth-ref]
                                 [--managed-identity-client-id]
                                 [--namespace]
                                 [--no-wait]
                                 [--sas-token]
                                 [--scope {cluster, namespace}]
                                 [--semver]
                                 [--service-principal-client-certificate]
                                 [--service-principal-client-certificate-password]
                                 [--service-principal-client-certificate-send-chain]
                                 [--service-principal-client-id]
                                 [--service-principal-client-secret]
                                 [--service-principal-tenant-id]
                                 [--ssh-private-key]
                                 [--ssh-private-key-file]
                                 [--suspend {false, true}]
                                 [--tag]
                                 [--timeout]

Exemplos

Criar uma configuração do Kubernetes Flux v2

az k8s-configuration flux create --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters \
--name myconfig --scope cluster --namespace my-namespace \
--kind git --url https://github.com/Azure/arc-k8s-demo \
--branch main --kustomization name=my-kustomization

Criar uma configuração de fluxo do Kubernetes v2 com tipo de origem de bucket

az k8s-configuration flux create --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters \
--name myconfig --scope cluster --namespace my-namespace \
--kind bucket --url https://bucket-provider.minio.io \
--bucket-name my-bucket --kustomization name=my-kustomization \
--bucket-access-key my-access-key --bucket-secret-key my-secret-key

Criar uma configuração de fluxo do Kubernetes v2 com o tipo de origem de Blob do Azure

az k8s-configuration flux create --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters \
--name myconfig --scope cluster --namespace my-namespace \
--kind azblob --url https://mystorageaccount.blob.core.windows.net \
--container-name my-container --kustomization name=my-kustomization \
--account-key my-account-key

Parâmetros Exigidos

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

Especifique clusters conectados ao Arc ou clusters gerenciados pelo AKS ou clusters provisionados.

valores aceitos: connectedClusters, managedClusters, provisionedClusters
--name -n

Nome da configuração do fluxo.

--resource-group -g

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

--url -u

URL da origem a ser reconciliada.

Parâmetros Opcionais

--account-key

A Chave Compartilhada de Blob do Azure para autenticação.

--branch

Ramificação dentro da origem do git para reconciliar com o cluster.

--bucket-access-key

ID da chave de acesso usada para autenticar com o bucket.

--bucket-insecure

Comunique-se com um bucket sem TLS.

valores aceitos: false, true
valor padrão: False
--bucket-name

Nome do bucket do S3 a ser sincronizado.

--bucket-secret-key

Chave secreta usada para autenticar com o bucket.

--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para este clusterType (Necessário para provisionedClusters).

--commit

Confirme dentro da origem do git para reconciliar com o cluster.

--container-name

Nome do contêiner de Armazenamento de Blobs do Azure a ser sincronizado.

--https-ca-cert

Certificado de CA HTTPS codificado em Base64 para comunicação TLS com sincronização de repositório privado.

--https-ca-cert-file

Caminho do arquivo para o arquivo de certificado de CA HTTPS para comunicação TLS com sincronização de repositório privado.

--https-key

Token/senha HTTPS para sincronização de repositório privado.

--https-user

Nome de usuário HTTPS para sincronização de repositório privado.

--interval --sync-interval

Tempo entre as reconciliações da origem no cluster.

--kind

Tipo de origem a ser reconciliado.

valores aceitos: azblob, bucket, git
valor padrão: git
--known-hosts

Dados de known_hosts codificados em Base64 contendo chaves SSH públicas necessárias para acessar instâncias privadas do Git.

--known-hosts-file

Caminho do arquivo para known_hosts conteúdo contendo chaves SSH públicas necessárias para acessar instâncias privadas do Git.

--kustomization -k

Defina kustomizations para sincronizar fontes com parâmetros ['name', 'path', 'depends_on', 'timeout', 'sync_interval', 'retry_interval', 'prune', 'force'].

--local-auth-ref --local-ref

Referência local a um segredo kubernetes no namespace de configuração a ser usado para comunicação com a origem.

--managed-identity-client-id --mi-client-id

A ID do cliente da identidade gerenciada para autenticação com o Blob do Azure.

--namespace --ns

Namespace para implantar a configuração.

valor padrão: default
--no-wait

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

valor padrão: False
--sas-token

O Token SAS de Blob do Azure para autenticação.

--scope -s

Especifique o escopo do operador para ser 'namespace' ou 'cluster'.

valores aceitos: cluster, namespace
valor padrão: cluster
--semver

Intervalo Semver dentro da origem do git para reconciliar com o cluster.

--service-principal-client-certificate --sp-client-cert

O certificado de cliente codificado em Base64 para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-client-certificate-password --sp-cert-password

A senha do certificado de cliente usada para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-client-certificate-send-chain --sp-cert-send-chain

Especifique se deseja incluir o cabeçalho x5c nas declarações do cliente ao adquirir um token para habilitar a autenticação baseada no nome da entidade/emissor para o certificado do cliente.

valor padrão: False
--service-principal-client-id --sp-client-id

A ID do cliente para autenticar uma entidade de serviço com o Blob do Azure, necessária para esse método de autenticação.

--service-principal-client-secret --sp-client-secret

O segredo do cliente para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-tenant-id --sp-tenant-id

A ID do locatário para autenticar uma entidade de serviço com o Blob do Azure, necessária para esse método de autenticação.

--ssh-private-key

Chave ssh privada codificada em Base64 para sincronização de repositório privado.

--ssh-private-key-file

Caminho do arquivo para chave ssh privada para sincronização de repositório privado.

--suspend

Suspenda a reconciliação da origem e kustomizations associadas a essa configuração.

valores aceitos: false, true
valor padrão: False
--tag

Tag dentro da origem do git para reconciliar com o cluster.

--timeout

Tempo máximo para reconciliar a origem antes do tempo limite.

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 k8s-configuration flux delete

Exclua uma configuração do Kubernetes Flux v2.

az k8s-configuration flux delete --cluster-name
                                 --cluster-type {connectedClusters, managedClusters, provisionedClusters}
                                 --name
                                 --resource-group
                                 [--cluster-resource-provider]
                                 [--force {false, true}]
                                 [--no-wait]
                                 [--yes]

Exemplos

Excluir uma configuração existente do Kubernetes Flux v2

az k8s-configuration flux delete --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters --name myconfig

Parâmetros Exigidos

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

Especifique clusters conectados ao Arc ou clusters gerenciados pelo AKS ou clusters provisionados.

valores aceitos: connectedClusters, managedClusters, provisionedClusters
--name -n

Nome da configuração do fluxo.

--resource-group -g

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

Parâmetros Opcionais

--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para este clusterType (Necessário para provisionedClusters).

--force

Forçar a exclusão da configuração de fluxo do cluster.

valores aceitos: false, true
valor padrão: False
--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 k8s-configuration flux list

Liste todas as configurações do Kubernetes Flux v2.

az k8s-configuration flux list --cluster-name
                               --cluster-type {connectedClusters, managedClusters, provisionedClusters}
                               --resource-group
                               [--cluster-resource-provider]

Exemplos

Listar configurações do Kubernetes do Flux v2 em um cluster

az k8s-configuration flux list --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters

Parâmetros Exigidos

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

Especifique clusters conectados ao Arc ou clusters gerenciados pelo AKS ou clusters provisionados.

valores aceitos: connectedClusters, managedClusters, provisionedClusters
--resource-group -g

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

Parâmetros Opcionais

--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para este clusterType (Necessário para provisionedClusters).

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 k8s-configuration flux show

Mostrar uma configuração do Kubernetes Flux v2.

az k8s-configuration flux show --cluster-name
                               --cluster-type {connectedClusters, managedClusters, provisionedClusters}
                               --name
                               --resource-group
                               [--cluster-resource-provider]

Exemplos

Mostrar detalhes de uma configuração do Kubernetes Flux v2

az k8s-configuration flux show --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters --name myconfig

Parâmetros Exigidos

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

Especifique clusters conectados ao Arc ou clusters gerenciados pelo AKS ou clusters provisionados.

valores aceitos: connectedClusters, managedClusters, provisionedClusters
--name -n

Nome da configuração do fluxo.

--resource-group -g

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

Parâmetros Opcionais

--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para este clusterType (Necessário para provisionedClusters).

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 k8s-configuration flux update

Atualize uma configuração do Kubernetes Flux v2.

az k8s-configuration flux update --cluster-name
                                 --cluster-type {connectedClusters, managedClusters, provisionedClusters}
                                 --name
                                 --resource-group
                                 [--account-key]
                                 [--branch]
                                 [--bucket-access-key]
                                 [--bucket-insecure {false, true}]
                                 [--bucket-name]
                                 [--bucket-secret-key]
                                 [--cluster-resource-provider]
                                 [--commit]
                                 [--container-name]
                                 [--https-ca-cert]
                                 [--https-ca-cert-file]
                                 [--https-key]
                                 [--https-user]
                                 [--interval]
                                 [--kind {azblob, bucket, git}]
                                 [--known-hosts]
                                 [--known-hosts-file]
                                 [--kustomization]
                                 [--local-auth-ref]
                                 [--managed-identity-client-id]
                                 [--no-wait]
                                 [--sas-token]
                                 [--semver]
                                 [--service-principal-client-certificate]
                                 [--service-principal-client-certificate-password]
                                 [--service-principal-client-certificate-send-chain]
                                 [--service-principal-client-id]
                                 [--service-principal-client-secret]
                                 [--service-principal-tenant-id]
                                 [--ssh-private-key]
                                 [--ssh-private-key-file]
                                 [--suspend {false, true}]
                                 [--tag]
                                 [--timeout]
                                 [--url]
                                 [--yes]

Exemplos

Atualizar uma configuração do Kubernetes Flux v2

az k8s-configuration flux update --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters --name myconfig \
--url https://github.com/Azure/arc-k8s-demo --branch main \
--kustomization name=my-kustomization path=./my/new-path

Atualizar uma configuração do Kubernetes Flux v2 com o Tipo de Origem do Bucket para conexão insegura

az k8s-configuration flux update --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters --name myconfig \
--bucket-insecure

Atualizar uma configuração do Kubernetes do Flux v2 com o Tipo de Origem de Blob do Azure com outro nome de contêiner

az k8s-configuration flux update --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters --name myconfig \
--container-name other-container

Parâmetros Exigidos

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

Especifique clusters conectados ao Arc ou clusters gerenciados pelo AKS ou clusters provisionados.

valores aceitos: connectedClusters, managedClusters, provisionedClusters
--name -n

Nome da configuração do fluxo.

--resource-group -g

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

Parâmetros Opcionais

--account-key

A Chave Compartilhada de Blob do Azure para autenticação.

--branch

Ramificação dentro da origem do git para reconciliar com o cluster.

--bucket-access-key

ID da chave de acesso usada para autenticar com o bucket.

--bucket-insecure

Comunique-se com um bucket sem TLS.

valores aceitos: false, true
--bucket-name

Nome do bucket do S3 a ser sincronizado.

--bucket-secret-key

Chave secreta usada para autenticar com o bucket.

--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para este clusterType (Necessário para provisionedClusters).

--commit

Confirme dentro da origem do git para reconciliar com o cluster.

--container-name

Nome do contêiner de Armazenamento de Blobs do Azure a ser sincronizado.

--https-ca-cert

Certificado de CA HTTPS codificado em Base64 para comunicação TLS com sincronização de repositório privado.

--https-ca-cert-file

Caminho do arquivo para o arquivo de certificado de CA HTTPS para comunicação TLS com sincronização de repositório privado.

--https-key

Token/senha HTTPS para sincronização de repositório privado.

--https-user

Nome de usuário HTTPS para sincronização de repositório privado.

--interval --sync-interval

Tempo entre as reconciliações da origem no cluster.

--kind

Tipo de origem a ser reconciliado.

valores aceitos: azblob, bucket, git
--known-hosts

Dados de known_hosts codificados em Base64 contendo chaves SSH públicas necessárias para acessar instâncias privadas do Git.

--known-hosts-file

Caminho do arquivo para known_hosts conteúdo contendo chaves SSH públicas necessárias para acessar instâncias privadas do Git.

--kustomization -k

Defina kustomizations para sincronizar fontes com parâmetros ['name', 'path', 'depends_on', 'timeout', 'sync_interval', 'retry_interval', 'prune', 'force'].

--local-auth-ref --local-ref

Referência local a um segredo kubernetes no namespace de configuração a ser usado para comunicação com a origem.

--managed-identity-client-id --mi-client-id

A ID do cliente da identidade gerenciada para autenticação com o Blob do Azure.

--no-wait

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

valor padrão: False
--sas-token

O Token SAS de Blob do Azure para autenticação.

--semver

Intervalo Semver dentro da origem do git para reconciliar com o cluster.

--service-principal-client-certificate --sp-client-cert

O certificado de cliente codificado em Base64 para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-client-certificate-password --sp-cert-password

A senha do certificado de cliente usada para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-client-certificate-send-chain --sp-cert-send-chain

Especifique se deseja incluir o cabeçalho x5c nas declarações do cliente ao adquirir um token para habilitar a autenticação baseada no nome da entidade/emissor para o certificado do cliente.

valor padrão: False
--service-principal-client-id --sp-client-id

A ID do cliente para autenticar uma entidade de serviço com o Blob do Azure, necessária para esse método de autenticação.

--service-principal-client-secret --sp-client-secret

O segredo do cliente para autenticar uma entidade de serviço com o Blob do Azure.

--service-principal-tenant-id --sp-tenant-id

A ID do locatário para autenticar uma entidade de serviço com o Blob do Azure, necessária para esse método de autenticação.

--ssh-private-key

Chave ssh privada codificada em Base64 para sincronização de repositório privado.

--ssh-private-key-file

Caminho do arquivo para chave ssh privada para sincronização de repositório privado.

--suspend

Suspenda a reconciliação da origem e kustomizations associadas a essa configuração.

valores aceitos: false, true
--tag

Tag dentro da origem do git para reconciliar com o cluster.

--timeout

Tempo máximo para reconciliar a origem antes do tempo limite.

--url -u

URL da origem a ser reconciliada.

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