Connect Amazon EC2 manualmente

En los pasos siguientes se supone que ha completado los pasos del Requisitos previos tema.

Paso 1: Crear una EC2 instancia de Amazon

En este paso, creará una EC2 instancia de Amazon en la misma región y Amazon VPC que utilizará más adelante para aprovisionar el clúster de Amazon DocumentDB.

1. En la EC2 consola de Amazon, selecciona Launch instance.

   

2. Introduce un nombre o identificador en el campo Nombre ubicado en la sección Nombre y etiquetas.

3. En la lista desplegable Amazon Machine Image (AMI), busque Amazon Linux 2 AMI y selecciónelo.

   

4. Busque y seleccione t3.micro en la lista desplegable de tipos de instancia.

   

5. En la sección Par de claves (inicio de sesión), introduzca el identificador de un par de claves existente o seleccione Crear nuevo par de claves.

   

   Debes proporcionar un EC2 key pair de Amazon.

   Si tienes un par de EC2 claves de Amazon:

   1. Seleccione un par de claves, elija su par de claves de la lista.

   2. Debes tener ya disponible el archivo de clave privada (archivo.pem o.ppk) para iniciar sesión en tu instancia de Amazon. EC2

   Si no tienes un par de EC2 claves de Amazon:

   1. Seleccione Crear nuevo par de claves y aparecerá el cuadro de diálogo Crear par de claves.

   2. Introduzca un nombre en el campo Nombre del par de claves.

   3. Elija el tipo de par de claves y el formato del archivo de clave privada.

   4. Elija Crear par de claves.

   

   nota

   Por motivos de seguridad, te recomendamos encarecidamente que utilices un par de claves tanto para la conexión a Internet de la instancia como SSH para conectarte a Internet. EC2

6. En la sección Configuración de red, en Firewall (grupos de seguridad), selecciona Crear grupo de seguridad o Seleccionar grupo de seguridad existente.

   

   Si elige seleccionar un grupo de seguridad existente, seleccione uno de la lista desplegable Grupos de seguridad comunes.

   Si opta por crear un grupo de seguridad nuevo, realice lo siguiente:

   1. Compruebe todas las reglas de tráfico que se apliquen a su EC2 conectividad.

   2. En el campo IP, elija Mi IP o seleccione Personalizado para elegir entre una lista de CIDR bloqueos, listas de prefijos o grupos de seguridad. No recomendamos Anywhere como opción, a menos que la EC2 instancia se encuentre en una red aislada, ya que permite el acceso a la instancia desde cualquier dirección IP. EC2

   

7. En la sección Resumen, revisa la EC2 configuración y, si es correcta, selecciona Launch instance. Edite los grupos de seguridad.

   

Paso 2: crear un grupo de seguridad

Ahora crearás un nuevo grupo de seguridad en tu Amazon predeterminadoVPC. El grupo de seguridad demoDocDB le permite conectarse a su clúster de Amazon DocumentDB en el puerto 27017 (el puerto predeterminado de Amazon DocumentDB) desde su instancia de Amazon. EC2

1. En Amazon EC2 Management Console, en Red y seguridad, selecciona Grupos de seguridad.

   

2. Elija Crear grupo de seguridad.

   

3. En la sección de detalles básicos:

   1. En Nombre del grupo de seguridad, introduzca demoDocDB.

   2. En Descripción, escriba una descripción.

   3. Para VPC, acepta el uso de tu configuración predeterminadaVPC.

   

4. En la sección Inbound rules (Reglas de entrada), elija Add rule (agregar regla).

   1. En Tipo, elija TCPRegla personalizada.

   2. En Rango de puertos, escriba 27017.

   3. Para Destino, seleccione Personalizado. En el campo contiguo, busque el grupo de seguridad al que acaba de llamar demoEC2. Puede que tengas que actualizar tu navegador para que la EC2 consola de Amazon rellene automáticamente el nombre de la demoEC2 fuente.

   

5. Acepte todos los demás valores predeterminados y elija Crear grupo de seguridad.

   

Paso 3: crear un clúster de Amazon DocumentDB

Mientras se aprovisiona la EC2 instancia de Amazon, creará su clúster de Amazon DocumentDB.

