Changer de plate-forme d'applications Linux en conteneurs

La page Migrer vers des conteneurs l'intégration à Cloud Code vous permet de moderniser les composants d'application Linux exécutés sur des machines virtuelles (VM) ; générer des artefacts qui peuvent être déployés Google Kubernetes Engine et Cloud Run, directement votre IDE à l'aide d'une machine Linux.

Ce guide explique comment transférer une application existante sur une plate-forme Conteneur GKE à l'aide de l'API Cloud Code dans votre IDE sur une machine Linux.

Ce guide est destiné aux développeurs qui utilisent une machine Linux de VS Code, vous connaissez avec Google Cloud, et disposer d'une VM exécutant son composant d'application.

Remarque :Pour suivre les étapes de ce guide, vous devez utiliser une machine Linux. Cloud Code n'est pas compatible avec le changement de plate-forme conteneurs sous Windows ou macOS.

Avant de commencer

1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Vérifiez que la facturation est activée pour votre projet Google Cloud.

4. Activez l'API Google Kubernetes Engine

   Activer l'API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Vérifiez que la facturation est activée pour votre projet Google Cloud.

7. Activez l'API Google Kubernetes Engine

   Activer l'API

8. Installez l'extension Cloud Code. si ce n'est pas déjà fait.
9. Créez et configurez un cluster GKE.
10. Assurez-vous de savoir quel type de migration vous souhaitez effectuer. Pour plus sur les charges de travail compatibles, consultez Examinez les versions d'OS, de charges de travail et de Kubernetes compatibles.
11. Préparation vos machines sources et locales afin de les moderniser. Cloud Code n'est compatible qu'avec Linux pour la modernisation.

Ajouter une source de changement de plate-forme

Dans cette section, vous allez installer la CLI du client de découverte Migration Center (mcdc) et d'autres les outils Migrate to Containers sur votre ordinateur local, si vous ne l'avez pas encore fait ; et ajoutez une source de changement de plate-forme en procédant comme suit:

1. Dans la barre d'activité de votre IDE, cliquez sur Cloud Code. puis développez l'explorateur Changer de plate-forme d'applications.

2. Si vous utilisez Migrate to Containers pour la première fois dans Cloud Code, vous devez installer la CLI mcdc et d'autres outils Migrate to Containers sur votre ordinateur local en cliquant sur Installer des outils Sinon, passez à l'étape suivante.

3. Cliquez sur Modifier les sources. Un fichier mcdc-sources.json vide s'ouvre. Ajouter vos sources au format suivant:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   Remarque :Vous pouvez utiliser les mêmes variables host, user et identityFile dans un commande SSH.

4. Pour voir les sources apparaître dans l'explorateur Changer de plate-forme d'applications, appuyez de manière prolongée sur passez la souris sur l'explorateur Changer de plate-forme d'applications, puis cliquez sur Bouton Actualiser les sources en cache qui s'affiche.

Facultatif: Générer une évaluation d'adéquation

Avant d'essayer de migrer votre application vers un conteneur, nous vous recommandons que vous générez une Évaluation de l'adéquation de votre source, qui vous indique si votre source peut changer de plate-forme pour un conteneur.

Pour générer une évaluation de l'adéquation de votre source, effectuez un clic droit sur votre source et sélectionnez Évaluer la source. Cela ouvre le terminal dans votre IDE et affiche les journaux de l'évaluation de votre source.

Une fois l'évaluation terminée, mcdc génère un rapport d'adéquation. Rapport d'évaluation dans votre IDE.

Si vos sources semblent adaptées, vous pouvez changer de plate-forme votre application.

Changer de plate-forme pour votre application

Cloud Code crée un espace de travail dédié pour chaque changement de plate-forme et vous permet d'exécuter les tâches Copier, Analyser et Générer dans l'espace de travail pour automatiser les étapes de changement de plate-forme. Si vous exécutez la tâche Generate (Générer) sans exécutant d'abord les tâches Copy (Copier) et Analyze (Analyser), il les exécute automatiquement avant de générer des artefacts.

