Executar migrações básicas do IIS - AWS Elastic Beanstalk
Explorar seu ambiente do IISPreparar-se para migraçãoSua primeira migraçãoControlar a migraçãoMonitorar o progressoVerificar a migraçãoGerenciar 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á.

Executar migrações básicas do IIS

Esta seção orientará você no processo de migração de aplicações do IIS para o Elastic Beanstalk usando o comando eb migrate.

Explorar seu ambiente do IIS

Antes de fazer qualquer alteração, você deve entender quais recursos existem no seu servidor. Comece explorando os sites do IIS executando eb 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, aplicações e diretórios virtuais, adicione a opção --verbose, 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:
...

Entender 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 no 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 comando eb migrate pode empacotar e implantar cada um separadamente ou em conjunto, dependendo da sua estratégia de migração.

Associaçõ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 da aplicação mostram as estruturas da aplicação raiz e aninhada na configuração do IIS. As atribuições do grupo de aplicações indicam como suas aplicações são isoladas umas das outras 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 ambiente, garanta que o servidor atenda aos pré-requisitos. Primeiro, verifique a versão do IIS com o seguinte comando do PowerShell:

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 suas aplicações. Verifique a 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 exemplo de saída a seguir:

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<

Controlar a 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"

Também é possível personalizar o nome do ambiente e da aplicação, 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 de opções, consulte eb 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

Verificar a migração

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

Acessar sua aplicação

Abra o URL da aplicação (CNAME) em um navegador da Web para verificar se ela está funcionando corretamente.

Verificar a integridade do ambiente

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

PS C:\migrations_workspace> eb health

A imagem da tela a seguir mostra a integridade da instância, as métricas de resposta da aplicação 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 da aplicação e a utilização dos recursos do sistema.
Use o comando eb logs para acessar logs e solucionar qualquer problema:
PS C:\migrations_workspace> eb logs --zip

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

Conectar-se a instâncias

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

Acessar o console do Elastic Beanstalk

É possível visualizar a integridade, os logs e as propriedades de configuração do ambiente por meio do console de gerenciamento do ambiente desse ambiente.

Gerenciar artefatos de migração

O comando eb migrate 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 com o passar do tempo. Use o subcomando cleanup 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 opção --force:

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

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