az k8s-configuration flux

Nota:

Esta referencia forma parte de la extensión k8s-configuration para la CLI de Azure (versión 2.15.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az k8s-configuration flux . Obtenga más información sobre las extensiones.

Comandos para administrar configuraciones de Kubernetes de Flux v2.

Comandos

Nombre	Description	Tipo	Estado
az k8s-configuration flux create	Cree una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux delete	Elimine una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux deployed-object	Comandos para ver los objetos implementados asociados a las configuraciones de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux deployed-object list	Enumerar los objetos implementados asociados a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux deployed-object show	Mostrar un objeto implementado asociado a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization	Comandos para administrar kustomizations asociados a las configuraciones de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization create	Cree una kustomización asociada a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization delete	Elimine una kustomización asociada a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization list	Enumeración de kustomizations asociadas a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization show	Mostrar una kustomización asociada a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux kustomization update	Actualice una kustomización asociada a una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux list	Enumere todas las configuraciones de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux show	Mostrar una configuración de Kubernetes de Flux v2.	Extensión	GA
az k8s-configuration flux update	Actualice una configuración de Kubernetes de Flux v2.	Extensión	GA

az k8s-configuration flux create

Cree una configuración de Kubernetes de 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]

Ejemplos

Creación de una configuración de Kubernetes de 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

Creación de una configuración de Flujo de Kubernetes v2 con tipo de origen de cubo

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

Creación de una configuración de Flux de Kubernetes v2 con el tipo de origen de blobs de 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 requeridos

--cluster-name -c

Nombre del clúster de Kubernetes.

--cluster-type -t

Especifique clústeres conectados a Arc o clústeres administrados de AKS o clústeres aprovisionados.

valores aceptados: connectedClusters, managedClusters, provisionedClusters

--name -n

Nombre de la configuración de flux.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--url -u

Dirección URL del origen que se va a conciliar.

Parámetros opcionales

--account-key

Clave compartida de blobs de Azure para la autenticación.

--branch

Bifurcación dentro del origen de Git para conciliar con el clúster.

--bucket-access-key

Id. de clave de acceso que se usa para autenticarse con el cubo.

--bucket-insecure

Comunicarse con un cubo sin TLS.

valores aceptados: false, true

valor predeterminado: False

--bucket-name

Nombre del cubo S3 que se va a sincronizar.

--bucket-secret-key

Clave secreta usada para autenticarse con el cubo.

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

Nombre del proveedor de recursos de clúster para este clusterType (obligatorio para provisionedClusters).

--commit

Confirme el origen de Git para conciliarlo con el clúster.

--container-name

Nombre del contenedor de Azure Blob Storage que se va a sincronizar.

--https-ca-cert

Certificado de CA HTTPS codificado en Base64 para la comunicación TLS con sincronización de repositorio privado.

--https-ca-cert-file

Ruta de acceso de archivo al archivo de certificado de CA HTTPS para la comunicación TLS con la sincronización del repositorio privado.

--https-key

Token/contraseña HTTPS para la sincronización del repositorio privado.

--https-user

Nombre de usuario HTTPS para la sincronización del repositorio privado.

--interval --sync-interval

Tiempo entre conciliaciones del origen en el clúster.

--kind

Tipo de origen que debe conciliarse.

valores aceptados: azblob, bucket, git

valor predeterminado: git

--known-hosts

Codificado en Base64 known_hosts datos que contienen claves SSH públicas necesarias para acceder a instancias privadas de Git.

--known-hosts-file

Ruta de acceso de archivo a known_hosts contenido que contiene claves SSH públicas necesarias para acceder a instancias privadas de Git.

--kustomization -k

Defina kustomizations para sincronizar orígenes con parámetros ['name', 'path', 'depends_on', 'timeout', 'sync_interval', 'retry_interval', 'prune', 'force'].

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

Referencia local a un secreto de Kubernetes en el espacio de nombres de configuración que se va a usar para la comunicación con el origen.

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

Identificador de cliente de la identidad administrada para la autenticación con Azure Blob.

