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 sin servidor, 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 que utilice DocumentDB sin servidor, siga estos pasos:

1. Compruebe si es preciso actualizar la versión del motor del clúster aprovisionado para usarla 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 sin servidor, actualice la versión del 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 más información sobre cómo elegir la configuración de escalado, consulte Selección del rango de capacidad de escalado para un clúster de DocumentDB sin servidor. Para modificar la configuración de escalado de un clúster, consulte Visualizació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 las limitaciones de DocumentDB sin servidor de Requisitos y limitaciones de DocumentDB sin servidor.

4. Añada una o varias instancias de DocumentDB sin servidor al clúster. Siga el procedimiento indicado en Añadido de una instancia de Amazon DocumentDB sin servidor.

   nota

   En algunos casos, es posible que ya tenga una o más instancias de lectura aprovisionadas en el clúster. De ser así, puede optar por convertir uno de los lectores en una instancia de DocumentDB sin servidor 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 de DocumentDB sin servidor en un clúster de escritura. Consulte Conmutación por error a Amazon DocumentDB.

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

Using the Consola de administración de AWS

El siguiente ejemplo de Consola de administración de AWS 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 se denomina sample y comienza con tres instancias aprovisionadas llamadas sample, sample2 y sample3. En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor.

1. Inicie sesión en la Consola de administración de AWS 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, seleccione la casilla de verificación del clúster al que desea 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 Sin servidor en la sección Clase de instancias de base de datos para cada nueva instancia sin servidor que desee crear.

6. En 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. Puede usar la consola o la para ver el estado de la instancia AWS CLI . Para obtener más información, consulte Supervisión del estado de un clúster de Amazon DocumentDB.

9. Volviendo a la tabla 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 la instancia de escritura. Transcurridos unos minutos, se completa el proceso de eliminación. El clúster existente ahora contiene tres instancias de DocumentDB sin servidor (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 se denomina sample y comienza con tres instancias aprovisionadas llamadas sample, sample2 y sample3. En este ejemplo, estas tres instancias se sustituirán por tres instancias sin servidor. El clúster comienza se llama sample-cluster y empieza con dos instancias aprovisionadas llamadas sample-provisioned-instance-1 y sample-provisioned-instance-2, una instancia de escritura y una de lectura.

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

Utilice aws docdb describe-db-clusters para determinar el estado de un clúster. El siguiente código 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

Añada las instancias sin servidor. En este ejemplo, se añaden las nuevas instancias sin servidor denominadas sample-serverless-instance-1 y sample-serverless-instance-2:

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

Introduzca 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

Realice una conmutación por error para que la nueva instancia de sample-serverless-instance-1 sea el nuevo clúster de escritura:

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. Verifíquelo 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 elementos de Amazon DocumentDB aprovisionados. Para obtener más información, consulte Migración a Amazon DocumentDB.