Examiner les fichiers de déploiement générés

Une fois que vous avez terminé la migration d'une charge de travail à l'aide d'un cluster de traitement, téléchargez les fichiers YAML générés dans le cadre de la migration.

Ces fichiers, appelés artefacts de migration, ont été générés pour vous permettre de déployer votre conteneur de charge de travail migré vers un autre cluster, tel qu'un cluster de test ou de production.

Cet article explique comment télécharger les fichiers d'artefact générés et les vérifier pour les utiliser dans un autre cluster.

Avant de commencer

À propos des fichiers d'artefact générés

Les fichiers d'artefact générés lors de la migration incluent les éléments suivants :

  • deployment_spec.yaml : fichier YAML qui configure votre charge de travail.

    Vous pouvez utiliser kubectl apply avec ce fichier pour déployer la charge de travail sur un autre cluster, tel qu'un cluster de production ou de test.

  • Dockerfile : fichier utilisé pour créer l'image pour votre VM migrée.

  • blocklist.yaml : liste des services de conteneurs à désactiver en fonction de vos paramètres dans le plan de migration. Modifiez ce fichier pour contrôler la liste des services. Consultez la section Personnaliser la liste de services.

  • migration.yaml : copie du plan de migration.

    Vous pouvez l'utiliser pour vérifier ce qui a été fait dans le cadre de la migration.

  • logs.yaml : liste des fichiers journaux détectés sur la VM source. Les données écrites dans ces fichiers journaux par la charge de travail migrée sont transférées vers Cloud Logging. Modifiez ce fichier pour contrôler l'écriture des journaux. Consultez la section Personnaliser les données de journaux écrites dans Cloud Logging.

Ces fichiers sont décrits plus en détail ci-dessous.

Télécharger tous les fichiers d'artefact

migctl

Une fois la migration terminée, un message tel que celui ci-dessous s'affiche lorsque vous interrogez l'état :

migctl migration status my-migration

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

Une fois la migration terminée, téléchargez tous les fichiers d'artefact générés avec migctl migration get-artifacts.

migctl migration get-artifacts my-migration

Console

Une fois la migration terminée, l'état Artefacts générés s'affiche dans la colonne État de la migration. Pour télécharger tous les artefacts de migration, procédez comme suit :

  1. Ouvrez la page "Migrate to Containers" dans la console Google Cloud.

    Accéder à la page Migrate to Containers

  2. Cliquez sur l'onglet Migrations pour afficher un tableau contenant les migrations disponibles.

  3. Cliquez sur le nom de la migration sur la ligne de la migration souhaitée. L'onglet Détails de la migration s'affiche pour la VM.

  4. Sélectionnez l'onglet Artifacts.

  5. Sélectionnez Fichier Docker, spécifications de déploiement et autres artefacts pour ouvrir le bucket Cloud Storage contenant les artefacts.

  6. Sélectionnez tous les fichiers, puis sélectionnez Télécharger.

CRD

Une fois la migration terminée, téléchargez tous les artefacts de migration :

  1. Obtenez le bucket Cloud Storage contenant les artefacts :

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

    Cette commande renvoie le nom du bucket au format suivant :

    bucket-migration-artifacts
  2. Obtenez le fichier manifeste YAML de migration Cloud Storage :

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

    Cette commande renvoie le nom du fichier manifeste YAML au format suivant :

    bucket-migration-artifacts/v2k-system-my-migration/ID/manifest.yaml
  3. Accédez à Cloud Storage dans la console Google Cloud et récupérez le fichier manifeste. L'exemple de fichier manifeste présenté ci-dessous inclut les URL 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. Ouvrez les URL artifacts dans un navigateur pour télécharger les artefacts.

deployment_spec.yaml

Il s'agit d'un fichier YAML que vous pouvez utiliser pour déployer votre charge de travail sur un autre cluster, tel qu'un cluster de test ou de production. Si vous ne configurez pas la migration des données, vous allez générer un objet Déploiement. Lorsque la migration de données est configurée, vous générez un objet d'ensemble avec état.

Dockerfile

Il s'agit du fichier utilisé pour créer l'image pour votre VM migrée.

Utilisez ce fichier si vous devez générer une nouvelle version de l'image. Par exemple, vous pouvez installer un package et capturer une nouvelle image par la suite. Ceci peut également être utile lorsque vous mettez à jour Migrate to Containers (par exemple avec une correction de bug) et que vous souhaitez reconstruire l'image avec le nouvel environnement d'exécution de Migrate to Containers. L'environnement d'exécution mis à niveau est disponible dans Container Registry.

Vous pouvez modifier ce fichier comme n'importe quel autre Dockerfile pour personnaliser votre image. Pour obtenir des conseils, consultez la section Bonnes pratiques pour l'écriture de fichiers Dockerfile. Pour en savoir plus sur la modification du fichier Dockerfile, consultez également l'article Mises à jour des images post-migration.

# 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

Il s'agit d'une copie de la migration que vous avez créée. Utilisez ce fichier pour vérifier que les informations de migration utilisées par Migrate to Containers correspondent à celles que vous avez spécifiées dans le plan de migration.

Notez que vous ne devez pas utiliser ce fichier pour relancer la migration. Une fois la migration terminée, vous ne pouvez la réexécuter qu'après l'avoir supprimée (à l'aide de migctl migration delete ou de Google Cloud Console). Vous devez l'exécuter une nouvelle fois à partir de votre plan de migration.

blocklist.yaml

Ce fichier répertorie les services de conteneurs à désactiver en fonction de vos paramètres dans le plan de migration. Pour en savoir plus sur l'utilisation de ce fichier, consultez la section Personnaliser la liste de services.

Étapes suivantes

Linux

Windows

Tomcat

WebSphere

JBoss

Apache

WordPress