--namespace --ns

Espacio de nombres para implementar la configuración.

valor predeterminado: default

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--sas-token

Token de SAS de Azure Blob para la autenticación.

--scope -s

Especifique el ámbito del operador para que sea "espacio de nombres" o "clúster".

valores aceptados: cluster, namespace

valor predeterminado: cluster

--semver

Intervalo de semver dentro del origen de Git para conciliar con el clúster.

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

El certificado de cliente codificado en Base64 para autenticar una entidad de servicio con Azure Blob.

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

Contraseña del certificado de cliente que se usa para autenticar una entidad de servicio con Azure Blob.

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

Especifique si se debe incluir el encabezado x5c en las notificaciones de cliente al adquirir un token para habilitar la autenticación basada en el nombre del firmante o emisor para el certificado de cliente.

valor predeterminado: False

--service-principal-client-id --sp-client-id

El identificador de cliente para autenticar una entidad de servicio con Azure Blob, necesario para este método de autenticación.

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

Secreto de cliente para autenticar una entidad de servicio con Azure Blob.

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

Identificador de inquilino para autenticar una entidad de servicio con Azure Blob, necesario para este método de autenticación.

--ssh-private-key

Clave ssh privada codificada en Base64 para la sincronización del repositorio privado.

--ssh-private-key-file

Ruta de acceso de archivo a la clave SSH privada para la sincronización del repositorio privado.

--suspend

Suspenda la conciliación de los orígenes y kustomizations asociados a esta configuración.

valores aceptados: false, true

valor predeterminado: False

--tag

Etiqueta dentro del origen de Git para conciliar con el clúster.

--timeout

Tiempo máximo para conciliar el origen antes de que se agote el tiempo de espera.

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az k8s-configuration flux delete

Elimine una configuración de Kubernetes de 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]

Ejemplos

Eliminación de una configuración de Kubernetes de Flux v2 existente

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

Parámetros requeridos

--cluster-name -c

Nombre del clúster de Kubernetes.

--cluster-type -t

Especifique clústeres conectados a Arc o clústeres administrados de AKS o clústeres aprovisionados.

valores aceptados: connectedClusters, managedClusters, provisionedClusters

--name -n

Nombre de la configuración de flux.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Nombre del proveedor de recursos de clúster para este clusterType (obligatorio para provisionedClusters).

--force

Forzar la eliminación de la configuración de flujo del clúster.

valores aceptados: false, true

valor predeterminado: False

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--yes -y

No solicita confirmación.

valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az k8s-configuration flux list

Enumere todas las configuraciones de Kubernetes de Flux v2.

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

Ejemplos

Enumeración de configuraciones de Kubernetes de Flux v2 en un clúster

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

Parámetros requeridos

--cluster-name -c

Nombre del clúster de Kubernetes.

--cluster-type -t

Especifique clústeres conectados a Arc o clústeres administrados de AKS o clústeres aprovisionados.

valores aceptados: connectedClusters, managedClusters, provisionedClusters

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Nombre del proveedor de recursos de clúster para este clusterType (obligatorio para provisionedClusters).

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az k8s-configuration flux show

Mostrar una configuración de Kubernetes de Flux v2.

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

Ejemplos

Mostrar detalles de una configuración de Kubernetes de Flux v2

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

Parámetros requeridos

--cluster-name -c

Nombre del clúster de Kubernetes.

--cluster-type -t

Especifique clústeres conectados a Arc o clústeres administrados de AKS o clústeres aprovisionados.

valores aceptados: connectedClusters, managedClusters, provisionedClusters

--name -n

Nombre de la configuración de flux.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Nombre del proveedor de recursos de clúster para este clusterType (obligatorio para provisionedClusters).

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az k8s-configuration flux update

Actualice una configuración de Kubernetes de 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]

Ejemplos

Actualización de una configuración de Kubernetes de 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

Actualización de una configuración de Kubernetes de Flux v2 con bucket Source Kind para conectarse de forma no segura

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

Actualización de una configuración de Kubernetes de Flux v2 con el tipo de origen de blobs de Azure con otro nombre de contenedor

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

