Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Réalisation de migrations IIS de base Cette section vous guide tout au long du processus de migration de vos applications IIS vers Elastic **eb migrate** Beanstalk à l'aide de la commande. ## Exploration de votre environnement IIS Avant d'apporter des modifications, vous devez connaître les ressources présentes sur votre serveur. Commencez par explorer vos sites IIS en exécutant**eb migrate explore**, comme illustré dans l'exemple suivant : ``` PS C:\migrations_workspace> eb migrate explore ``` Cette commande affiche vos sites IIS. Reportez-vous à la liste suivante : ``` Default Web Site Intranet API.Internal Reports ``` Pour une vue détaillée de la configuration de chaque site, y compris les liaisons, les applications et les répertoires virtuels, ajoutez l'`--verbose`option, comme indiqué dans cet exemple : ``` PS C:\migrations_workspace> eb migrate explore --verbose ``` La liste suivante présente les informations complètes sur votre environnement fournies par la commande : ``` 1: Default Web Site: - Bindings: - *:80:www.example.com - *:443:www.example.com - Application '/': - Application Pool: DefaultAppPool - Enabled Protocols: http - Virtual Directories: - /: - Physical Path: C:\inetpub\wwwroot - Logon Method: ClearText - Application '/api': - Application Pool: ApiPool - Enabled Protocols: http - Virtual Directories: - /: - Physical Path: C:\websites\api - Logon Method: ClearText 2: Intranet: ... 3. API.Internal: ... 4. Reports: ... ``` ### Comprendre le résultat de la découverte La sortie détaillée fournit les informations essentielles suivantes pour la planification de la migration : Sites Le résultat de découverte répertorie tous les sites IIS de votre serveur. Chaque site est identifié par son nom (par exemple, « Site Web par défaut », « Intranet », « API.Internal ») et numéroté de manière séquentielle. Lorsque plusieurs sites existent sur un serveur, la `eb migrate` commande peut empaqueter et déployer chacun d'eux séparément ou ensemble, en fonction de votre stratégie de migration. Reliures Les liaisons de protocole révèlent les protocoles (HTTP/HTTPS) utilisés par vos sites et les ports sur lesquels ils fonctionnent. Les informations de liaison incluent les exigences d'en-tête de l'hôte qui définissent les configurations de routage basées sur le domaine. Applications Les chemins d'application indiquent à la fois les structures d'application racine et imbriquées au sein de votre configuration IIS. Les attributions de pool d'applications indiquent comment vos applications sont isolées les unes des autres pour la gestion de la sécurité et des ressources. Répertoires virtuels Les mappages de chemins physiques indiquent l'emplacement de votre contenu dans le système de fichiers. Les paramètres d'authentification indiquent des exigences d'accès spéciales qui doivent être maintenues après la migration. ## Préparation de la migration Grâce à une bonne connaissance de votre environnement, assurez-vous que votre serveur répond aux prérequis. Vérifiez d'abord votre version d'IIS à l'aide de la PowerShell commande suivante : ``` PS C:\migrations_workspace> Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\InetStp\" -Name MajorVersion ``` Vous avez besoin d'IIS 7.0 ou version ultérieure. L'outil de migration utilise Web Deploy 3.6 pour empaqueter vos applications. Vérifiez son installation à l'aide de la commande suivante : ``` PS C:\migrations_workspace> Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\3" -Name InstallPath ``` Si Web Deploy n'est pas installé sur votre serveur, vous pouvez le télécharger depuis la page de téléchargement de [Microsoft Web Platform Installer](https://www.iis.net/downloads/microsoft/web-deploy). ## Votre première migration Commençons par une migration de base du site Web par défaut. L'exemple suivant montre la commande la plus simple,**eb migrate**. ``` PS C:\migrations_workspace> eb migrate ``` Cette commande lance une série d'étapes automatisées, illustrées dans l'exemple de sortie suivant : ``` Identifying VPC configuration of this EC2 instance (i-0123456789abcdef0) id: vpc-1234567890abcdef0 publicip: true elbscheme: public ec2subnets: subnet-123,subnet-456,subnet-789 securitygroups: sg-123,sg-456 elbsubnets: subnet-123,subnet-456,subnet-789 Using .\migrations\latest to contain artifacts for this migration run. Generating source bundle for sites, applications, and virtual directories... Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip ``` L'outil de migration crée un répertoire structuré contenant vos artefacts de déploiement. La liste suivante montre la structure du répertoire : ``` C:\migration_workspace\ └── .\migrations\latest\ └── upload_target\ ├── DefaultWebSite.zip ├── aws-windows-deployment-manifest.json └── ebmigrateScripts\ ├── site_installer.ps1 ├── permission_handler.ps1 └── >other helper scripts< ``` ## Contrôle de la migration Pour mieux contrôler le processus de migration, vous pouvez spécifier exactement les sites à migrer à l'aide de la commande suivante : ``` PS C:\migrations_workspace> eb migrate --sites "Default Web Site,Intranet" ``` Vous pouvez également personnaliser le nom de l'environnement et le nom de l'application, comme indiqué dans l'exemple de commande suivant : ``` PS C:\migrations_workspace> eb migrate ` --sites "Default Web Site" ` --application-name "CorporateApp" ` --environment-name "Production" ``` Pour une liste complète des options, voir[**eb migrate**](eb3-migrate.md). ## Surveillance de la progression Pendant la migration, **eb migrate** fournit des mises à jour de statut en temps réel. Reportez-vous à l'exemple de sortie suivant : ``` ... Creating application version Creating environment... This may take a few minutes 2024-03-18 18:12:15 INFO Environment details for: Production Application name: CorporateApp Region: us-west-2 Deployed Version: app-230320_153045 Environment ID: e-abcdef1234 Platform: 64bit Windows Server 2019 v2.7.0 running IIS 10.0 Tier: WebServer-Standard-1.0 CNAME: production.us-west-2.elasticbeanstalk.com Updated: 2024-03-20 15:30:45 2025-03-18 18:12:17 INFO createEnvironment is starting. 2025-03-18 18:12:19 INFO Using elasticbeanstalk-us-east-1-180301529717 as Amazon S3 storage bucket for environment data. 2025-03-18 18:12:40 INFO Created security group named: sg-0fdd4d696a26b086a 2025-03-18 18:12:48 INFO Environment health has transitioned to Pending. Initialization in progress (running for 7 seconds). There are no instances. ... 2025-03-18 18:23:59 INFO Application available at EBMigratedEnv-arrreal3.us-east-1.elasticbeanstalk.com. 2025-03-18 18:24:00 INFO Successfully launched environment: EBMigratedEnv-arrreal3 ``` ## Vérification de la migration Une fois l'environnement prêt, Elastic Beanstalk propose plusieurs méthodes pour vérifier votre déploiement. Accédez à votre application Ouvrez l'URL de votre application (CNAME) dans un navigateur Web pour vérifier qu'elle fonctionne correctement. Vérifiez la santé de l'environnement Utilisez la **eb health** commande pour vérifier l'état de votre environnement. ``` PS C:\migrations_workspace> eb health ``` L'image d'écran suivante montre l'état de santé de l'instance, les mesures de réponse des applications et l'utilisation des ressources système. ![Le résultat de la commande Web Health indique l'état de l'instance, les mesures de réponse des applications et l'utilisation des ressources du système.](http://docs.aws.amazon.com/fr_fr/elasticbeanstalk/latest/dg/images/eb-health-after-migration.png) Utilisez la **eb logs** commande pour accéder aux journaux afin de résoudre les problèmes éventuels : ``` PS C:\migrations_workspace> eb logs --zip ``` La **eb logs** commande télécharge les journaux `.elasticbeanstalk/logs` dans le répertoire. Pour de plus amples informations, veuillez consulter [Utilisation d'Elastic CloudWatch Beanstalk avec Amazon Logs](AWSHowTo.cloudwatchlogs.md). Connect aux instances Si vous avez spécifié une paire de clés lors de la migration, vous pouvez vous connecter à vos instances à l'aide du protocole RDP pour un dépannage direct. Accédez à la console Elastic Beanstalk Vous pouvez consulter l'état, les journaux et les propriétés de configuration de l'[environnement via la console de gestion](environments-console.md) de l'environnement correspondant. ## Gestion des artefacts de migration La **eb migrate** commande crée des artefacts locaux pendant le processus de migration. Ces artefacts contiennent des informations sensibles et peuvent consommer beaucoup d'espace disque au fil du temps. Utilisez la **cleanup** sous-commande pour gérer ces artefacts, comme indiqué dans l'exemple suivant : ``` PS C:\migrations_workspace> eb migrate cleanup Are you sure you would like to cleanup older artifacts within ./migrations/? (Y/N): ``` Pour forcer le nettoyage sans confirmation, utilisez l'**--force**option suivante : ``` PS C:\migrations_workspace> eb migrate cleanup --force ``` Le processus de nettoyage préserve la migration réussie la plus récente dans le `./migrations/latest` répertoire et supprime les anciens répertoires de migration