Compartilhar via

az k8s-configuration flux

Note

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 instalará automaticamente na primeira vez que você executar um comando az k8s-configuration flux. Saiba mais sobre extensões.

Comandos para gerenciar as configurações do Kubernetes flux v2.

Comandos

Nome Description Tipo Status
az k8s-configuration flux create

Crie uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux delete

Exclua uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux deployed-object

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

 Extension GA
az k8s-configuration flux deployed-object list

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

 Extension GA
az k8s-configuration flux deployed-object show

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

 Extension GA
az k8s-configuration flux kustomization

Comandos para gerenciar Kustomizations associados às configurações do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux kustomization create

Crie uma Kustomization associada a uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux kustomization delete

Exclua uma Kustomization associada a uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux kustomization list

Listar Kustomizations associados a uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux kustomization show

Mostrar uma Kustomization associada a uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux kustomization update

Atualize uma Kustomization associada a uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux list

Listar todas as configurações do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux show

Mostrar uma configuração do Kubernetes flux v2.

 Extension GA
az k8s-configuration flux update

Atualize uma configuração do Kubernetes flux v2.

 Extension 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 --cluster-rp]
                                 [--commit]
                                 [--container-name]
                                 [--digest]
                                 [--https-ca-cert]
                                 [--https-ca-cert-file]
                                 [--https-key]
                                 [--https-user]
                                 [--interval --sync-interval]
                                 [--kind {azblob, bucket, git, oci}]
                                 [--known-hosts]
                                 [--known-hosts-file]
                                 [--kustomization]
                                 [--local-auth-ref --local-ref]
                                 [--managed-identity-client-id --mi-client-id]
                                 [--match-oidc-identity]
                                 [--namespace --ns]
                                 [--no-wait]
                                 [--oci-insecure {false, true}]
                                 [--oci-layer-selector-media-type --oci-media-type]
                                 [--oci-layer-selector-operation --oci-operation {copy, extract}]
                                 [--provider {azure, generic}]
                                 [--sas-token]
                                 [--scope {cluster, namespace}]
                                 [--semver]
                                 [--service-account-name]
                                 [--service-principal-client-certificate --sp-client-cert]
                                 [--service-principal-client-certificate-password --sp-cert-password]
                                 [--service-principal-client-certificate-send-chain --sp-cert-send-chain]
                                 [--service-principal-client-id --sp-client-id]
                                 [--service-principal-client-secret --sp-client-secret]
                                 [--service-principal-tenant-id --sp-tenant-id]
                                 [--ssh-private-key]
                                 [--ssh-private-key-file]
                                 [--suspend {false, true}]
                                 [--tag]
                                 [--timeout]
                                 [--tls-ca-certificate]
                                 [--tls-client-certificate]
                                 [--tls-private-key]
                                 [--use-workload-identity {false, true}]
                                 [--verification-config]
                                 [--verification-provider]

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 do Flux do Kubernetes v2 com o tipo de origem do 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 do Flux 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

Criar uma configuração flux do Kubernetes v2 com o tipo de origem OCI

az k8s-configuration flux create --resource-group my-resource-group \
--cluster-name mycluster --cluster-type connectedClusters \
--name myconfig --scope cluster --namespace my-namespace \
--kind oci --url oci://ghcr.io/owner/repo/manifests/podinfo \
--kustomization name=my-kustomization --use-workload-identity

Parâmetros Exigidos

--cluster-name -c

Nome do cluster do Kubernetes.

--cluster-type -t

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

Propriedade Valor
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

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.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--branch

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

Propriedade Valor
Grupo de parâmetros: Git Repo Ref Arguments
--bucket-access-key

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

Propriedade Valor
Grupo de parâmetros: Bucket Auth Arguments
--bucket-insecure

Comunique-se com um bucket sem TLS.

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--bucket-name

Nome do bucket S3 a ser sincronizado.

--bucket-secret-key

Chave secreta usada para autenticar com o bucket.

Propriedade Valor
Grupo de parâmetros: Bucket Auth Arguments
--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para esse clusterType (necessário para provisionedClusters).

--commit

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

Propriedade Valor
Grupo de parâmetros: Git Repo Ref Arguments
--container-name

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

--digest

Resumo do artefato OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
--https-ca-cert

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-ca-cert-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-key

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-user

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--interval --sync-interval

Tempo entre reconciliações da origem no cluster.

--kind

Tipo de origem para reconciliar.

Propriedade Valor
Valor padrão: git
Valores aceitos: azblob, bucket, git, oci
--known-hosts

Dados known_hosts codificados em Base64 que contêm chaves SSH públicas necessárias para acessar instâncias privadas do Git.

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--known-hosts-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--kustomization -k

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

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

Propriedade Valor
Grupo de parâmetros: Auth Arguments
--managed-identity-client-id --mi-client-id

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--match-oidc-identity

