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.

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 desea que el operador de Kubernetes de Atlascree un nuevo proyecto de Atlas, otorgue acceso programático a unaorganización. Si su organización requiere una lista de acceso de IP para la API de administración de Atlas, también debe configurarla.

  Importante

  Debe asignar a la clave API el rol de organización 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 --watchNamespaces bandera a 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: user
       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.orgId='<orgid>' \
   --set atlas.publicApiKey='<publicKey>' \
   --set atlas.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 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