Inicio rápido de Helm Charts

Regístrese para obtener una cuenta Atlas o inicie sesión.

Registrar una nueva cuenta de Atlas o Iniciar sesión en tu cuenta de Atlas.

Cree claves API para su organización.

Otorgar acceso programático a una organización y configurar la API Access List.

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.

Implementar el operador Atlas Kubernetes.

Ejecute uno de los siguientes conjuntos de comandos:

• Si desea que Atlas Kubernetes Operator supervise todos los espacios de nombres en el clúster de Kubernetes, ejecute los siguientes comandos:

  helm repo add mongodb https://mongodb.github.io/helm-charts
  helm install atlas-operator --namespace=atlas-operator --create-namespace mongodb/mongodb-atlas-operator

• Si quieres que Atlas Kubernetes Operator supervise un conjunto particular de namespaces, configura el indicador --watchNamespaces en una lista separada por comas de namespaces para ser supervisados. Por ejemplo, ejecuta el siguiente comando para monitorear solo el namespace atlas-operator:

  helm install atlas-operator --namespace=atlas-operator --set watchNamespaces=atlas-operator --create-namespace mongodb/mongodb-atlas-operator

Implementar la implementación de la base de datos Atlas.

1. Personalice el proyecto Atlas y los usuarios de su base de datos.

   Nota

   Puede encontrar los siguientes ejemplos adicionales de gráficos de Helm en GitHub:

   • atlas-basic: Un ejemplo básico de implementación del Atlas Kubernetes Operator que incluye la creación de un Proyecto Atlas, un clúster y un usuario de base de datos.

   • atlas-advanced: Un ejemplo extensible y avanzado de implementación del Atlas Kubernetes Operator con plantilla relacionada con implementaciones multiregión, comportamiento de escalado automático y más.

   Crea un archivo llamado install-values.yaml y pega el siguiente ejemplo de código, que hace lo siguiente:

   • Establece el nombre del proyecto a My Project.

   • Permite que todas las direcciones IP (0.0.0.0) accedan al proyecto.

   • Crea un usuario de base de datos llamado dbadmin que tiene el dbAdmin rol.

   • Crea un usuario de base de datos llamado dbuser que tiene el readWrite rol.

   project: # Project custom values
     atlasProjectName: "My Project"
     projectIpAccessList:
       - cidrBlock: "0.0.0.0/0"
   users: # Custom database users
     - username: dbadmin
       databaseName: admin
       roles:
         - databaseName: admin-role
           roleName: dbAdmin
     - username: dbuser
       databaseName: admin
       roles:
         - databaseName: user-role
           roleName: readWrite

2. Ejecuta el siguiente comando.

   Las banderas --set y --values en el siguiente comando anulan los valores del archivo Values.yaml y los valores por defecto de Helm Charts con tu Identificador de la Organización, claves de API y configuración de Proyecto de Atlas.

   Nota

   mongodb/atlas-deployment hace referencia al nombre de una gráfica en el repositorio.

   helm install atlas-deployment \
   mongodb/atlas-deployment \
   --namespace=my-cluster \
   --create-namespace \
   --set atlas.secret.orgId='<orgid>' \
   --set atlas.secret.publicApiKey='<publicKey>' \
   --set atlas.secret.privateApiKey='<privateApiKey>' \
   --values install-values.yaml

   Para saber más sobre los parámetros disponibles, consulte AtlasDeployment Custom recurso.

   Para crear una instancia sin servidor, consulte el ejemplo de instancia sin servidor.

Verifique el estado de su usuario de base de datos.

Ejecuta el siguiente comando para esperar a que el usuario de la base de datos dbadmin esté listo:

kubectl wait --for=condition=ready  --timeout=10m -n my-cluster atlasdatabaseusers/atlas-deployment-dbadmin

Recupera el secreto que Atlas Kubernetes Operator creó para conectarse a la implementación de la base de datos.

Ejecute el siguiente comando para recuperar la cadena de conexión y la contraseña del usuario de la base de datos dbadmin. Las cadenas de conexión serán diferentes a las del ejemplo.

kubectl get secret -n my-cluster my-project-cluster-name-dbadmin  -o json | jq -r '.data | with_entries(.value |= @base64d)';

{
   "connectionStringStandard": "mongodb://admin-user:%25SomeLong%25password$foradmin@atlas-cluster-shard-00-00.nlrvs.mongodb.net:27017,atlas-cluster-shard-00-01.nlrvs.mongodb.net:27017,atlas-cluster-shard-00-02.nlrvs.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-11q9bn-shard-0",
   "connectionStringStandardSrv": "mongodb+srv://admin-user:%25SomeLong%25password$foradmin@atlas-cluster.nlrvs.mongodb.net",
   "password": "%SomeLong%password$foradmin",
   "username": "dbadmin"
}

Puede usar el siguiente secreto en su aplicación:

containers:
 - name: test-app
   env:
     - name: "CONNECTION_STRING"
       valueFrom:
         secretKeyRef:
           name: my-project-cluster-name-dbadmin
           key: connectionStringStandardSrv