Inicio rápido de Helm Charts

Regístrate para obtener una cuenta de Atlas o inicia sesión.

Regístrate e inicia sesión en Atlas o Regístrate e inicia sesión en Atlas.

Crea credenciales para tu organización.

Cree las credenciales que el operador de Atlas Kubernetes utiliza para autenticarse con Atlas. Elija una de las siguientes opciones:

Implementa Atlas Kubernetes Operator.

Ejecute uno de los siguientes conjuntos de comandos:

• Si desea que Atlas Kubernetes Operator supervise todos los namespaces 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

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

1. Personaliza el proyecto Atlas y sus usuarios de bases de datos.

   Nota

   Puedes encontrar los siguientes Helm Charts adicionales de ejemplo 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 en My Project.

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

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

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

   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 predeterminados de Helm Charts con su ID de organización, credenciales y configuración del proyecto Atlas.

   Nota

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

   Claves de API

   Cuenta de servicio

   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

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

   Nota

   Para obtener una lista completa de los valores de Helm admitidos para la autenticación y otros parámetros del gráfico, consulte el archivo values.yaml en el helm-charts repositorio.

   Para obtener más información sobre los parámetros de recursos personalizados del operador de Atlas Kubernetes, consulte AtlasDeployment Recurso personalizado.

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

Comprueba el estado de tu 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 para el usuario dbadmin de la base de datos. Tus cadenas de conexión serán diferentes de la salida de 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