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

Vous devez d'abord avoir créé une migration et exécuté la migration.
Assurez-vous que l'utilisateur qui effectue le téléchargement dispose d'un accès en lecture au dépôt d'artefacts. Voir Définir des dépôts de données pour plus d'informations.

À 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 :

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

Accéder à la page Migrate to Containers
Cliquez sur l'onglet Migrations pour afficher un tableau contenant les migrations disponibles.
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.
Sélectionnez l'onglet Artifacts.
Sélectionnez Fichier Docker, spécifications de déploiement et autres artefacts pour ouvrir le bucket Cloud Storage contenant les artefacts.
Sélectionnez tous les fichiers, puis sélectionnez Télécharger.
Remarque : Si vous avez activé les journaux d'accès aux données Cloud Audit Logging sur le bucket, une tentative de téléchargement de ces fichiers peut renvoyer une erreur HTTP 403. Pour contourner ce problème, procédez comme suit :
1. Sélectionnez un nom de fichier dans le bucket, tel que Dockerfile, pour afficher les détails du fichier. L'URI gsutil est inclus dans les détails.
2. Pour chaque artefact, utilisez gsutil pour télécharger l'artefact en fonction de son URI gsutil :
```
gsutil cp gsutil URI ./
```
  Exemple :
```
gsutil cp gs://bucket-name/ae2e-7f-48-57-6be/Dockerfile ./
```

CRD

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

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

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

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"

Ouvrez les URL artifacts dans un navigateur pour télécharger les artefacts.
Remarque : Si vous avez activé les journaux d'accès aux données Cloud Audit Logging sur le bucket, ces URL peuvent renvoyer une erreur HTTP 403. Pour contourner ce problème, procédez comme suit :
1. Accédez à la page du navigateur Cloud Storage dans la console Google Cloud.
2. Repérez le bucket et le dossier de chaque artefact de votre migration à l'aide de l'URL du fichier manifeste YAML.
3. Pour chaque artefact, sélectionnez le lien de téléchargement ou utilisez gsutil pour télécharger l'artefact en fonction de son URI :
```
gsutil cp URI ./
```

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

Migrer à l'aide de Google Cloud

Déploiement

Examiner les artefacts générés.
Configurer la journalisation.
Installer des volumes externes.
Déployer une charge de travail sur un cluster cible.
Déployer des VM migrées.
Mettre à jour des images post-migration
Surveiller la charge de travail migrée.
Testez votre application à migrer et validez la migration.

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

Avant de commencer

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

Télécharger tous les fichiers d'artefact

migctl

Console

CRD

deployment_spec.yaml

Dockerfile

migration.yaml

blocklist.yaml

Étapes suivantes

Linux

Migrer à l'aide de Google Cloud

Déploiement

Windows

Migrer à l'aide de Google Cloud

Déployer

Tomcat

Migrer à l'aide d'un ordinateur local

Migrer à l'aide de Google Cloud

Déployer

WebSphere

Migrer à l'aide d'un ordinateur local

Migrer à l'aide de Google Cloud

Déployer

JBoss

Migrer à l'aide d'un ordinateur local

Migrer à l'aide de Google Cloud

Déployer

Apache

Migrer à l'aide d'un ordinateur local

Migrer à l'aide de Google Cloud

Déployer

WordPress

Migrer à l'aide de Google Cloud

Déployer