1. Navegue hasta la consola de Amazon DocumentDB y elija Clústeres en el panel de navegación.

   

2. Seleccione Crear.

   

3. Deje la configuración de tipo de clúster en su valor predeterminado de Clúster basado en instancias.

   

4. En Número de instancias, escriba 1. Esto minimizará los costos. Deje las demás configuraciones en sus valores predeterminados.

   

5. En Conectividad, deje la configuración predeterminada de No conectarse a un recurso EC2 informático.

   

   nota

   La conexión a un recurso EC2 informático crea automáticamente grupos de seguridad para la conexión del recurso EC2 informático al clúster. Como en el paso anterior creó estos grupos de seguridad manualmente, debe seleccionar No conectarse a un recurso EC2 informático para no crear un segundo conjunto de grupos de seguridad.

6. Para la Autenticación, introduzca las credenciales de inicio de sesión. Importante: Necesitará las credenciales de inicio de sesión para autenticar el clúster en un paso posterior.

   

7. Active Mostrar configuración avanzada.

   

8. En la sección Configuración de red, para los grupos VPC de seguridad de Amazon, elija demoDocDB.

   

9. Elija Create cluster.

   

Paso 4: Conéctate a tu EC2 instancia de Amazon

Para instalar el shell mongo, primero debes conectarte a tu EC2 instancia de Amazon. La instalación del intérprete de comandos de mongo permite conectarse a su clúster de Amazon DocumentDB y realizar consultas en él. Realice los siguientes pasos:

1. En la EC2 consola de Amazon, navega hasta tus instancias y comprueba si la instancia que acabas de crear se está ejecutando. Si es así, selecciona la instancia haciendo clic en el ID de la instancia.

   

2. Elija Conectar.

   

3. Existen cuatro opciones con pestañas para su método de conexión: Amazon EC2 Instance Connect, Session Manager, SSH cliente o consola EC2 serie. Debe elegir uno y seguir sus instrucciones. Cuando haya terminado, elija Connect.

   

nota

Si su dirección IP ha cambiado después de iniciar este recorrido o si va a volver a su entorno más adelante, debe actualizar la regla de entrada del grupo de demoEC2 seguridad para permitir el tráfico entrante desde su nueva dirección. API

Paso 5: instalar el intérprete de comandos de mongo

Ahora puede instalar el intérprete de comandos de mongo que es una utilidad de línea de comandos que se utiliza para conectarse al clúster de Amazon DocumentDB y consultarlo. Siga las instrucciones siguientes para instalar el intérprete de comandos de mongo en su sistema operativo.

On Amazon Linux

Instalación del intérprete de comandos de mongo en Amazon Linux

1. Cree el archivo de repositorio. En la línea de comandos de la EC2 instancia, ejecute el siguiente comando:

   echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo

2. Cuando esté completo, instale el intérprete de comandos de mongo con el siguiente comando:

   sudo yum install -y mongodb-org-shell

On Ubuntu 18.04

Para instalar el intérprete de comandos de mongo en Ubuntu 18.04

1. Importe la clave pública que utilizará el sistema de administración de paquetes.

   sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 2930ADAE8CAF5059EE73BB4B58712A2291FA4AD5

2. Cree el archivo de lista /etc/apt/sources.list.d/mongodb-org-3.6.list para MongoDB mediante el comando correspondiente a su versión de Ubuntu.

   Ubuntu 18.04

   echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu xenial/mongodb-org/3.6 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-3.6.list

   nota

   El comando anterior instalará el intérprete de comandos de mongo 3.6 para Bionic y Xenial.

3. Vuelva a cargar la base de datos del paquete local utilizando el siguiente comando:

   sudo apt-get update

4. Instale el intérprete de comandos de MongoDB.

   sudo apt-get install -y mongodb-org-shell

Para obtener información sobre cómo instalar las versiones anteriores de MongoDB en un sistema Ubuntu, consulte Install MongoDB Community Edition on Ubuntu.

 

On other operating systems

Para instalar el intérprete de comandos de mongo en otros sistemas operativos, consulte el tema sobre cómo instalar MongoDB Community Edition en la documentación de MongoDB.

Paso 6: Administrar Amazon DocumentDB TLS

