Si tiene implementaciones de Kubernetes existentes y desea comenzar a utilizar Atlas Kubernetes Operator, puede usar la CLI de Atlas atlas kubernetes config generate o comandos atlas kubernetes config apply para exportar proyectos, implementaciones y usuarios de bases de datos de Atlas.
Ambos comandos permiten exportar la configuración en un formato compatible con Atlas Kubernetes Operator para su uso en el clúster de Kubernetes o Openshift donde se ejecuta Atlas Kubernetes Operator. El comando atlas kubernetes config generate logra esto generando un
La configuración con formatoYAML se envía a la stdout terminal, mientras que el atlas kubernetes config apply comando almacena la configuración en la memoria y la envía directamente a un clúster de Kubernetes de destino.
Overview
Ambos comandos generan una configuración con formato .yamlque incluye los siguientes recursos del operador Atlas Kubernetes:
Parámetros
El comando toma los siguientes parámetros:
Parameter | Descripción | Necesidad |
|---|---|---|
| Cadena hexadecimal única de 24dígitos que identifica su proyecto. Si se omite, se toma el valor predeterminado | Requerido. |
| Una lista de etiquetas legibles, separadas por comas, que identifica los clústeres que se exportarán. Deben ser clústeres del proyecto especificado en el parámetro | Opcional. |
| Marca que rellena una entrada en el archivo de configuración para un secreto de credenciales de Atlas. Si se omite, el comando crea un secreto, pero no lo rellena con datos. El secreto se representa como texto sin formato. | Opcional. |
| Espacio de nombres de Kubernetes al que se exportarán los recursos. El comando rellena el campo | Requerido. |
| Versión de Atlas Kubernetes Operator para la que se exportarán los archivos. Si se omite, el comando exporta archivos compatibles con Atlas Kubernetes Operator v1.5.1. | Opcional. |
El comando toma los siguientes parámetros:
Parameter | Descripción | Necesidad |
|---|---|---|
| Cadena hexadecimal única de 24dígitos que identifica su proyecto. Si se omite, se toma el valor predeterminado | Requerido. |
| Cadena hexadecimal única de 24dígitos que identifica la organización de Atlas con la que se registrará el proyecto. Si se omite, se toma como valor predeterminado el valor | Opcional. |
| Una lista de etiquetas legibles, separadas por comas, que identifican los clústeres que se exportarán. Deben ser clústeres del proyecto especificado en el parámetro | Opcional. |
| Espacio de nombres de Kubernetes al que se exportarán los recursos. El comando rellena el campo | Requerido. |
| Versión de Atlas Kubernetes Operator para la que se exportarán los archivos. Si se omite, el comando exporta archivos compatibles con Atlas Kubernetes Operator v1.5.1. | Opcional. |
|
| Requerido |
| Ruta a su archivo | Requerido |
Compatibilidad
atlascli Exporta configuraciones de Atlas en un formato que depende de la versión de Atlas Kubernetes Operator. La siguiente tabla describe qué versiones de atlascli son compatibles con cada versión de Atlas Kubernetes Operator:
atlascli Versión | Versiones del operador Atlas Kubernetes |
|---|---|
1.4.0 | 1.5.0 |
Ejemplos
Los siguientes ejemplos asumen un Proyecto llamado sampleProject, con clústeres llamados sample1, sample2 y sample3, un ID del grupo de 63500d1139dd494b92fe4376 y un namespace objetivo de sampleNamespace.
Para exportar el proyecto completo, incluidas todas las implementaciones de Atlas y los secretos con credenciales, ejecute el siguiente comando:
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --includeSecrets --targetNamespace=sampleNamespace
Para exportar dos implementaciones de Atlas específicas del proyecto sin credenciales secretas, ejecute el siguiente comando:
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace
En los ejemplos de comandos anteriores, puede aplicar la configuración generada a su clúster de Kubernetes u Openshift canalizando la salida al kubectl apply comando. El siguiente ejemplo de comando lo ilustra:
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace \ | kubectl apply -f -
Como alternativa, puede guardar la configuración generada redirigiendo stdout a un .yaml archivo. El siguiente comando importa una única implementación de Atlas del proyecto sin credenciales secretas y guarda el resultado myAtlasProject.yaml en.
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample3 --targetNamespace=sampleNamespace \ myAtlasProject.yaml
Aplicando la configuración
Para aplicar la configuración generada a su clúster de Kubernetes o Openshift en este escenario, pase el archivo .yaml como argumento al comando kubectl apply.
kubectl apply -f myAtlasProject.yaml
Para exportar el proyecto completo, ejecute el siguiente comando:
atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \ --targetNamespace=sampleNamespace
Para exportar dos implementaciones de Atlas específicas del proyecto, ejecute el siguiente comando:
atlas kubernetes config apply --projectId=63500d1139dd494b92fe4376 \ --clusterName=sample1,sample2 --targetNamespace=sampleNamespace In contrast to ``atlas kubernetes config generate``, this command directly applies the generated configuration without any further manual operation on your part.