Revisa los archivos de implementación generados

Una vez que termines de migrar una carga de trabajo mediante un clúster de procesamiento, descarga los archivos YAML que se generaron como parte de la migración.

Estos archivos, denominados artefactos de migración, se generaron para que puedas implementar el contenedor de carga de trabajo migrada en otro clúster, como un clúster de prueba o de producción.

En este tema, se describe cómo puedes descargar los archivos de artefactos generados y revisarlos para tu uso personal en otro clúster.

Antes de comenzar

Acerca de los archivos de artefactos generados

Entre los archivos de artefactos generados durante la migración, se incluyen los siguientes:

  • deployment_spec.yaml: Es el archivo YAML que configura tu carga de trabajo.

    Puedes usar kubectl apply con este archivo para implementar la carga de trabajo en otro clúster, como un clúster de producción o de prueba.

  • Dockerfile: El Dockerfile que se usa para compilar la imagen de la VM migrada.

  • blocklist.yaml: la lista de servicios del contenedor que quieres inhabilitar según tu configuración en el plan de migración. Edita este archivo para controlar la lista de servicios. Consulta Personaliza la lista de servicios.

  • migration.yaml: Es una copia del plan de migración.

    Puedes usar este archivo para verificar lo que se realizó como parte de la migración.

  • logs.yaml: Es una lista de archivos de registro detectados en la VM de origen. Los datos que la carga de trabajo migrada escribe en estos archivos de registro se reenvían a Cloud Logging. Edita este archivo para controlar la escritura de registros. Consulta Personaliza los datos de registro escritos en Cloud Logging.

Estos archivos se describen con más detalle a continuación.

Descarga todos los archivos de artefactos

migctl

Cuando se complete la migración, deberías ver un mensaje como el siguiente cuando solicitas el estado:

migctl migration status my-migration

NAME            CURRENT-OPERATION       PROGRESS        STEP            STATUS    AGE
my-migration    GenerateArtifacts       [1/1]           ExtractImage    Completed 14m23s

Una vez que se complete la migración, descarga todos los archivos de artefactos generados con migctl migration get-artifacts.

migctl migration get-artifacts my-migration

Console

Cuando se complete la migración, verás los artefactos generados en la columna Estado de la migración. Para descargar todos los artefactos de migración, sigue estos pasos:

  1. Abre la página Migrate to Containers en la consola de Google Cloud.

    Ir a la página Migrate to Containers

  2. Haz clic en la pestaña Migraciones para ver una tabla con las migraciones disponibles.

  3. Haz clic en el Nombre de la migración en la fila de la migración deseada. Se abrirá la pestaña Detalles de la migración de la VM.

  4. Selecciona la pestaña Artefactos.

  5. Selecciona Archivo de Docker, especificaciones de implementación y otros artefactos para abrir el bucket de Cloud Storage que contiene los artefactos.

  6. Selecciona todos los archivos y, luego, selecciona Descargar.

CRD

Cuando se complete la migración, descarga todos los artefactos de migración:

  1. Obtén el depósito de Cloud Storage que contiene los artefactos:

    kubectl get migrations.anthos-migrate.cloud.google.com -n v2k-system my-migration -o jsonpath={.status.artifacts.deploymentFiles.bucket}

    Este comando muestra el nombre del bucket con el siguiente formato:

    bucket-migration-artifacts

  2. Obtén el archivo de manifiesto YAML de migración de Cloud Storage:

    kubectl get migrations.anthos-migrate.cloud.google.com -n v2k-system my-migration -o jsonpath={.status.artifacts.deploymentFiles.artifactsManifestFile}

    Este comando muestra el nombre del archivo de manifiesto yaml con el siguiente formato:

    bucket-migration-artifacts/v2k-system-my-migration/ID/manifest.yaml

  3. Ve a Cloud Storage en la consola de Google Cloud y recupera el archivo de manifiesto. El archivo de manifiesto de ejemplo que se muestra a continuación incluye las URL de los artifacts:

    artifacts:
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/deployment_spec.yaml
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/Dockerfile
 - https:/storage.cloud.google.com/bucket-name/v2k-system-my-migration/ID/migration.yaml
imageUrl: gcr.io/velos-auto-1/matanvm:v1.0.0
name: m1-84xqp
namespace: v2k-system
uid: daf762-d9-42-bfc-47b71255a
version: "1.0"

  4. Abre las URL artifacts en un navegador para descargar los artefactos.

deployment_spec.yaml

Este es un archivo YAML que puedes usar para implementar tu carga de trabajo en otro clúster, como un clúster de prueba o de producción. Si no configuras una migración de datos, generarás un objeto de implementación. Cuando se configura la migración de datos, generas un objeto de conjunto con estado.

Dockerfile

El Dockerfile que se usa para compilar la imagen de la VM migrada.

Usa este archivo si necesitas generar una versión nueva de la imagen. Por ejemplo, puede que quieras instalar un paquete y, luego, capturar una imagen nueva. Volver a compilar la imagen también puede ser útil cuando se actualiza Migrate to Containers (por ejemplo, con una corrección de errores) y deseas volver a compilar la imagen con el entorno de ejecución nuevo de Migrate to Containers. El entorno de ejecución actualizado está disponible en Container Registry.

Puedes editar este archivo como lo harías con cualquier otro Dockerfile para personalizar la imagen. Si quieres obtener sugerencias, consulta Prácticas recomendadas para escribir Dockerfiles. Además, consulta Actualizaciones de imágenes posteriores a la migración para obtener información sobre cómo editar el Dockerfile.

# Please refer to the documentation:
# https://cloud.google.com/migrate/containers/docs/dockerfile-reference

FROM gcr.io/my-project/v2k-run-embedded:v1.12.0

# Image containing data captured from the source VM
FROM gcr.io/my-project/my-vm-instance-1-non-runnable-base:v1.0.0 as source-content

COPY --from=migrate-for-anthos-runtime / /

ADD blocklist.yaml /.m4a/blocklist.yaml

ADD logs.yaml /code/config/logs/logsArtifact.yaml

# If you want to update parts of the image, add your commands here.
# For example:
# RUN apt-get update
# RUN apt-get install -y \
#       package1=version \
#       package2=version \
#       package3=version
# RUN yum update
# RUN wget http://github.com

# Migrate to Containers image includes entrypoint
ENTRYPOINT [ "/.v2k.go" ]

migration.yaml

Este archivo es una copia de la migración que creaste. Usa este archivo para verificar que los detalles de migración que Migrate to Containers usa coincidan con los que especificaste en el plan de migración.

Ten en cuenta que no debes usar este archivo para volver a ejecutar la migración. Después de ejecutar la migración, solo puedes volver a ejecutarla si la borras (con migctl migration delete o la consola de Google Cloud) y la ejecutas de nuevo en tu plan de migración.

blocklist.yaml

En este archivo, se enumeran los servicios de contenedores que se inhabilitarán según la configuración en el plan de migración. Consulta Personaliza la lista de servicios para obtener más información sobre el uso de este archivo.

¿Qué sigue?