Uso de Amazon DocumentDB en el kit de herramientas - AWS Kit de herramientas para VS Code
Acceso a Amazon DocumentDB desde el kit de herramientas AWSCreación de un clúster basado en instancias.Copia de un punto de conexión de un clústerApertura en el navegadorAmpliación de un clúster existenteDetención de un clústerReinicio de una instanciaEliminación de una instanciaVisualización, adición y eliminación de etiquetasModificación de una clase de instancia

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.

Uso de Amazon DocumentDB en el kit de herramientas

Amazon DocumentDB (compatible con MongoDB) es un servicio de base de datos rápido, fiable y completamente administrado que simplifica la configuración, el funcionamiento y el escalado de las bases de datos compatibles con MongoDB en la nube.

Para obtener información detallada sobre Amazon DocumentDB, información de introducción y tutoriales, consulte la Guía para desarrolladores de Amazon DocumentDB.

En las siguientes secciones se describe cómo trabajar con Amazon DocumentDB con el AWS Toolkit for Visual Studio Code.

Acceso a Amazon DocumentDB desde el kit de herramientas AWS

Para acceder a Amazon DocumentDB con el AWS kit de herramientas, complete el siguiente procedimiento.

Acceso a Amazon DocumentDB en el kit de herramientas AWS

  1. Desde VS Code, abra. AWS Toolkit for Visual Studio Code

  2. Desde el AWS kit de herramientas, expanda el Explorador.

  3. En el Explorador, expanda Amazon DocumentDB para mostrar los recursos de Amazon DocumentDB existentes.

Creación de un clúster basado en instancias.

Para empezar a trabajar con Amazon DocumentDB, complete el siguiente procedimiento a fin de crear un clúster.

Creación de un clúster basado en instancias

  1. En AWS Toolkit for Visual Studio Code, abra el menú contextual de Amazon DocumentDB (haga clic con el botón derecho) y, a continuación, seleccione Crear clúster para abrir el cuadro de diálogo Crear clúster de Amazon DocumentDB en VS Code.

  2. En la pantalla Tipo de clúster, elija Clúster basado en instancias.

  3. En la pantalla Nombre del clúster, especifique un nombre para el nuevo clúster.

  4. En la pantalla Seleccione la versión del motor, elija la versión del motor de Amazon DocumentDB que prefiera.

  5. En las pantallas Nombre de usuario y contraseña del administrador, especifique un nombre de usuario y una contraseña del administrador para proteger el clúster.

  6. En la pantalla Especificar cifrado de almacenamiento, elija si desea cifrar el clúster o no.

  7. En la pantalla Número de instancias, configure el número de instancias que prefiera.

  8. En la pantalla Seleccionar clase de instancia, elija la clase de instancia que prefiera y, a continuación, cree el nuevo clúster.

    nota

    Es posible que el clúster tarde varios minutos en activarse.

Copia de un punto de conexión de un clúster

Para copiar el punto de conexión de su clúster de Amazon DocumentDB, realice el procedimiento siguiente:

Copia de un punto de conexión de un clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster del que desea copiar los detalles de conexión y, a continuación, elija Copiar punto de conexión para copiar la información del punto de conexión del clúster en el portapapeles.

  3. Ahora puede pegar el punto de conexión del clúster en sus documentos.

Apertura en el navegador

Abra sus clústeres de Amazon DocumentDB en la AWS consola para obtener más funciones de administración de clústeres. Para abrir la AWS consola en su clúster de Amazon DocumentDB en su navegador web predeterminado, complete el siguiente procedimiento.

Abrir el clúster en la consola AWS

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster que desee ver en la AWS consola y, a continuación, seleccione Abrir en el navegador.

  3. La AWS consola se abre en el clúster de Amazon DocumentDB en su navegador web predeterminado.

Ampliación de un clúster existente

Para escalar los clústeres de Amazon DocumentDB mediante la adición de instancias, realice el procedimiento siguiente:

Adición de una instancia para expandir el clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster que desea ampliar y elija Agregar una instancia para abrir el cuadro de diálogo Agregar una instancia en VS Code.

  3. Cuando se le solicite, ingrese un nombre para la nueva instancia en el campo de texto y, a continuación, pulse la tecla Enter para continuar.

  4. Cuando se le solicite, seleccione una clase de instancia de la lista para continuar.

  5. El Explorador de AWS muestra el estado de creación y se actualiza cuando la nueva instancia está lista.

