Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Connect Amazon EC2 automáticamente
Temas
- Conectar automáticamente una EC2 instancia a una nueva base de datos de Amazon DocumentDB
- Conectar automáticamente una EC2 instancia a una base de datos Amazon DocumentDB existente
- Descripción general de la conectividad automática con una EC2 instancia
- Visualización de los recursos de computación conectados
Antes de configurar una conexión entre una EC2 instancia y una nueva base de datos de Amazon DocumentDB, asegúrese de cumplir los requisitos descritos en. Descripción general de la conectividad automática con una EC2 instancia Si realiza cambios en los grupos de seguridad después de configurar la conectividad, los cambios pueden afectar a la conexión entre la EC2 instancia y la base de datos Amazon DocumentDB.
nota
Solo puede configurar automáticamente una conexión entre una EC2 instancia y una base de datos de Amazon DocumentDB mediante. AWS Management Console No puede configurar una conexión automáticamente con Amazon DocumentDB AWS CLI o Amazon DocumentDBAPI.
Conectar automáticamente una EC2 instancia a una nueva base de datos de Amazon DocumentDB
En el siguiente proceso, se supone que ha completado los pasos del Requisitos previos tema.
Pasos
- Paso 1: Crear una EC2 instancia de Amazon
- Paso 2: Crear un clúster de Amazon DocumentDB
- Paso 3: Conéctate a tu EC2 instancia de Amazon
- Paso 4: instalar el intérprete de comandos de mongo
- Paso 5: Administrar Amazon DocumentDB TLS
- Paso 6: Conéctese a su clúster de Amazon DocumentDB
- Paso 7: Inserte y consulte los datos
- Paso 8: Explora
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.
-
En la EC2 consola de Amazon, selecciona Launch instance.
-
Introduce un nombre o identificador en el campo Nombre ubicado en la sección Nombre y etiquetas.
-
En la lista desplegable Amazon Machine Image (AMI), busque Amazon Linux 2 AMI y elíjalo.
-
Busque y seleccione t3.micro en la lista desplegable de tipos de instancia.
-
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:
-
Seleccione un par de claves, elija su par de claves de la lista.
-
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:
-
Seleccione Crear nuevo par de claves y aparecerá el cuadro de diálogo Crear par de claves.
-
Introduzca un nombre en el campo Nombre del par de claves.
-
Elija el tipo de par de claves y el formato del archivo de clave privada.
-
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
-
-
Opcional: 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 optó por crear un nuevo grupo de seguridad, compruebe todas las reglas de tráfico que se apliquen a su EC2 conectividad.
-
En la sección Resumen, revise la EC2 configuración y, si es correcta, elija Launch instance. Edite los grupos de seguridad.
Paso 2: Crear un clúster de Amazon DocumentDB
Mientras se aprovisiona la EC2 instancia de Amazon, creará su clúster de Amazon DocumentDB.
-
Navegue hasta la consola de Amazon DocumentDB y elija Clústeres en el panel de navegación.
-
Seleccione Crear.
-
Deje la configuración de tipo de clúster en su valor predeterminado de Clúster basado en instancias.
-
En Número de instancias, escriba 1. Esto minimizará los costos. Deje las demás configuraciones en sus valores predeterminados.
-
En Conectividad, elija Conectarse a un recurso EC2 informático. Esta es la EC2 instancia que creaste en el paso 1.
nota
La conexión a un recurso EC2 informático crea automáticamente un grupo de seguridad para la conexión del recurso EC2 informático al clúster de Amazon DocumentDB. Cuando haya terminado de crear el clúster y desee ver el grupo de seguridad recién creado, navegue hasta la lista de clústeres y elija el identificador del clúster. En la pestaña Conectividad y seguridad, vaya a Grupos de seguridad y busque su grupo en Nombre (ID) del grupo de seguridad. Contendrá el nombre de su clúster y tendrá un aspecto similar al siguiente:
docdb-ec2-docdb-2023-12-11-21-33-41:i-0e4bb09985d2bbc4c (sg-0238e0b0bf0f73877)
. -
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.
-
Active Mostrar configuración avanzada.
-
En la sección Configuración de red, para los grupos VPC de seguridad de Amazon, elija demoDocDB.
-
Elija Create cluster.
Paso 3: 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:
-
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.
-
Elija Conectar.
-
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 4: 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.
Paso 5: 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 6: Conéctese a su clúster de Amazon DocumentDB
-
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.
-
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:
Asegúrese de tener el nombre de usuario correcto en la cadena.
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
-
Presiona enter en tu terminal. Ahora se le solicitará su contraseña. Introduzca su contraseña.
-
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 7: Inserte y consulte los 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.
-
Para insertar un solo documento, escriba lo siguiente:
db.collection.insert({"hello":"DocumentDB"})
-
Obtiene el siguiente resultado:
WriteResult({ "nInserted" : 1 })
-
Puede leer el documento que escribió con el comando
findOne()
(ya que solo devuelve un documento). La siguiente entrada:db.collection.findOne()
-
Obtiene el siguiente resultado:
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
-
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} ])
-
Obtiene el siguiente resultado:
{ "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }
-
Utilice el comando
find()
para devolver todos los documentos de la colección de perfiles. La siguiente entrada:db.profiles.find()
-
Obtendrá un resultado que coincidirá con los datos que escribió en el paso 5.
-
Utilice una consulta para un único documento mediante un filtro. La siguiente entrada:
db.profiles.find({name: "Katie"})
-
Debería recibir este resultado:
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
-
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 } } })
-
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 }
-
Puede comprobar que su puntuación ha cambiado con la siguiente consulta:
db.profiles.find({name: "Matt"})
-
Obtiene el siguiente resultado:
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
Paso 8: Explora
¡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:
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.
Conectar automáticamente una EC2 instancia a una base de datos Amazon DocumentDB existente
El siguiente procedimiento supone que tiene un clúster de Amazon DocumentDB y una instancia de Amazon EC2 existentes.
Acceda a su clúster de Amazon DocumentDB y configure la conexión con Amazon EC2
-
Acceda a su clúster de Amazon DocumentDB.
-
En el panel de navegación, seleccione Clusters (Clústeres).
sugerencia
Si no ve el panel de navegación del lado izquierdo de la pantalla, seleccione el icono de menú () en la esquina superior izquierda de la página.
-
Especifique el clúster que desee pulsando el botón situado a la izquierda del nombre del clúster.
-
Configura la EC2 conexión con Amazon.
-
Selecciona Acciones y, a continuación, selecciona Configurar EC2 conexión.
Aparece el cuadro de diálogo Configurar la EC2 conexión.
-
En el campo de EC2instancia, elija la EC2 instancia que desee conectar a su clúster.
-
Elija Continuar.
Aparece el cuadro de diálogo Revisar y confirmar.
-
Asegúrese de que los cambios son correctos. A continuación, selecciona Configurar conexión.
-
Si se realiza correctamente, aparecerá la siguiente verificación:
Descripción general de la conectividad automática con una EC2 instancia
Al configurar una conexión entre una EC2 instancia y una base de datos de Amazon DocumentDB, Amazon DocumentDB configura automáticamente el grupo de seguridad de la instancia y de VPC la base de EC2 datos de Amazon DocumentDB.
Los siguientes son requisitos para conectar una EC2 instancia a una base de datos de Amazon DocumentDB:
La EC2 instancia debe existir en la VPC misma base de datos de Amazon DocumentDB.
Si no existe ninguna EC2 instancia en la mismaVPC, la consola proporciona un enlace para crear una.
El usuario que configura la conectividad debe tener permisos para realizar las siguientes EC2 operaciones de Amazon:
ec2:AuthorizeSecurityGroupEgress
ec2:AuthorizeSecurityGroupIngress
ec2:CreateSecurityGroup
ec2:DescribeInstances
ec2:DescribeNetworkInterfaces
ec2:DescribeSecurityGroups
ec2:ModifyNetworkInterfaceAttribute
ec2:RevokeSecurityGroupEgress
Si la instancia de base de datos y la EC2 instancia se encuentran en zonas de disponibilidad diferentes, es posible que su cuenta incurra en costes por zonas de disponibilidad cruzada.
Al configurar una conexión a una EC2 instancia, Amazon DocumentDB actúa de acuerdo con la configuración actual de los grupos de seguridad asociados a la base de datos y la instancia de Amazon DocumentDB, tal EC2 y como se describe en la siguiente tabla:
Configuración actual del grupo de seguridad de Amazon DocumentDB | Configuración actual EC2 del grupo de seguridad | Acción de Amazon DocumentDB |
---|---|---|
Hay uno o más grupos de seguridad asociados a la base de datos de Amazon DocumentDB con un nombre que coincide con el patrón. DocumentDB-ec2-n No se ha modificado ningún grupo de seguridad que coincida con el patrón. Este grupo de seguridad solo tiene una regla de entrada con el grupo de VPC seguridad de la EC2 instancia como origen. |
Hay uno o más grupos de seguridad asociados a la EC2 instancia con un nombre que coincide con el patrón DocumentDB-ec2-n (donde n es un número). No se ha modificado ningún grupo de seguridad que coincida con el patrón. Este grupo de seguridad solo tiene una regla de salida con el grupo de VPC seguridad de la base de datos Amazon DocumentDB como origen. |
Amazon DocumentDB no realiza ninguna acción. Ya se configuró automáticamente una conexión entre la EC2 instancia y la base de datos Amazon DocumentDB. Como ya existe una conexión entre la EC2 instancia y la base de datos Amazon DocumentDB, los grupos de seguridad no se modifican. |
Se aplica alguna de las siguientes condiciones:
|
Se aplica alguna de las siguientes condiciones:
|
Acción de Amazon DocumentDB: crear nuevos grupos de seguridad |
Hay uno o más grupos de seguridad asociados a la base de datos de Amazon DocumentDB con un nombre que coincide con el patrón. DocumentDB-ec2-n No se ha modificado ningún grupo de seguridad que coincida con el patrón. Este grupo de seguridad solo tiene una regla de entrada con el grupo de VPC seguridad de la EC2 instancia como origen. |
Hay uno o más grupos de seguridad asociados a la EC2 instancia con un nombre que coincide con el patrónec2-DocumentDB-n . Sin embargo, Amazon DocumentDB no puede usar ninguno de estos grupos de seguridad para la conexión con la base de datos de Amazon DocumentDB. Amazon DocumentDB no puede usar un grupo de seguridad que no tenga una regla de salida con el grupo de VPC seguridad de la base de datos de Amazon DocumentDB como origen. Amazon DocumentDB tampoco puede usar un grupo de seguridad que se haya modificado. |
Acción de Amazon DocumentDB: crear nuevos grupos de seguridad |
Hay uno o más grupos de seguridad asociados a la base de datos de Amazon DocumentDB con un nombre que coincide con el patrón. DocumentDB-ec2-n No se ha modificado ningún grupo de seguridad que coincida con el patrón. Este grupo de seguridad solo tiene una regla de entrada con el grupo de VPC seguridad de la EC2 instancia como origen. |
Existe un grupo EC2 de seguridad válido para la conexión, pero no está asociado a la EC2 instancia. Este grupo de seguridad tiene un nombre que coincide con el patrón DocumentDB-ec2-n . No se ha modificado. Solo tiene una regla de salida con el grupo de VPC seguridad de la base de datos Amazon DocumentDB como origen. |
Acción de Amazon DocumentDB: asociar EC2 un grupo de seguridad |
Se aplica alguna de las siguientes condiciones:
|
Hay uno o más grupos de seguridad asociados a la EC2 instancia con un nombre que coincide con el patrónDocumentDB-ec2-n . No se ha modificado ningún grupo de seguridad que coincida con el patrón. Este grupo de seguridad solo tiene una regla de salida con el grupo de VPC seguridad de la base de datos Amazon DocumentDB como origen. |
Acción de Amazon DocumentDB: crear nuevos grupos de seguridad |
Acción de Amazon DocumentDB: crear nuevos grupos de seguridad
Amazon DocumentDB realiza las siguientes acciones:
Crea un nuevo grupo de seguridad que coincide con el patrón
DocumentDB-ec2-n
. Este grupo de seguridad tiene una regla de entrada con el grupo de VPC seguridad de la EC2 instancia como origen. Este grupo de seguridad está asociado a la base de datos Amazon DocumentDB y permite que la EC2 instancia acceda a la base de datos Amazon DocumentDB.Crea un nuevo grupo de seguridad que coincide con el patrón
ec2-DocumentDB-n
. Este grupo de seguridad tiene una regla de salida con el grupo de VPC seguridad de la base de datos Amazon DocumentDB como origen. Este grupo de seguridad está asociado a la EC2 instancia y permite que la EC2 instancia envíe tráfico a la base de datos Amazon DocumentDB.
Acción de Amazon DocumentDB: asociar EC2 un grupo de seguridad
Amazon DocumentDB asocia el grupo de EC2 seguridad válido y existente a la EC2 instancia. Este grupo de seguridad permite que la EC2 instancia envíe tráfico a la base de datos Amazon DocumentDB.
Visualización de los recursos de computación conectados
Puede utilizarla AWS Management Console para ver los recursos informáticos que están conectados a una base de datos de Amazon DocumentDB. Los recursos que se muestran incluyen conexiones de recursos informáticos que se configuraron automáticamente. Puede definir la conectividad con los recursos informáticos de manera automática de las siguientes maneras:
Puede seleccionar el recurso informático al crear la base de datos. Para obtener más información, consulte Creación de un Creación de un clúster de Amazon DocumentDB clúster de base de datos Multi-AZ.
Puede configurar la conectividad entre una base de datos existente y un recurso informático. Para obtener más información, consulte Connect Amazon EC2 automáticamente.
Los recursos informáticos de la lista no incluyen los que se conectaron a la base de datos manualmente. Por ejemplo, puede permitir que un recurso informático acceda a una base de datos manualmente añadiendo una regla al grupo de VPC seguridad asociado a la base de datos.
Para que un recurso informático coincida, se deben cumplir las siguientes condiciones:
El nombre del grupo de seguridad asociado al recurso informático coincide con el patrón
ec2-DocumentDB-n
(donde n es un número).El grupo de seguridad asociado al recurso informático tiene una regla de salida con el rango de puertos establecido en el puerto que utiliza la base de datos Amazon DocumentDB.
El grupo de seguridad asociado al recurso informático tiene una regla de salida con el origen establecido en un grupo de seguridad asociado a la base de datos Amazon DocumentDB.
El nombre del grupo de seguridad asociado a la base de datos Amazon DocumentDB coincide con el patrón
DocumentDB-ec2-n
(donde n es un número).El grupo de seguridad asociado a la base de datos Amazon DocumentDB tiene una regla de entrada con el rango de puertos establecido en el puerto que utiliza la base de datos Amazon DocumentDB.
El grupo de seguridad asociado a la base de datos Amazon DocumentDB tiene una regla de entrada con el origen establecido en un grupo de seguridad asociado al recurso informático.
Para ver los recursos informáticos conectados a una base de datos de Amazon DocumentDB
En el panel de navegación, elija Bases de datos y, a continuación, elija el nombre de la base de datos de Amazon DocumentDB.
En la pestaña Conectividad y seguridad, consulte los recursos informáticos en la sección Recursos informáticos conectados.