Descargue el certificado de CA para Amazon DocumentDB con el siguiente código: wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem

nota

Transport Layer Security (TLS) está habilitada de forma predeterminada para todos los clústeres nuevos de Amazon DocumentDB. Para obtener más información, consulte Administrar la configuración del clúster TLS de Amazon DocumentDB.

Paso 7: conectarse a su clúster de Amazon DocumentDB

1. En la consola de Amazon DocumentDB, en Clústeres, localice el clúster. Elija el clúster que creó haciendo clic en el identificador del clúster.

   

2. En la pestaña Conectividad y seguridad, busca Conectarse a este clúster con la consola mongo en el cuadro Conectar:

   

   Copia la cadena de conexión proporcionada y pégala en tu terminal.

   Realice los siguientes cambios en ella:

   1. Asegúrese de tener el nombre de usuario correcto en la cadena.

   2. Omita <insertYourPassword> para que la consola mongo le pida la contraseña cuando se conecte.

   Su cadena de conexión debe tener un aspecto similar al siguiente:

   mongo --ssl host docdb-2020-02-08-14-15-11. cluster.region.docdb.amazonaws.com:27107 --sslCAFile global-bundle.pem --username demoUser --password

3. Presiona enter en tu terminal. Ahora se le solicitará su contraseña. Introduzca su contraseña.

4. Cuando introduzca la contraseña y pueda ver el mensaje rs0:PRIMARY>, significa que se ha conectado correctamente a su clúster de Amazon DocumentDB.

¿Tiene problemas para conectarse? Consulte Solución de problemas de Amazon DocumentDB.

Paso 8: insertar y consultar datos

Ahora que está conectado a su clúster, puede realizar algunas consultas para familiarizarse con el uso de una base de datos de documentos.

1. Para insertar un solo documento, escriba lo siguiente:

   db.collection.insert({"hello":"DocumentDB"})

2. Obtiene el siguiente resultado:

   WriteResult({ "nInserted" : 1 })

3. Puede leer el documento que escribió con el comando findOne() (ya que solo devuelve un documento). La siguiente entrada:

   db.collection.findOne()

4. Obtiene el siguiente resultado:

   { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }

5. Para realizar algunas consultas más, plantéese un caso de uso de perfiles de juegos. Primero, inserte algunas entradas en una colección titulada profiles. La siguiente entrada:

   db.profiles.insertMany([
               { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202},
               { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9},
               { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87},
               { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
               ])
               

6. Obtiene el siguiente resultado:

   { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

7. Utilice el comando find() para devolver todos los documentos de la colección de perfiles. La siguiente entrada:

   db.profiles.find()

8. Obtendrá un resultado que coincidirá con los datos que escribió en el paso 5.

9. Utilice una consulta para un único documento mediante un filtro. La siguiente entrada:

   db.profiles.find({name: "Katie"})

10. Debería recibir este resultado:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}

11. Ahora intentemos buscar un perfil y modificarlo con el comando findAndModify. Le daremos al usuario Matt diez puntos adicionales con el siguiente código:

    
        db.profiles.findAndModify({
            query: { name: "Matt", status: "active"},
            update: { $inc: { score: 10 } }
        })
    

12. Se obtiene el siguiente resultado (tenga en cuenta que la puntuación aún no ha aumentado):

    
        {
        "_id" : 1,
        "name" : "Matt",
        "status" : "active",
        "level" : 12,
        "score" : 202
        }
                

13. Puede comprobar que su puntuación ha cambiado con la siguiente consulta:

    db.profiles.find({name: "Matt"})

14. Obtiene el siguiente resultado:

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }

Paso 9: explorar

¡Enhorabuena! Ha completado correctamente la Guía de inicio rápido para Amazon DocumentDB.

Pasos siguientes Descubra cómo aprovechar al máximo esta potente base de datos con algunas de sus características más populares:

• Administración de Amazon DocumentDB

• Escalado

• Copia de seguridad y restauración

nota

Para ahorrar costos, puede detener el clúster de Amazon DocumentDB para reducir los costos o eliminar el clúster. De forma predeterminada, tras 30 minutos de inactividad, su AWS Cloud9 entorno detendrá la EC2 instancia de Amazon subyacente.