Inicio rápido

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.

En uno de los siguientes escenarios, reemplace <version> con el último número de versión:

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

  kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-atlas-kubernetes/v<version>/deploy/all-in-one.yaml

• Si desea que Atlas Kubernetes Operator solo observe su espacio de nombres, debe instalar los archivos de configuración desde el deploy/namespaced directorio:

  kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-atlas-kubernetes/v<version>/deploy/namespaced/crds.yaml

  kubectl apply -f https://raw.githubusercontent.com/mongodb/mongodb-atlas-kubernetes/v<version>/deploy/namespaced/namespaced-config.yaml

Crea un secreto con tus claves API y el ID de tu organización.

Para crear y etiquetar un secreto, ejecute los siguientes comandos con sus claves API y el ID de la organización:

kubectl create secret generic mongodb-atlas-operator-api-key \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="publicApiKey=<atlas_api_public_key>" \
    --from-literal="privateApiKey=<atlas_api_private_key>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-api-key atlas.mongodb.com/type=credentials -n mongodb-atlas-system

Si usa almacenamiento secreto externo, no necesita guardar información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulte Configurar almacenamiento secreto.

Cree el AtlasProject recurso personalizado.

Ejecute el siguiente comando para crear el AtlasProject recurso personalizado:

Implemente el recurso personalizado Atlas Kubernetes Operator.

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasProject
metadata:
  name: my-project
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  name: Test Atlas Operator Project
  projectIpAccessList:
    - ipAddress: <your-ip-address-range>
      comment: "Adding your IP to Atlas access list"
EOF

Cree el AtlasDeployment recurso personalizado.

Ejecute el siguiente comando para crear un AtlasDeployment recurso personalizado y crear un clúster:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    tags:
     - key: "environment",
       value: "production"
    providerSettings:
      instanceSizeName: M10
      providerName: AWS
      regionName: US_EAST_1
EOF

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

Cree un secreto con una contraseña para iniciar sesión en la base de datos del clúster Atlas.

Reemplace P@@ssword% con su contraseña y ejecute los siguientes comandos:

kubectl create secret generic the-user-password --from-literal="password=P@@sword%"

kubectl label secret the-user-password atlas.mongodb.com/type=credentials

Si usa almacenamiento secreto externo, no necesita guardar información confidencial directamente en los secretos de Kubernetes. Para obtener más información, consulte Configurar almacenamiento secreto.

Cree el AtlasDatabaseUser recurso personalizado.

Ejecute el siguiente comando para crear el AtlasDatabaseUser recurso personalizado:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDatabaseUser
metadata:
  name: my-database-user
  labels:
    app.kubernetes.io/version: 1.6.0
spec:
  roles:
    - roleName: "readWriteAnyDatabase"
      databaseName: "admin"
  projectRef:
    name: my-project
  username: theuser
  passwordSecretRef:
    name: the-user-password
EOF

Verifique el estado de su usuario de base de datos.

Ejecute el siguiente comando hasta que reciba una respuesta True, que indica que el usuario de la base de datos está listo:

kubectl get atlasdatabaseusers my-database-user -o=jsonpath='{.status.conditions[?(@.type=="Ready")].status}'

Recupere el secreto que Atlas Kubernetes Operator creó para conectarse al clúster.

1. Copie el siguiente comando:

   Importante

   El siguiente comando requiere jq 1.6 o superior.

   kubectl get secret {my-project}-{my-atlas-cluster}-{my-database-user} -o json | jq -r '.data | with_entries(.value |= @base64d)';

2. Reemplace los siguientes marcadores de posición con los detalles de sus recursos personalizados:

   my-project	Especifique el valor del metadata campo de su AtlasProject recurso personalizado.
   my-atlas-cluster	Especifique el valor del metadata campo de su AtlasDeployment recurso personalizado.
   my-database-user	Especifique el valor del metadata campo de su AtlasDatabaseUser recurso personalizado.

3. Ejecuta el comando.

   Nota

   Las cadenas de conexión serán diferentes a las del siguiente ejemplo.

   {
      "connectionStringStandard": "mongodb://theuser:P%40%40sword%25@test-cluster-shard-00-00.peqtm.mongodb.net:27017,test-cluster-shard-00-01.peqtm.mongodb.net:27017,test-cluster-shard-00-02.peqtm.mongodb.net:27017/?ssl=true&authSource=admin&replicaSet=atlas-pk82fl-shard-0",
      "connectionStringStandardSrv": "mongodb+srv://theuser:P%40%40sword%25@test-cluster.peqtm.mongodb.net",
      "password": "P@@sword%",
      "username": "theuser"
    }

   Puedes usar este secreto en tu aplicación:

   containers:
    - name: test-app
      env:
       - name: "CONNECTION_STRING"
         valueFrom:
           secretKeyRef:
             name: test-atlas-operator-project-test-cluster-theuser
             key: connectionStringStandardSrv