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 clave API pública, clave API privada y la información de ID de la organización para configurar el acceso del operador de Kubernetes de Atlas 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 desea trabajar con un proyecto de Atlas existente, agregue el acceso al proyecto desdeun proyecto. Si su organización requiere una lista de acceso IP para la API de administración de Atlas, también debe configurarla.

  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 desea que Atlas Kubernetes Operator solo observe su propio espacio de nombres, configure el --watchNamespaces indicador en su propio espacio de nombres y ejecute el siguiente comando:

  Nota

  Solo se puede establecer el --watchNamespaces indicador en su propio espacio de nombres. --watchNamespaces Actualmente no se admite establecer el indicador en ningún otro 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.

   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.

   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 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  -ojson | 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