Lista de identidades OIDC a serem correspondentes para verificação de artefatos OCI. Cada entrada deve ser uma cadeia de caracteres JSON com campos "emissor" e "assunto".

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--namespace --ns

Namespace para implantar a configuração.

Propriedade Valor
Valor padrão: default
--no-wait

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

Propriedade Valor
Valor padrão: False
--oci-insecure

Permitir a conexão a um registro de contêiner OCI não seguro (HTTP).

Propriedade Valor
Valores aceitos: false, true
--oci-layer-selector-media-type --oci-media-type

Tipo de mídia de camada de artefato OCI a ser selecionado para extração ou cópia.

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
--oci-layer-selector-operation --oci-operation

Operação a ser executada na camada de artefato OCI selecionada: 'extrair' para extrair a camada, 'copiar' para copiar o as-is tarball (padrão: extração).

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
Valores aceitos: copy, extract
--provider

Nome do provedor usado para autenticação, o provedor do Azure pode ser usado para autenticar nos repositórios do Azure DevOps usando a Identidade Gerenciada.

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
Valores aceitos: azure, generic
--sas-token

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--scope -s

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

Propriedade Valor
Valor padrão: cluster
Valores aceitos: cluster, namespace
--semver

Intervalo semver dentro da origem git ou OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: Git Repo Ref / OCI Repo Ref Arguments
--service-account-name

Nome da conta de serviço do Kubernetes a ser usada para acessar o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--service-principal-client-certificate --sp-client-cert

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-certificate-password --sp-cert-password

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-certificate-send-chain --sp-cert-send-chain

Especifique se o cabeçalho x5c deve ser incluído nas declarações do cliente ao adquirir um token para habilitar a autenticação baseada em nome da entidade/emissor para o certificado do cliente.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
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.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-secret --sp-client-secret

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--ssh-private-key

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--ssh-private-key-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--suspend

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

Propriedade Valor
Valor padrão: False
Valores aceitos: false, true
--tag

Marque dentro da origem git ou OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: Git Repo Ref / OCI Repo Ref Arguments
--timeout

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

--tls-ca-certificate

Certificado de AC codificado em Base64 para comunicação TLS com o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--tls-client-certificate

Certificado de cliente codificado em Base64 para autenticação TLS com repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--tls-private-key

Chave privada codificada em Base64 para autenticação TLS com repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--use-workload-identity

Use a identidade da carga de trabalho para autenticação com o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
Valores aceitos: false, true
--verification-config

Um objeto que contém chaves públicas confiáveis de autores confiáveis para artefatos OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--verification-provider

Provedor usado para verificação de OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
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 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 --cluster-rp]
                                 [--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 do Kubernetes.

--cluster-type -t

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

Propriedade Valor
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

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.

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

Nome do Provedor de Recursos de Cluster para esse clusterType (necessário para provisionedClusters).

--force

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

Propriedade Valor
Valor padrão: False
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
--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 k8s-configuration flux list

Listar 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 --cluster-rp]

Exemplos

Listar configurações do Kubernetes 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 do Kubernetes.

--cluster-type -t

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

Propriedade Valor
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

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.

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

Nome do Provedor de Recursos de Cluster para esse clusterType (necessário para provisionedClusters).

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 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 --cluster-rp]

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

--cluster-type -t

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

Propriedade Valor
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

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.

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

