Executando migrações básicas do IIS - AWS Elastic Beanstalk
Explorando seu ambiente IISPreparar-se para migraçãoSua primeira migraçãoControle da migraçãoMonitorar o progressoVerificando a migraçãoGerenciando artefatos de migração

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Executando migrações básicas do IIS

Esta seção orienta você pelo processo de migração de seus aplicativos do IIS para o Elastic eb migrate Beanstalk usando o comando.

Explorando seu ambiente IIS

Antes de fazer qualquer alteração, você deve entender quais recursos existem no seu servidor. Comece explorando seus sites do IIS executandoeb migrate explore, conforme mostrado no exemplo a seguir:

PS C:\migrations_workspace> eb migrate explore

Esse comando revela seus sites do IIS. Consulte a lista a seguir:

Default Web Site
Intranet
API.Internal
Reports

Para obter uma visão detalhada da configuração de cada site, incluindo vinculações, aplicativos e diretórios virtuais, adicione a --verbose opção, conforme mostrado neste exemplo:

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

A lista a seguir mostra as informações abrangentes sobre seu ambiente que o comando fornece:

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

Entendendo o resultado da descoberta

A saída detalhada fornece as seguintes informações críticas para o planejamento da migração:

Sites

A saída da descoberta lista todos os sites do IIS em seu servidor. Cada site é identificado por seu nome (por exemplo, “Site padrão”, “Intranet”, “API.internal”) e numerado sequencialmente. Quando existem vários sites em um servidor, o eb migrate comando pode empacotar e implantar cada um separadamente ou em conjunto, dependendo da sua estratégia de migração.

Ligações

As vinculações de protocolo revelam quais protocolos (HTTP/HTTPS) seus sites usam e em quais portas eles operam. As informações de vinculação incluem os requisitos do cabeçalho do host que definem as configurações de roteamento com base no domínio.

Aplicações

Os caminhos do aplicativo mostram as estruturas do aplicativo raiz e aninhado na configuração do IIS. As atribuições do pool de aplicativos indicam como seus aplicativos são isolados uns dos outros para fins de segurança e gerenciamento de recursos.

Diretórios virtuais

Os mapeamentos de caminhos físicos indicam onde seu conteúdo reside no sistema de arquivos. As configurações de autenticação mostram requisitos de acesso especiais que precisam ser mantidos após a migração.

Preparar-se para migração

Com uma compreensão do seu ambiente, certifique-se de que seu servidor atenda aos pré-requisitos. Primeiro, verifique sua versão do IIS com o seguinte PowerShell comando:

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

Você precisa do IIS 7.0 ou posterior. A ferramenta de migração usa o Web Deploy 3.6 para empacotar seus aplicativos. Verifique sua instalação com o seguinte comando:

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

Se o Web Deploy não estiver instalado em seu servidor, você poderá baixá-lo na página de download do Microsoft Web Platform Installer.

Sua primeira migração

Vamos começar com uma migração básica do site padrão. O exemplo a seguir mostra o comando mais simples,eb migrate.

PS C:\migrations_workspace> eb migrate

Esse comando inicia uma série de etapas automatizadas, mostradas no seguinte exemplo de saída:

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

A ferramenta de migração cria um diretório estruturado contendo seus artefatos de implantação. A lista a seguir mostra a estrutura do diretório:

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

Controle da migração

Para ter mais controle sobre o processo de migração, você pode especificar exatamente quais sites migrar com o seguinte comando:

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

Você também pode personalizar o nome do ambiente e o nome do aplicativo, conforme mostrado no seguinte exemplo de comando:

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

Para obter uma lista completa das opções, consulteeb migrate.

Monitorar o progresso

Durante a migração, eb migrate fornece atualizações de status em tempo real. Consulte o seguinte exemplo de saída:

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

Verificando a migração

Quando o ambiente estiver pronto, o Elastic Beanstalk fornece várias maneiras de verificar sua implantação.

Acesse seu aplicativo

Abra o URL do aplicativo (CNAME) em um navegador da Web para verificar se ele está funcionando corretamente.

Verifique a integridade do ambiente

Use o eb health comando para visualizar a integridade do seu ambiente.

PS C:\migrations_workspace> eb health

A imagem da tela a seguir mostra a integridade da instância, as métricas de resposta do aplicativo e a utilização dos recursos do sistema.

A saída do comando eb health mostra a integridade da instância, as métricas de resposta do aplicativo e a utilização dos recursos do sistema.
Use o eb logs comando para acessar os registros e solucionar qualquer problema:
PS C:\migrations_workspace> eb logs --zip

O eb logs comando baixa os registros para o .elasticbeanstalk/logs diretório. Para obter mais informações, consulte Usando o Elastic CloudWatch Beanstalk com o Amazon Logs.

Conecte-se às instâncias

Se você especificou um key pair durante a migração, você pode se conectar às suas instâncias usando o RDP para solucionar problemas diretamente.

Acesse o console do Elastic Beanstalk

Você pode visualizar a integridade, os registros e as propriedades de configuração do ambiente por meio do console de gerenciamento do ambiente desse ambiente.

Gerenciando artefatos de migração

O eb migrate comando cria artefatos locais durante o processo de migração. Esses artefatos contêm informações confidenciais e podem consumir um espaço significativo em disco ao longo do tempo. Use o cleanup subcomando para gerenciar esses artefatos, conforme mostrado no exemplo a seguir:

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

Para forçar a limpeza sem confirmação, use a --force opção:

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

O processo de limpeza preserva a migração bem-sucedida mais recente no ./migrations/latest diretório e remove os diretórios de migração mais antigos.