Inicio rápido de Helm Charts

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

Registre una nueva cuenta Atlas o inicie sesión en su cuenta Atlas.

Cree claves API para su organización.

Crear un Clave API con Organization Project Creator permisos o siguiendo Project Owner el procedimiento en Otorgar acceso programático a una organización.

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 desea que Atlas Kubernetes Operator supervise un conjunto específico de espacios de nombres, configure el --watchNamespaces indicador como una lista separada por comas de los espacios de nombres que se supervisarán. Por ejemplo, ejecute el siguiente comando para supervisar solo el atlas-operator espacio de nombres:

  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 simple de implementación de 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 de implementación de operador de Kubernetes de Atlas avanzado y extensible con biolerplate relacionado con implementaciones de múltiples regiones, comportamiento de escalamiento automático y más.

   Cree un archivo llamado install-values.yaml y pegue el siguiente código de ejemplo, 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. Ejecute el siguiente comando.

   Los indicadores --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, claves API y configuración del proyecto Atlas.

   Nota

   mongodb/atlas-deployment hace referencia al nombre de un gráfico 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 obtener más información sobre los parámetros disponibles, consulte AtlasDeployment Recurso personalizado.

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

Verifique el estado de su usuario de base de datos.

Ejecute 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

Recupere 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 utilizar 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