Exportar datos al Centro de migraciones

Después de recopilar los datos sobre tus elementos, puedes exportarlos al Centro de migraciones, donde puedes hacer lo siguiente:

En este documento, se describe cómo exportar los datos al Centro de migraciones para realizar una evaluación en línea con la CLI de cliente de descubrimiento del Centro de migraciones.

Antes de comenzar

  1. Completa los pasos para descubrir recursos en tu infraestructura.
  2. En la consola de Google Cloud, activa el Centro de migraciones.
  3. Habilita la API de Cloud Resource Manager.

    Habilitar la API

Revisa los roles y permisos necesarios

Si quieres obtener los permisos que necesitas para exportar los datos recopilados al Centro de migraciones, pídele a tu administrador que te otorgue el rol de IAM Administrador del Centro de migraciones (migrationcenter.admin) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Cómo administrar el acceso.

Este rol predefinido contiene los permisos necesarios para exportar los datos recopilados al Centro de migraciones. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para exportar los datos recopilados al Centro de migraciones:

  • resourcemanager.projects.get
  • migrationcenter.sources.create
  • migrationcenter.sources.get
  • migrationcenter.assets.reportFrames

Es posible que también puedas obtener estos permisos con funciones personalizadas o con otras funciones predefinidas.

Configura la autenticación en el Centro de migraciones

Para exportar los datos recopilados al Centro de migraciones, primero debes configurar la autenticación en el Centro de migraciones con uno de los siguientes métodos:

  • Usar una cuenta personal
  • Utiliza una cuenta de servicio

Para usar estos métodos con Google Cloud CLI como se describe en este documento, debes instalar e inicializar gcloud CLI.

Configura la autenticación con una cuenta personal

Configura la autenticación con una cuenta de servicio

  1. Si tienes los permisos necesarios, crea una cuenta de servicio:

    gcloud iam service-accounts create SA_NAME \
        --description='SA_DESCRIPTION' \
        --display-name='SA_DISPLAY_NAME'
    

    Reemplaza lo siguiente:

    • SA_NAME: Es el nombre que deseas para la cuenta de servicio.
    • SA_DESCRIPTION: Es una descripción opcional para la cuenta de servicio.
    • SA_DISPLAY_NAME: Es el nombre visible de la cuenta de servicio.
  2. Para otorgar los permisos necesarios a la cuenta de servicio, asigna la función migrationcenter.admin:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member='serviceAccount:SA_NAME@PROJECT_ID.iam.gserviceaccount.com' \
        --role='roles/migrationcenter.admin'
    

    Reemplaza PROJECT_ID por el nombre de tu proyecto.

  3. Crea una clave de cuenta de servicio:

    gcloud iam service-accounts keys create ~/sa-private-key.json \
     --iam-account=SA_NAME@PROJECT_ID.iam.gserviceaccount.com \
     --billing-project PROJECT_ID
    

    La clave se guarda en la ruta especificada: ~/sa-private-key.json.

  4. Copia el archivo de claves en la máquina en la que deseas ejecutar la CLI de mcdc.

Limitaciones

Exporta los datos recopilados

Después de configurar la recopilación de datos y la autenticación en el Centro de migraciones, puedes continuar con la exportación de los datos recopilados al Centro de migraciones.

  • Para exportar los datos recopilados de tu estación de trabajo al Centro de migraciones, ejecuta el siguiente comando:

    Linux

    ./mcdc export mc --project PROJECT_ID

    Windows

    mcdc.exe export mc --project PROJECT_ID

    Reemplaza PROJECT_ID por el nombre de tu proyecto.

  • Si configuraste la autenticación en el Centro de migraciones con una clave de cuenta de servicio, debes proporcionar la ruta de acceso al archivo de claves JSON con la marca --sa-key:

    Linux

    ./mcdc export mc --project PROJECT_ID --json-key PATH_TO_JSON_KEY

    Windows

    mcdc.exe export mc --project PROJECT_ID --json-key PATH_TO_JSON_KEY

    Reemplaza PATH_TO_JSON_KEY por la ruta de acceso al archivo de claves JSON.

    De forma opcional, si deseas esperar a que el Centro de migraciones termine de procesar los recursos y verifiques si todo el trabajo se realizó de forma correcta, usa la marca --wait con el comando export.

Una vez que se completa la exportación, el cliente de descubrimiento imprime un vínculo que puedes seguir para ver tus recursos en el Centro de migraciones.

¿Qué sigue?