Nome do Provedor de Recursos de Cluster para esse clusterType (necessário para provisionedClusters).

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 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 --cluster-rp]
                                 [--commit]
                                 [--container-name]
                                 [--digest]
                                 [--https-ca-cert]
                                 [--https-ca-cert-file]
                                 [--https-key]
                                 [--https-user]
                                 [--interval --sync-interval]
                                 [--kind {azblob, bucket, git, oci}]
                                 [--known-hosts]
                                 [--known-hosts-file]
                                 [--kustomization]
                                 [--local-auth-ref --local-ref]
                                 [--managed-identity-client-id --mi-client-id]
                                 [--match-oidc-identity]
                                 [--no-wait]
                                 [--oci-insecure {false, true}]
                                 [--oci-layer-selector-media-type --oci-media-type]
                                 [--oci-layer-selector-operation --oci-operation {copy, extract}]
                                 [--provider {azure, generic}]
                                 [--sas-token]
                                 [--semver]
                                 [--service-account-name]
                                 [--service-principal-client-certificate --sp-client-cert]
                                 [--service-principal-client-certificate-password --sp-cert-password]
                                 [--service-principal-client-certificate-send-chain --sp-cert-send-chain]
                                 [--service-principal-client-id --sp-client-id]
                                 [--service-principal-client-secret --sp-client-secret]
                                 [--service-principal-tenant-id --sp-tenant-id]
                                 [--ssh-private-key]
                                 [--ssh-private-key-file]
                                 [--suspend {false, true}]
                                 [--tag]
                                 [--timeout]
                                 [--tls-ca-certificate]
                                 [--tls-client-certificate]
                                 [--tls-private-key]
                                 [--url]
                                 [--use-workload-identity {false, true}]
                                 [--verification-config]
                                 [--verification-provider]
                                 [--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 do Flux v2 com o Tipo de Origem do Bucket para se conectar de forma 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 flux v2 com o Tipo de Origem do 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

Atualizar uma configuração do Kubernetes flux v2 com o Tipo de Origem OCI para usar a conexão de forma insegura

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

Parâmetros Exigidos

--cluster-name -c

Nome do cluster do Kubernetes.

--cluster-type -t

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

Propriedade Valor
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

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.

--account-key

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--branch

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

Propriedade Valor
Grupo de parâmetros: Git Repo Ref Arguments
--bucket-access-key

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

Propriedade Valor
Grupo de parâmetros: Bucket Auth Arguments
--bucket-insecure

Comunique-se com um bucket sem TLS.

Propriedade Valor
Valores aceitos: false, true
--bucket-name

Nome do bucket S3 a ser sincronizado.

--bucket-secret-key

Chave secreta usada para autenticar com o bucket.

Propriedade Valor
Grupo de parâmetros: Bucket Auth Arguments
--cluster-resource-provider --cluster-rp

Nome do Provedor de Recursos de Cluster para esse clusterType (necessário para provisionedClusters).

--commit

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

Propriedade Valor
Grupo de parâmetros: Git Repo Ref Arguments
--container-name

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

--digest

Resumo do artefato OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
--https-ca-cert

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-ca-cert-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-key

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--https-user

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--interval --sync-interval

Tempo entre reconciliações da origem no cluster.

--kind

Tipo de origem para reconciliar.

Propriedade Valor
Valores aceitos: azblob, bucket, git, oci
--known-hosts

Dados known_hosts codificados em Base64 que contêm chaves SSH públicas necessárias para acessar instâncias privadas do Git.

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--known-hosts-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--kustomization -k

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

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

Propriedade Valor
Grupo de parâmetros: Auth Arguments
--managed-identity-client-id --mi-client-id

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--match-oidc-identity

Lista de identidades OIDC a serem correspondentes para verificação de artefatos OCI. Cada entrada deve ser uma cadeia de caracteres JSON com campos "emissor" e "assunto".

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--no-wait

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

Propriedade Valor
Valor padrão: False
--oci-insecure

Permitir a conexão a um registro de contêiner OCI não seguro (HTTP).

Propriedade Valor
Valores aceitos: false, true
--oci-layer-selector-media-type --oci-media-type

Tipo de mídia de camada de artefato OCI a ser selecionado para extração ou cópia.

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
--oci-layer-selector-operation --oci-operation

Operação a ser executada na camada de artefato OCI selecionada: 'extrair' para extrair a camada, 'copiar' para copiar o as-is tarball (padrão: extração).

Propriedade Valor
Grupo de parâmetros: OCI Repo Ref Arguments
Valores aceitos: copy, extract
--provider

Nome do provedor usado para autenticação, o provedor do Azure pode ser usado para autenticar nos repositórios do Azure DevOps usando a Identidade Gerenciada.

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
Valores aceitos: azure, generic
--sas-token

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--semver

Intervalo semver dentro da origem git ou OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: Git Repo Ref / OCI Repo Ref Arguments
--service-account-name

Nome da conta de serviço do Kubernetes a ser usada para acessar o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--service-principal-client-certificate --sp-client-cert

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-certificate-password --sp-cert-password

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-certificate-send-chain --sp-cert-send-chain

Especifique se o cabeçalho x5c deve ser incluído nas declarações do cliente ao adquirir um token para habilitar a autenticação baseada em nome da entidade/emissor para o certificado do cliente.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
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.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--service-principal-client-secret --sp-client-secret

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

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--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.

Propriedade Valor
Grupo de parâmetros: Azure Blob Auth Arguments
--ssh-private-key

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--ssh-private-key-file

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

Propriedade Valor
Grupo de parâmetros: Git Auth Arguments
--suspend

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

Propriedade Valor
Valores aceitos: false, true
--tag

Marque dentro da origem git ou OCI para reconciliar com o cluster.

Propriedade Valor
Grupo de parâmetros: Git Repo Ref / OCI Repo Ref Arguments
--timeout

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

--tls-ca-certificate

Certificado de AC codificado em Base64 para comunicação TLS com o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--tls-client-certificate

Certificado de cliente codificado em Base64 para autenticação TLS com repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--tls-private-key

Chave privada codificada em Base64 para autenticação TLS com repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--url -u

URL da origem a ser reconciliada.

--use-workload-identity

Use a identidade da carga de trabalho para autenticação com o repositório OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
Valores aceitos: false, true
--verification-config

Um objeto que contém chaves públicas confiáveis de autores confiáveis para artefatos OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--verification-provider

Provedor usado para verificação de OCI.

Propriedade Valor
Grupo de parâmetros: OCI Repository Auth Arguments
--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