Puedes acceder al proyecto Atlas Kubernetes Operator en GitHub:
Cuenta Atlas
Antes de implementar el Atlas Kubernetes Operator, debes crear una cuenta de Atlas. Para obtener más información, consulta Regístrate e inicia sesión en Atlas.
Claves de API
Necesita la siguiente llave pública de API, llave privada de API y la información del Identificador de la Organización para configurar el acceso de Atlas Kubernetes Operator a Atlas.
Si deseas que el Atlas Kubernetes Operator cree un nuevo Proyecto de Atlas, otorga acceso programático a una organización. Si tu organización requiere una lista de acceso IP para la API de administración de Atlas, también deberás configurar la lista de acceso a la API.
Importante
Debes asignar a la clave API el rol organizacional Organization Project Creator o superior.
Si deseas trabajar con un proyecto Atlas existente, Añadir acceso al proyecto desde un proyecto. Si tu organización requiere una lista de acceso IP para la API de Administración de Atlas, también debes configurar la lista de acceso a la API.
Importante
Debe asignar al clave API el rol de proyecto Project Owner.
Para saber más, consulta Configura el acceso a Atlas.
Cuentas de servicio
Como alternativa a las claves API, puede utilizar cuentas de servicio para la autenticación basada en tokens. Para obtener más información, consulte Configurar el acceso a Atlas mediante cuentas de servicio.
Namespaces
Puede implementar Atlas Kubernetes Operator para monitorear todos los namespaces en el clúster de Kubernetes, o solo su namespace.
AWS Grupos de seguridad
Debe configurar el emparejamiento de VPC para su proyecto antes de poder agregar un grupo de seguridad AWS a una lista de acceso. No se puede configurar AWS grupos de seguridad como entradas temporales de la lista de acceso.
Parámetros de Configuración Obsoletos
Los siguientes parámetros están obsoletos en el API Atlas y el Atlas Kubernetes Operator no los admite:
replicationSpecreplicationFactor
Creación de clústeres
Crear un clúster Atlas de nivel gratuito toma menos de 15 segundos.
La creación de un clúster Flex o un clúster Dedicado puede tardar hasta 10 minutos.
Cadenas de conexión
No puede utilizar una URL de conexión directamente. Los clústeres de Atlas requieren autenticación. Debe crear al menos un AtlasDatabaseUser Recurso personalizado antes de que la aplicación en su clúster de Kubernetes pueda conectarse al clúster de Atlas. Atlas Kubernetes Operator crea un secreto especial para cada combinación de clúster y usuario de base de datos en el proyecto. La aplicación en tu clúster de Kubernetes puede usar este secreto para conectarse al clúster de Atlas. El parámetro spec.scopes en el recurso personalizado AtlasDatabaseUser restringe los clústeres que crean el usuario de base de datos.
Información de la conexión
Para conectarse a la Atlas Administration API, Atlas Kubernetes Operator lee el Identificador de la Organización y las credenciales (claves API o cuenta de servicio) de una de las siguientes ubicaciones:
spec.connectionSecretRef.name (si se especifica en el
AtlasProjectrecurso personalizado).Por defecto, Atlas Kubernetes Operator guarda los secretos de conexión en el mismo namespace que el
AtlasProjectrecurso Personalizado. Para almacenar secretos en otro namespace, especifica el parámetro spec.connectionSecretRef.namespace.globalAtlas Kubernetes Operator secreto<operator-deployment-name>-api-key(si spec.connectionSecretRef.name no está especificado).
Para crear o actualizar recursos en Atlas, Atlas Kubernetes Operator utiliza la información de conexión para realizar llamadas API a Atlas.
Nota
A veces, el Operador de Kubernetes de Atlas realiza múltiples llamadas a API en Atlas durante la reconciliación de un recurso personalizado. Por ejemplo, AtlasProject tiene una configuración de Lista de Acceso IP para llamar a la API coincidente.
Si ocurre algún error durante la conciliación, status.conditions se actualiza para reflejar el error.
Ejemplo
- lastTransitionTime: "2021-03-15T14:26:44Z" message: 'POST https://cloud.mongodb.com/api/atlas/v1.0/groups/604a47de73cd8cag77239021/accessList: 400 (request "INVALID_IP_ADDRESS_OR_CIDR_NOTATION") The address 192.0.2.1dfdfd5 must be in valid IP address or CIDR notation.' reason: ProjectIPAccessListNotCreatedInAtlas status: "False" type: IPAccessListReady
Sugerencias de implementación admitidas
Cuando implementes. Atlas Kubernetes Operator usando kubectl, puedes añadir los siguientes parámetros para personalizar tu configuración:
Flag | Descripción | Valor por defecto |
|---|---|---|
| Nombre de dominio de la URL de Atlas, que termina en una barra diagonal. |
|
| Dirección a la que se vincula el endpoint de métricas. |
|
| Dirección a la que se vincula el punto final de la sonda. |
|
| Nombre del secreto que contiene sus credenciales de Atlas (claves API o cuenta de servicio). Atlas Kubernetes Operator utiliza este parámetro si su configuración |
|
| Indicador que indica si se debe habilitar la elección de líder para el administrador del controlador. La elección del líder garantiza que solo un gerente de controlador esté activo a la vez. |
|
| Importancia o nivel de urgencia de las entradas del registro. Puedes especificar uno de los siguientes niveles:
|
|
| Formato para los registros de logs. Puedes especificar uno de los siguientes formatos:
|
|
Ejemplo
El siguiente comando configura una implementación del Atlas Kubernetes Operator 1.8.2 con el endpoint de métricas en el puerto :8084, utilizando un nivel de registro de error:
kubectl apply --metrics-bind-address :8084 \ --log-level error \ -f https://raw.githubusercontent.com/mongodb/mongodb-atlas-kubernetes/1.8.2/deploy/all-in-one.yaml