Parámetros requeridos

--cluster-name -c

Nombre del clúster de Kubernetes.

--cluster-type -t

Especifique clústeres conectados a Arc o clústeres administrados de AKS o clústeres aprovisionados.

valores aceptados: connectedClusters, managedClusters, provisionedClusters

--name -n

Nombre de la configuración de flux.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--account-key

Clave compartida de blobs de Azure para la autenticación.

--branch

Bifurcación dentro del origen de Git para conciliar con el clúster.

--bucket-access-key

Id. de clave de acceso que se usa para autenticarse con el cubo.

--bucket-insecure

Comunicarse con un cubo sin TLS.

valores aceptados: false, true

--bucket-name

Nombre del cubo S3 que se va a sincronizar.

--bucket-secret-key

Clave secreta usada para autenticarse con el cubo.

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

Nombre del proveedor de recursos de clúster para este clusterType (obligatorio para provisionedClusters).

--commit

Confirme el origen de Git para conciliarlo con el clúster.

--container-name

Nombre del contenedor de Azure Blob Storage que se va a sincronizar.

--https-ca-cert

Certificado de CA HTTPS codificado en Base64 para la comunicación TLS con sincronización de repositorio privado.

--https-ca-cert-file

Ruta de acceso de archivo al archivo de certificado de CA HTTPS para la comunicación TLS con la sincronización del repositorio privado.

--https-key

Token/contraseña HTTPS para la sincronización del repositorio privado.

--https-user

Nombre de usuario HTTPS para la sincronización del repositorio privado.

--interval --sync-interval

Tiempo entre conciliaciones del origen en el clúster.

--kind

Tipo de origen que debe conciliarse.

valores aceptados: azblob, bucket, git

--known-hosts

Codificado en Base64 known_hosts datos que contienen claves SSH públicas necesarias para acceder a instancias privadas de Git.

--known-hosts-file

Ruta de acceso de archivo a known_hosts contenido que contiene claves SSH públicas necesarias para acceder a instancias privadas de Git.

--kustomization -k

Defina kustomizations para sincronizar orígenes con parámetros ['name', 'path', 'depends_on', 'timeout', 'sync_interval', 'retry_interval', 'prune', 'force'].

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

Referencia local a un secreto de Kubernetes en el espacio de nombres de configuración que se va a usar para la comunicación con el origen.

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

Identificador de cliente de la identidad administrada para la autenticación con Azure Blob.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--sas-token

Token de SAS de Azure Blob para la autenticación.

--semver

Intervalo de semver dentro del origen de Git para conciliar con el clúster.

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

El certificado de cliente codificado en Base64 para autenticar una entidad de servicio con Azure Blob.

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

Contraseña del certificado de cliente que se usa para autenticar una entidad de servicio con Azure Blob.

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

Especifique si se debe incluir el encabezado x5c en las notificaciones de cliente al adquirir un token para habilitar la autenticación basada en el nombre del firmante o emisor para el certificado de cliente.

valor predeterminado: False

--service-principal-client-id --sp-client-id

El identificador de cliente para autenticar una entidad de servicio con Azure Blob, necesario para este método de autenticación.

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

Secreto de cliente para autenticar una entidad de servicio con Azure Blob.

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

Identificador de inquilino para autenticar una entidad de servicio con Azure Blob, necesario para este método de autenticación.

--ssh-private-key

Clave ssh privada codificada en Base64 para la sincronización del repositorio privado.

--ssh-private-key-file

Ruta de acceso de archivo a la clave SSH privada para la sincronización del repositorio privado.

--suspend

Suspenda la conciliación de los orígenes y kustomizations asociados a esta configuración.

valores aceptados: false, true

--tag

Etiqueta dentro del origen de Git para conciliar con el clúster.

--timeout

Tiempo máximo para conciliar el origen antes de que se agote el tiempo de espera.

--url -u

Dirección URL del origen que se va a conciliar.

--yes -y

No solicita confirmación.

valor predeterminado: False

Parámetros globales

--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.