

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.

# Realización de migraciones básicas de IIS
<a name="dotnet-migrating-applications-basic-migration"></a>

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

## Exploración de su entorno de IIS
<a name="dotnet-migrating-applications-basic-migration-exploring"></a>

Antes de realizar cualquier cambio, querrá saber qué recursos existen en su servidor. Comience por explorar sus sitios de IIS mediante la ejecución de **eb 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 opción `--verbose`, 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 de la detección
<a name="dotnet-migrating-applications-basic-migration-exploring-output"></a>

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 en su servidor. Cada sitio se identifica por su nombre (por ejemplo, «Sitio web predeterminado», «Intranet», «API.internal») y se numera secuencialmente. Cuando hay sitios múltiples en un servidor, el comando `eb migrate` puede empaquetarlos e implementarlos por separado o juntos, según la estrategia de migración.

Enlaces  
Los enlaces de protocolos revelan qué protocolos (HTTP/HTTPS) utilizan sus sitios y en qué puertos funcionan. 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
<a name="dotnet-migrating-applications-basic-migration-preparing"></a>

Con una comprensión de su entorno, asegúrese de que el servidor cumple los requisitos previos. En primer lugar, compruebe la 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 una versión posterior. La herramienta de migración utiliza Web Deploy 3.6 para empaquetar las aplicaciones. Verifique su instalación mediante 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](https://www.iis.net/downloads/microsoft/web-deploy).

## Su primera migración
<a name="dotnet-migrating-applications-basic-migration-first"></a>

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

```
PS C:\migrations_workspace> eb migrate
```

Este comando inicia una serie de pasos automatizados, como se muestra 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 la implementación. La siguiente lista muestra la estructura del directorio:

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

## Control de la migración
<a name="dotnet-migrating-applications-basic-migration-controlling"></a>

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 ejemplo de comando:

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

Para obtener una lista completa de opciones, consulte [**eb migrate**](eb3-migrate.md).

## Monitoreo del progreso
<a name="dotnet-migrating-applications-basic-migration-monitoring"></a>

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

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

## Comprobación de la migración
<a name="dotnet-migrating-applications-basic-migration-verifying"></a>

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

Acceso a su aplicación  
Abra la URL de la aplicación (CNAME) en un navegador web para comprobar que funciona correctamente.

Comprobación del estado del entorno  
Utilice el comando **eb health** 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.](http://docs.aws.amazon.com/es_es/elasticbeanstalk/latest/dg/images/eb-health-after-migration.png)


Utilice el comando **eb logs** para acceder a los registros y solucionar cualquier problema:  

```
PS C:\migrations_workspace> eb logs --zip
```
El comando **eb logs** descarga los registros en el directorio `.elasticbeanstalk/logs`. Para obtener más información, consulte [Uso de Elastic CloudWatch Beanstalk con Amazon Logs](AWSHowTo.cloudwatchlogs.md).

Conexión a instancias  
Si especificó un par de claves durante la migración, puede conectarse a sus instancias mediante RDP para solucionar problemas directamente.

Acceso 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](environments-console.md) correspondiente a ese entorno. 

## Administración de artefactos de migración
<a name="dotnet-migrating-applications-basic-migration-cleanup"></a>

El comando **eb migrate** 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 el disco. Utilice el subcomando **cleanup** para administrar 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 opción **--force**:

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

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