Si ya tienes implementaciones de Kubernetes y deseas comenzar a usar Atlas Kubernetes Operator, puedes usar el Atlas CLI atlas kubernetes config generate o atlas kubernetes config apply comandos para exportar proyectos Atlas, implementaciones y usuarios de bases de datos.
Ambos comandos te permiten exportar tu configuración en un formato compatible con Atlas Kubernetes operador para uso en el clúster de Kubernetes u OpenShift en el que se ejecuta Atlas Kubernetes operador. El comando atlas kubernetes config generate logra esto generando un
Configuración formateada en YAMLa tu stdout de terminal, mientras que el comando atlas kubernetes config apply almacena la configuración en 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 de Atlas Kubernetes Operator:
Parámetros
El comando toma los siguientes parámetros:
Parameter | Descripción | Necesidad |
|---|---|---|
| Cadena hexadecimal única de 24 dígitos que identifica tu proyecto. Si se omite, por defecto se tomará el valor | Requerido. |
| Una lista separada por comas de etiquetas legibles para humanos que identifican los clústeres a exportar. Estos deben ser clústeres en el proyecto especificado en el parámetro | Opcional. |
| Bandera 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 genera como texto plano. | Opcional. |
| Namespace de Kubernetes al que se van a exportar los recursos. El comando llena 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 24 dígitos que identifica tu proyecto. Si se omite, por defecto se tomará el valor | Requerido. |
| string hexadecimal única de 24dígitos que identifica la organización de Atlas en la que se debe registrar el proyecto. Si se omite, se utiliza el valor | Opcional. |
| Una lista separada por comas de etiquetas legibles por humanos que identifican los clústeres a exportar. Estos deben ser clústeres en el proyecto especificado en el parámetro | Opcional. |
| Namespace de Kubernetes al que se van a exportar los recursos. El comando llena 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 desde Atlas en un formato que depende de la versión del operador de Kubernetes de Atlas. La siguiente tabla describe qué versiones de atlascli son compatibles con qué versiones del operador de Kubernetes de Atlas:
atlascli Versión | Versiones del Atlas Kubernetes Operator |
|---|---|
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 todo el proyecto, incluyendo todas las implementaciones y secretos de Atlas con credenciales, ejecutar el siguiente comando:
atlas kubernetes config generate --projectId=63500d1139dd494b92fe4376 \ --includeSecrets --targetNamespace=sampleNamespace
Para exportar dos implementaciones específicas de Atlas 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 tu clúster de Kubernetes u Openshift en este escenario, pasa 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.