Realizar migraciones básicas de IIS - AWS Elastic Beanstalk
Explorando su entorno de IISPreparación para la migraciónTu primera migraciónControlar la migraciónMonitoreo del progresoVerificación de la migraciónAdministrar los artefactos de migración

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Realizar migraciones básicas de IIS

En esta sección, se explica el proceso de migración de las aplicaciones de IIS a Elastic eb migrate Beanstalk mediante el comando.

Explorando su entorno de IIS

Antes de realizar cualquier cambio, querrá saber qué recursos existen en su servidor. Comience por explorar sus sitios de IIS ejecutandoeb migrate explore, como se muestra en el siguiente ejemplo:

PS C:\migrations_workspace> eb migrate explore

Este comando revela sus sitios de IIS. Consulte la siguiente lista:

Default Web Site
Intranet
API.Internal
Reports

Para obtener una vista detallada de la configuración de cada sitio, incluidos los enlaces, las aplicaciones y los directorios virtuales, añada la --verbose opción, como se muestra en este ejemplo:

PS C:\migrations_workspace> eb migrate explore --verbose

En la siguiente lista se muestra la información completa sobre el entorno que proporciona el comando:

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

Comprensión del resultado del descubrimiento

El resultado detallado proporciona la siguiente información fundamental para la planificación de la migración:

Sitios

El resultado de la detección muestra una lista de todos los sitios de IIS del servidor. Cada sitio se identifica por su nombre (p. ej., «Sitio web predeterminado», «Intranet», «API.internal») y se numera secuencialmente. Cuando hay varios sitios en un servidor, el eb migrate comando puede empaquetarlos e implementarlos por separado o juntos, según la estrategia de migración.

Fijaciones

Los enlaces de protocolos revelan qué protocolos (HTTP/HTTPS) utilizan sus sitios y en qué puertos operan. La información de enlace incluye los requisitos de encabezado del host que definen las configuraciones de enrutamiento basadas en el dominio.

Aplicaciones

Las rutas de aplicación muestran las estructuras de aplicaciones raíz y anidadas dentro de la configuración de IIS. Las asignaciones de grupos de aplicaciones indican cómo se aíslan las aplicaciones entre sí para la seguridad y la administración de los recursos.

Directorios virtuales

Las asignaciones de rutas físicas indican dónde reside el contenido en el sistema de archivos. La configuración de autenticación muestra requisitos de acceso especiales que deben mantenerse después de la migración.

Preparación para la migración

Con una comprensión de su entorno, asegúrese de que su servidor cumpla los requisitos previos. En primer lugar, compruebe su versión de IIS con el siguiente PowerShell comando:

PS C:\migrations_workspace> Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\InetStp\" -Name MajorVersion

Necesita IIS 7.0 o posterior. La herramienta de migración utiliza Web Deploy 3.6 para empaquetar las aplicaciones. Verifique su instalación con el siguiente comando:

PS C:\migrations_workspace> Get-ItemProperty "HKLM:\SOFTWARE\Microsoft\IIS Extensions\MSDeploy\3" -Name InstallPath

Si Web Deploy no está instalado en su servidor, puede descargarlo desde la página de descargas de Microsoft Web Platform Installer.

Tu primera migración

Empecemos con una migración básica del sitio web predeterminado. El siguiente ejemplo muestra el comando más simple,eb migrate.

PS C:\migrations_workspace> eb migrate

Este comando inicia una serie de pasos automatizados, que se muestran en el siguiente resultado de ejemplo:

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

La herramienta de migración crea un directorio estructurado que contiene los artefactos de despliegue. La siguiente lista muestra la estructura de directorios:

C:\migration_workspace\
└── .\migrations\latest\
    └── upload_target\
        ├── DefaultWebSite.zip
        ├── aws-windows-deployment-manifest.json
        └── ebmigrateScripts\
            ├── site_installer.ps1
            ├── permission_handler.ps1
            └── >other helper scripts<

Controlar la migración

Para tener más control sobre el proceso de migración, puede especificar exactamente qué sitios migrar con el siguiente comando:

PS C:\migrations_workspace> eb migrate --sites "Default Web Site,Intranet"

También puede personalizar el nombre del entorno y el nombre de la aplicación, como se muestra en el siguiente comando de ejemplo:

PS C:\migrations_workspace> eb migrate `
    --sites "Default Web Site" `
    --application-name "CorporateApp" `
    --environment-name "Production"

Para obtener una lista completa de opciones, consulteeb migrate.

Monitoreo del progreso

Durante la migración, eb migrate proporciona actualizaciones de estado en tiempo real. Consulte el siguiente ejemplo de salida:

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

Verificación de la migración

Una vez que el entorno esté listo, Elastic Beanstalk proporciona varias formas de verificar la implementación.

Acceda a su aplicación

Abre la URL de la aplicación (CNAME) en un navegador web para comprobar que funciona correctamente.

Compruebe el estado del entorno

Utilice el eb health comando para ver el estado de su entorno.

PS C:\migrations_workspace> eb health

La siguiente imagen de pantalla muestra el estado de la instancia, las métricas de respuesta de las aplicaciones y la utilización de los recursos del sistema.

El resultado del comando eb health muestra el estado de la instancia, las métricas de respuesta de las aplicaciones y la utilización de los recursos del sistema.
Usa el eb logs comando para acceder a los registros y solucionar cualquier problema:
PS C:\migrations_workspace> eb logs --zip

El eb logs comando descarga los registros en el .elasticbeanstalk/logs directorio. Para obtener más información, consulte Uso de Elastic CloudWatch Beanstalk con Amazon Logs.

Conectarse a instancias

Si especificaste un key pair durante la migración, puedes conectarte a tus instancias mediante RDP para solucionar problemas directamente.

Acceda a la consola de Elastic Beanstalk

Puede ver el estado, los registros y las propiedades de configuración del entorno a través de la consola de administración del entorno correspondiente a ese entorno.

Administrar los artefactos de migración

El eb migrate comando crea artefactos locales durante el proceso de migración. Estos artefactos contienen información confidencial y, con el tiempo, pueden consumir una cantidad considerable de espacio en disco. Utilice el cleanup subcomando para gestionar estos artefactos, como se muestra en el siguiente ejemplo:

PS C:\migrations_workspace> eb migrate cleanup
Are you sure you would like to cleanup older artifacts within ./migrations/? (Y/N):

Para forzar la limpieza sin confirmación, utilice la --force opción:

PS C:\migrations_workspace> eb migrate cleanup --force

El proceso de limpieza conserva la última migración correcta del ./migrations/latest directorio y elimina los directorios de migración más antiguos