Inicio rápido

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.

Instala Atlas Kubernetes Operator.

Elija uno de los siguientes métodos para instalar Atlas Kubernetes Operator:

atlas kubernetes operator install --ipAccessList <IP_OR_CIDR> [options]

Cree un secreto de conexión con sus credenciales.

Cree y etiquete un secreto que Atlas Kubernetes Operator utiliza para autenticarse con Atlas. Elija la pestaña que coincida con su método de autenticación preferido:

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

kubectl create secret generic mongodb-atlas-operator-service-account \
    --from-literal="orgId=<atlas_organization_id>" \
    --from-literal="clientId=<service_account_client_id>" \
    --from-literal="clientSecret=<service_account_client_secret>" \
    -n mongodb-atlas-system

kubectl label secret mongodb-atlas-operator-service-account atlas.mongodb.com/type=credentials -n mongodb-atlas-system

Si utiliza un almacenamiento de secretos externo, su gestor de secretos externo creará y administrará los secretos de Kubernetes. Para obtener más información, consulte Configurar el almacenamiento de secretos.

Cree el recurso personalizado AtlasProject.

Ejecuta el siguiente comando para crear el AtlasProject recurso personalizado:

Implementa el recurso personalizado del Atlas Kubernetes Operator.

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

Cree el recurso personalizado AtlasDeployment.

Ejecuta uno de los siguientes comandos para crear un AtlasDeployment Recurso personalizado y crear un clúster:

Nivel de pago:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    tags:
      - key: "environment"
        value: "production"
    replicationSpecs:
      - zoneName: US-Zone
        regionConfigs:
          - electableSpecs:
              instanceSize: M10
              nodeCount: 3
            providerName: AWS
            regionName: US_EAST_1
            priority: 7
EOF

nivel gratuito:

cat <<EOF | kubectl apply -f -
apiVersion: atlas.mongodb.com/v1
kind: AtlasDeployment
metadata:
  name: my-atlas-cluster
spec:
  projectRef:
    name: my-project
  deploymentSpec:
    clusterType: REPLICASET
    name: "Test-cluster"
    replicationSpecs:
      - regionConfigs:
          - regionName: US_EAST_1
            providerName: TENANT
            backingProviderName: AWS
            electableSpecs:
              instanceSize: M0
              nodeCount: 3
EOF

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

Cree un secreto de Kubernetes 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 utiliza un almacenamiento de secretos externo, su gestor de secretos externo creará y administrará los secretos de Kubernetes. Para obtener más información, consulte Configurar el almacenamiento de secretos.

Cree el recurso personalizado AtlasDatabaseUser.

Ejecuta 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
spec:
  roles:
    - roleName: "readWriteAnyDatabase"
      databaseName: "admin"
  projectRef:
    name: my-project
  username: theuser
  passwordSecretRef:
    name: the-user-password
EOF

Comprueba el estado de tu usuario de base de datos.

Ejecute el siguiente comando hasta que reciba una respuesta True, lo 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}'

Recuperar 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. Reemplaza los siguientes marcadores de posición con los detalles para tus recursos personalizados:

   my-project	Especifica el valor del campo metadata de tu AtlasProject Recurso Personalizado.
   my-atlas-cluster	Especifica el valor del campo metadata de tu AtlasDeployment Recurso Personalizado.
   my-database-user	Especifica el valor del campo metadata de tu AtlasDatabaseUser Recurso Personalizado.

3. Ejecuta el comando.

   Nota

   Tus cadenas de conexión serán diferentes 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 de Kubernetes en tu aplicación:

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