az k8s-configuration flux

Nota

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 as configurações do Kubernetes do Flux v2.

Comandos

Name	Description	Tipo	Estado
az k8s-configuration flux create	Crie uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux delete	Exclua uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux deployed-object	Comandos para ver objetos implantados associados às configurações do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux deployed-object list	Liste objetos implantados associados a uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux deployed-object show	Mostrar um objeto implantado associado a uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux kustomization	Comandos para gerenciar Kustomizations associadas às configurações do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux kustomization create	Crie um Kustomization associado a uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux kustomization delete	Exclua uma Kustomization associada a uma configuração do Kubernetes do Flux v2.	Extensão	GA
az k8s-configuration flux kustomization list	Listar Kustomizations 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 do Flux v2.	Extensão	GA
az k8s-configuration flux kustomization update	Atualize um Kustomization associado a uma configuração do Kubernetes Flux v2.	Extensão	GA
az k8s-configuration flux list	Liste todas as configurações do Kubernetes do 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 do Flux v2.	Extensão	GA

az k8s-configuration flux create

Crie uma configuração do Kubernetes do 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 do 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 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 de fluxo do Kubernetes v2 com o tipo de fonte 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 Obrigatórios

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

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

valores aceites: connectedClusters, managedClusters, provisionedClusters

--name -n

Nome da configuração do fluxo.

--resource-group -g

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

--url -u

URL da fonte a reconciliar.

Parâmetros Opcionais

--account-key

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

--branch

Ramificação dentro da origem 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 aceites: false, true

valor predefinido: 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

Comprometa 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 reconciliações da origem no cluster.

--kind

Fonte tipo para reconciliar.

valores aceites: azblob, bucket, git

valor predefinido: 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 do 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 predefinido: default

--no-wait

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

valor predefinido: False

--sas-token

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

--scope -s

Especifique o escopo do operador como 'namespace' ou 'cluster'.

valores aceites: cluster, namespace

valor predefinido: cluster

--semver

Intervalo Semver dentro da fonte 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 para o certificado de cliente usado 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 de cliente ao adquirir um token para habilitar a autenticação baseada no nome da entidade/emissor para o certificado do cliente.

valor predefinido: 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 a chave ssh privada para sincronização do repositório privado.

--suspend

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

valores aceites: false, true

valor predefinido: False

--tag

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

--timeout

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

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

Exclua uma configuração do Kubernetes do 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 do Flux v2

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

Parâmetros Obrigatórios

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

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

valores aceites: connectedClusters, managedClusters, provisionedClusters

--name -n

Nome da configuração do fluxo.

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

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

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

--force

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

valores aceites: false, true

valor predefinido: False

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

Liste todas as configurações do Kubernetes do 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 Obrigatórios

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

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

valores aceites: connectedClusters, managedClusters, provisionedClusters

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

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

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

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 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 Obrigatórios

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

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

valores aceites: connectedClusters, managedClusters, provisionedClusters

--name -n

Nome da configuração do fluxo.

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

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

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

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

Atualize uma configuração do Kubernetes do 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

Atualize uma configuração do Kubernetes do Flux v2 com o Bucket Source Kind 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 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 Obrigatórios

--cluster-name -c

Nome do cluster Kubernetes.

--cluster-type -t

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

valores aceites: connectedClusters, managedClusters, provisionedClusters

--name -n

Nome da configuração do fluxo.

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

--account-key

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

--branch

Ramificação dentro da origem 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 aceites: 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

Comprometa 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 reconciliações da origem no cluster.

--kind

Fonte tipo para reconciliar.

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

valor predefinido: False

--sas-token

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

--semver

Intervalo Semver dentro da fonte 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 para o certificado de cliente usado 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 de cliente ao adquirir um token para habilitar a autenticação baseada no nome da entidade/emissor para o certificado do cliente.

valor predefinido: 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 a chave ssh privada para sincronização do repositório privado.

--suspend

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

valores aceites: false, true

--tag

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

--timeout

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

--url -u

URL da fonte a reconciliar.

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