Detención de un clúster

Para detener el clúster de Amazon DocumentDB, realice el procedimiento siguiente:

nota

Mientras el clúster esté detenido, la mayoría de las características de administración de clústeres no estarán disponibles.

Detención del clúster de Amazon DocumentDB

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Elija el botón Detener clúster situado junto al clúster que desea detener o haga clic con el botón derecho en el clúster y elija Detener clúster.

  3. Cuando se le solicite, elija Sí para detener el clúster o Cancelar a fin de cancelar el proceso de detención y dejar el clúster en ejecución.

  4. El Explorador de AWS muestra el estado del clúster y se actualiza cuando este se ha detenido.

Reinicio de una instancia

Reiniciar una instancia es útil para solucionar problemas y realizar cambios menores sin que afecte a todo el clúster. Para reiniciar una instancia de Amazon DocumentDB, realice el procedimiento siguiente:

Reinicio de una instancia del clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en la instancia del clúster que desea reiniciar y, a continuación, elija Reiniciar instancia.

  3. Cuando se le solicite, elija Sí para reiniciar la instancia o Cancelar a fin de cancelar el proceso de reinicio y dejar la instancia detenida.

  4. El Explorador de AWS muestra el estado del clúster y se actualiza cuando la instancia se ha reiniciado.

Eliminación de una instancia

Para eliminar una instancia del clúster de Amazon DocumentDB, realice el procedimiento siguiente.

nota

Eliminar una instancia no afecta a los datos del clúster. Si elimina la instancia principal, una de las instancias de réplica toma el relevo como instancia de escritura.

Eliminación de una instancia del clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en la instancia de clúster que desee eliminar y, a continuación, seleccione Eliminar para abrir el cuadro de diálogo de delete-cluster-instance confirmación en VS Code.

  3. Siga las instrucciones de confirmación y, a continuación, pulse la tecla Enter para eliminar su instancia del clúster.

  4. El Explorador de AWS muestra el estado de la instancia del clúster y se actualiza cuando la instancia se ha eliminado.

Visualización, adición y eliminación de etiquetas

Las etiquetas se utilizan con el fin de organizar los recursos de su entorno y realizar un seguimiento de estos. Para ver o editar las etiquetas asociadas a su clúster de Amazon DocumentDB, realice uno de los procedimientos siguientes:

Visualización de etiquetas de clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster para el que desea ver las etiquetas y, a continuación, elija Etiquetas… a fin de abrir el cuadro de diálogo Etiquetas para your cluster name.

  3. Las etiquetas aparecen en el cuadro de diálogo. Si no hay ninguna etiqueta asociada al clúster, se muestra el mensaje [No tags assigned].

Adición de etiquetas al clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster para el que desea agregar etiquetas y, a continuación, elija Etiquetas… a fin de abrir el cuadro de diálogo Etiquetas para your cluster name.

  3. Elija el botón Agregar etiqueta… para abrir el cuadro de diálogo Add Tag en VS Code.

  4. Ingrese una nueva etiqueta en el campo de texto y, a continuación, pulse la tecla Intro para continuar.

  5. Introduzca un valor en el campo de texto y, a continuación, pulse Entrar para añadir el key/value par al clúster.

Eliminación de etiquetas del clúster

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en el clúster del que desea eliminar etiquetas y, a continuación, elija Etiquetas… a fin de abrir el cuadro de diálogo Etiquetas para your cluster name.

  3. Elija el botón Eliminar etiqueta… para abrir el cuadro de diálogo Remove a tag from your cluster name en VS Code.

  4. Elija la etiqueta que desea eliminar en la lista proporcionada para eliminar la etiqueta del clúster.

Modificación de una clase de instancia

Para modificar la clase de instancia del clúster de Amazon DocumentDB, realice el procedimiento siguiente:

Modificación de una clase de instancia

  1. Desde AWS Toolkit for Visual Studio Code, expanda Amazon DocumentDB para mostrar sus clústeres de Amazon DocumentDB.

  2. Haga clic con el botón derecho en la instancia del clúster que desea modificar y, a continuación, elija Modificar clase… para abrir el cuadro de diálogo Select instance class en VS Code.

  3. Elija una nueva clase de instancia en la lista para actualizar la clase.

  4. El Explorador de AWS muestra el estado de la instancia del clúster y se actualiza cuando la clase de la instancia se ha actualizado.