Migración a Amazon DocumentDB sin servidor

Migración de los clústeres de DocumentDB existentes a sistemas sin servidor

Actualización de la versión del motor de un clúster

Si el clúster aprovisionado ejecuta una versión de motor inferior que no admite DocumentDB serverless, primero debe actualizar el clúster a una versión de motor compatible. Para obtener más información, consulte Actualización local de la versión principal Amazon DocumentDB.

Migración de un clúster aprovisionado a DocumentDB sin servidor

Para cambiar un clúster aprovisionado para usar DocumentDB sin servidor, siga estos pasos:

1. Compruebe si es necesario actualizar la versión del motor del clúster aprovisionado para poder utilizarla con DocumentDB sin servidor. Consulte Requisitos y limitaciones de DocumentDB sin servidor.

   nota

   Si el clúster aprovisionado ejecuta una versión de motor que no está disponible para DocumentDB serverless, actualice la versión de motor del clúster. Consulte Actualización local de la versión principal Amazon DocumentDB.

2. Defina la configuración de escalado del clúster. Para obtener detalles sobre cómo elegir la configuración de escalado, consulte. Selección del rango de capacidad de escalado para un clúster sin servidor de DocumentDB Para modificar la configuración de escalado de un clúster, consulteVisualización y modificación de la configuración del rango de capacidad de escalado de un clúster.

3. Configure cualquier otra propiedad del clúster para tener en cuenta los requisitos y limitaciones de DocumentDB sin servidor de. Requisitos y limitaciones de DocumentDB sin servidor

4. Agregue una o más instancias sin servidor de DocumentDB al clúster. Siga el procedimiento indicado en Añadir una instancia sin servidor de Amazon DocumentDB.

   nota

   En algunos casos, es posible que ya tenga una o más instancias de lectura aprovisionadas en el clúster. Si es así, puede optar por convertir uno de los lectores en una instancia sin servidor de DocumentDB en lugar de crear una nueva instancia. Para ello, siga el procedimiento en Cambio de la clase de una instancia.

5. (Opcional) Realice una operación de conmutación por error para convertir una instancia sin servidor de DocumentDB en el escritor de clústeres. Consulte Conmutación por error a Amazon DocumentDB.

6. (Opcional) Convierta las instancias de Amazon DocumentDB aprovisionadas restantes en instancias sin servidor de DocumentDB (Cambio de la clase de una instanciaconsulte) o elimínelas del clúster (consulte). Eliminación de una instancia de Amazon DocumentDB

Using the AWS Management Console

El siguiente ejemplo de AWS Management Console configuración muestra el proceso de migración mediante un clúster aprovisionado de Amazon DocumentDB que ejecuta Amazon DocumentDB 5.0.0, que no requiere una actualización de la versión del motor para empezar a utilizar DocumentDB serverless. El clúster recibe un nombre y comienza con tres instancias aprovisionadas denominadassample, y. sample sample2 sample3 En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor.

1. Inicie sesión en la AWS Management Console de Amazon DocumentDB y ábrala.

2. 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.

   Aparece la tabla Clústeres.

3. En la tabla Clústeres, selecciona la casilla del clúster al que quieres añadir una instancia sin servidor.

4. Elija Actions (Acciones) y después Add instances (Añadir instancias).

5. En el cuadro de diálogo Añadir instancias, seleccione Serverless en la sección de clases de instancias de base de datos para cada nueva instancia sin servidor que desee crear.

6. Para los ajustes de capacidad sin servidor, defina la configuración de escalado en función de la descripción de la capacidad del cuadro de diálogo.

7. (Opcional) Para añadir otra instancia, elija Añadir instancia. Siga añadiendo instancias hasta alcanzar el número deseado de instancias nuevas.

   En este ejemplo, se crean tres nuevas instancias sin servidor.

8. Seleccione Crear.

   La creación de una instancia puede tardar varios minutos. Puedes usar la consola o la AWS CLI para ver el estado de la instancia. Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