Les sections suivantes vous guident tout au long de chacune de ces tâches et de reconfigurer votre application en conteneur à l'aide de Cloud Code.

Pour en savoir plus sur le cycle de vie d'une migration, consultez Architecture de la CLI Migrate to Containers

Créer un espace de travail de changement de plate-forme

Avant de créer un espace de travail de changement de plate-forme, vous devez savoir paramètres de migration à sélectionner pour le type de migration. Pour en savoir plus, sur les paramètres de chaque type de migration, consultez Créez un plan de migration.

Pour créer un nouvel espace de travail de changement de plate-forme avec des artefacts dans votre IDE, suivez ces étapes:

1. Dans l'explorateur Changer de plate-forme d'applications, effectuez un clic droit sur la source à modifier. changer de plate-forme, puis cliquez sur Changer de plate-forme.

2. Dans la liste des options qui s'affichent dans le menu, sélectionnez un changement de plate-forme. du client.

3. Sélectionnez un nouveau répertoire d'espace de travail pour changer la plate-forme de votre application, puis cliquez sur OK, puis cliquez sur Créer un espace de travail de changement de plate-forme.

4. Sélectionnez les paramètres de migration pour votre type de migration.

5. Facultatif: Si vous avez sélectionné le type de migration WebSphere et que vous souhaitez utiliser un lecteur binaire, sélectionnez le fichier binaryAppScanner.jar.

   La génération de l'espace de travail prend quelques secondes. Votre nouvel espace de travail s'ouvre dans une nouvelle fenêtre de votre IDE.

Copier des fichiers depuis votre VM vers votre espace de travail

Pour copier les fichiers de votre VM vers votre espace de travail dans votre IDE, exécutez la commande procédez comme suit:

1. Facultatif: La CLI mcdc applique des filtres pour réduire la taille de la copie, mais vous pouvez modifier le fichier filters.txt pour réduire davantage la taille de la copie. Pour savoir comment réduire la taille de la copie, consultez Réduisez la taille du système de fichiers copié.

2. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P.

3. Recherchez et sélectionnez Tasks: Run Task (Tâches : Exécuter la tâche), puis sélectionnez m2c: Copy (Copier). La copie des fichiers peut prendre quelques minutes.

Analyser le système de fichiers de la VM et générer un plan de migration

Pour analyser le système de fichiers de la VM et générer un plan de migration, exécutez la procédez comme suit:

1. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P.

2. Recherchez et sélectionnez Tasks: Run Task (Tâches : Exécuter la tâche), puis sélectionnez m2c: Analyze (m2c : Analyser).

   Si la tâche d'analyse échoue, vous devez modifier vos paramètres de migration via le fichier analyze-args.ini. Ce fichier comporte une ligne par paramètre, documentation d'accompagnement concernant le paramètre.

   Lorsque l'analyse réussit, Cloud Code crée un répertoire appelé migration-plan, qui contient les résultats de l'analyse sous la forme d'un config.yaml. Vous pouvez modifier ce fichier pour changer la manière dont vos artefacts sont présentés générées.

   La structure de votre fichier config.yaml varie en fonction du type de migration. Pour en savoir plus sur les types de migration compatibles, consultez les ressources suivantes : pages:

   • VM Linux
   • Serveurs Tomcat
   • Charges de travail WebSphere
   • Serveurs JBoss
   • Serveurs Apache
   • Sites WordPress

Générer des artefacts

Pour générer des artefacts, vous devez exécuter la tâche Generate (Générer) dans votre IDE. Si vous vous n'avez pas encore exécuté les tâches Copier et Analyser des sections précédentes, la tâche Generate (Générer) les exécute automatiquement avant de générer des artefacts.

Pour générer les artefacts, procédez comme suit:

1. Ouvrez la palette de commandes en appuyant sur Ctrl+Maj+P.

2. Recherchez et sélectionnez Tasks: Run Task (Tâches : Exécuter la tâche), puis sélectionnez m2c: Generate. Les artefacts sont alors générés dans le répertoire src, qui contient un skaffold.yaml utilisé pour créer et déployer une image de conteneur. Chaque le type de migration génère différents artefacts, mais tous les types de migration créer un ou plusieurs fichiers Docker et une spécification de déploiement GKE ; auquel skaffold.yaml fait référence.

   Une fois la génération d'artefacts terminée, vous avez fini de changer de plate-forme application!

