Réalisation de migrations IIS de base - AWS Elastic Beanstalk
Exploration de votre environnement IISPréparation de la migrationVotre première migrationContrôle de la migrationSurveillance de la progressionVérification de la migrationGestion des artefacts de migration

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écutanteb 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'--verboseoption, 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.

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 illustré 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, voireb migrate.

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.
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.

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 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'--forceoption 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