9. Volviendo a la tabla de clústeres, seleccione las casillas de verificación de las tres instancias aprovisionadas originales.

10. Elija Acciones y, a continuación, elija Eliminar.

Durante la eliminación, se realiza automáticamente una conmutación por error para convertir a una de las instancias restantes en grabadora. Transcurridos unos minutos, se completa el proceso de borrado. El clúster existente ahora contiene tres instancias sin servidor de DocumentDB (tal y como se define en la columna Tamaño).

Using the AWS CLI

El siguiente ejemplo de AWS CLI configuración muestra el proceso de migración mediante un clúster aprovisionado de Amazon DocumentDB que ejecuta Amazon DocumentDB 5.0.0, que no requiere una actualización de la versión del motor para empezar a utilizar DocumentDB serverless. El clúster recibe un nombre y comienza con tres instancias aprovisionadas denominadassample, y. sample sample2 sample3 En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor. El clúster recibe un nombre sample-cluster y comienza con dos instancias aprovisionadas denominadas sample-provisioned-instance-1 Ysample-provisioned-instance-2, una instancia de escritura y una instancia de lectura.

En el siguiente ejemplo, sustituya cada una user input placeholder por su propia información o parámetros de configuración.

Utilice la aws docdb describe-db-clusters operación para determinar el estado de un clúster. El código siguiente busca el estado del clúster sample-cluster y muestra los resultados en una tabla:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table

--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

Añada la configuración de escalado del clúster:

aws docdb modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --serverless-v2-scaling-configuration MinCapacity=0.5,MaxCapacity=16

Agregue las instancias sin servidor. En este ejemplo, las nuevas instancias sin servidor se denominan sample-serverless-instance-1 y sample-serverless-instance-2 se agregan:

aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-1 \
    --db-instance-class db.serverless \
    --engine docdb

aws docdb create-db-instance \
    --db-cluster-identifier sample-cluster \
    --db-instance-identifier sample-serverless-instance-2 \
    --db-instance-class db.serverless \
    --engine docdb

Introduce lo siguiente para esperar a que las instancias sin servidor estén disponibles antes de continuar:

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-1

aws docdb wait db-instance-available \
    --db-instance-identifier sample-serverless-instance-2

Realiza una conmutación por error para convertir la nueva sample-serverless-instance-1 instancia en la grabadora de clústeres:

aws docdb failover-db-cluster \
    --db-cluster-identifier sample-cluster \
    --target-db-instance-identifier sample-serverless-instance-1

La conmutación por error tarda unos segundos en completarse, tras lo cual sample-serverless-instance -1 pasa a ser el grabador del clúster. Compruébelo con la siguiente entrada:

aws docdb describe-db-clusters \
    --db-cluster-identifier sample-cluster \
    --query 'DBClusters[*].DBClusterMembers' \
    --output table

--------------------------------------------------------------------------------------------------------
|                                          DescribeDBClusters                                          |
+--------------------------------+---------------------------------+------------------+----------------+
|  DBClusterParameterGroupStatus |      DBInstanceIdentifier       | IsClusterWriter  | PromotionTier  |
+--------------------------------+---------------------------------+------------------+----------------+
|  in-sync                       |  sample-provisioned-instance-2  |  False           |  1             |
|  in-sync                       |  sample-provisioned-instance-1  |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-2   |  False           |  1             |
|  in-sync                       |  sample-serverless-instance-1   |  True            |  1             |
+--------------------------------+---------------------------------+------------------+----------------+

Por último, elimine las instancias aprovisionadas originales:

aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-1

aws docdb delete-db-instance \
    --db-instance-identifier sample-provisioned-instance-2

Migración de MongoDB a DocumentDB sin servidor

Puede migrar sus bases de datos de MongoDB a DocumentDB sin servidor, igual que con Amazon DocumentDB aprovisionado. Para obtener más información, consulte Migración a Amazon DocumentDB.