3. Facultatif: Si vous souhaitez modifier le plan de migration, modifiez votre config.yaml et exécutez de nouveau la tâche m2c: Generate.

   Sinon, si vous êtes satisfait des résultats obtenus, vous pouvez continuer pour exécuter votre application dans un conteneur GKE.

Exécuter votre application dans un conteneur GKE

Dans cette section, vous allez exécuter votre application ayant changé de plate-forme dans un conteneur GKE, afficher les journaux de votre application en cours d'exécution et nettoyer les ressources.

Si vous n'avez pas encore créé et configuré suivez les instructions fournies dans l'article Créez et configurez un cluster GKE dans Cloud Code pour VS Code.

Pour en savoir plus sur le débogage des applications GKE, consultez Déboguer des applications Kubernetes avec Cloud Code for VS Code

Exécuter et afficher votre application

Maintenant que vous êtes prêt, vous pouvez exécuter votre application et l'afficher en direct. Cloud Code surveille les modifications apportées à votre système de fichiers afin que vous puissiez modifier et exécuter à nouveau votre application en temps réel.

Pour exécuter votre application, procédez comme suit :

1. Dans la barre d'état Cloud Code, cliquez sur le nom du projet actif.

   

2. Dans le menu de sélection rapide qui s'affiche, sélectionnez Exécuter sur Kubernetes.

3. Confirmez si vous souhaitez utiliser le contexte actif du cluster ou basculer vers un autre.

4. Si vous y êtes invité, choisissez un registre d'images vers lequel transférer les images. Si vous utilisez en créant un registre d'images à l'aide de gcr.io/PROJECT_ID, vérifiez que le registre d'images se trouve dans le même projet que votre cluster.

   Une fenêtre de résultat s'affiche, dans laquelle vous pouvez suivre la progression de votre application en cours d'exécution. Vous verrez également une diffusion en direct des journaux les pods en cours d'exécution dans la sortie du terminal.

5. Une fois votre application exécutée sur Kubernetes, la fenêtre de résultat affiche une adresse IP. Pour utiliser cette adresse IP associée afin d'accéder à votre application, appuyez sur Ctrl et cliquez sur l'adresse.

Une fois la session de débogage démarrée, le volet Development sessions (Sessions de développement) s'affiche. la vue de journalisation structurée. Lorsqu'une tâche commence, elle apparaît avec une demi-cercle tournant progress_activity

Si une tâche réussit, une coche check_circle apparaît à côté de l'étape.

Pour afficher les détails d'une étape, cliquez dessus dans la section Volet Session de développement. Le volet "Résultat" affiche l'étape dans la sortie de la journalisation.

Effectuer un nettoyage

Une fois l'application arrêtée, toutes les ressources Kubernetes déployées pendant l'exécution sont automatiquement supprimés.

Afin d'éviter que des frais ne soient facturés sur votre compte pour d'autres ressources utilisées au cours de cette n'oubliez pas de supprimer le projet ou le cluster que vous avez créé vous souhaitez réutiliser le projet.

Pour supprimer le cluster :

1. Cliquez sur . Cloud Code, puis développez l'explorateur Kubernetes.
2. Maintenez le pointeur sur le nom de votre cluster, puis cliquez sur open_in_new Ouvrez-les dans la console Google Cloud.
3. Cliquez sur Supprimer et de nouveau sur Supprimer.

Pour supprimer votre projet (et les ressources associées, y compris les clusters) :

Attention : La suppression d'un projet aura les effets suivants :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches de ce document, lorsque vous le supprimez, vous supprimez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. Dans la console Google Cloud, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Pour supprimer tous les fichiers locaux créés lors du processus de changement de plate-forme:

1. Ouvrez la palette de commandes (Ctrl+Maj+P).
2. Recherchez et sélectionnez Tâches: Exécuter la tâche, puis sélectionnez m2c: Nettoyage.