Como usar a ferramenta de descoberta do Windows

O Migrate to Containers fornece uma ferramenta de autoatendimento que é executada em uma carga de trabalho da VM do Linux para determinar a compatibilidade dela para migração a um contêiner.

A ferramenta gera um arquivo ZIP que indica se a VM do Windows é ou não uma opção possível para a migração. O nome do arquivo indica os resultados:

  • info-hostname-timestamp.zip indica que a VM é uma opção possível a ser migrada;
  • info-hostname-timestamp-NOFIT.zip indica que a VM não é uma opção a ser migrada. Normalmente, NENHUMA ADAPTAÇÃO resulta de uma versão ausente ou incorreta do IIS.

Como funciona a ferramenta

Como o Migrate to Containers exige que as VMs do Windows executem o Microsoft IIS 7 ou superior, a ferramenta de descoberta coleta o IIS e as informações gerais do sistema.

Pré-requisitos

Para executar a ferramenta de descoberta do Windows:

  • Você precisa ter uma versão de 64 bits do Windows.
  • Você precisa ser um administrador na VM do Windows.

Como fazer o download e executar a ferramenta

A ferramenta é empacotada como um único arquivo .exe. É necessário fazer o download da ferramenta antes de executá-la.

Para avaliar uma VM:

  1. Faça login na VM.

  2. Crie um diretório para a ferramenta: 

    > mkdir m4a 
> cd m4a

  3. Faça o download da ferramenta na VM em https://storage.googleapis.com/anthos-migrate-release/v1.9.0/windows/amd64/collect_info.exe.

  4. Execute a ferramenta na VM como administrador:

    Clique com o botão direito do mouse na ferramenta no Gerenciador de arquivos e selecione Executar como administrador ou abra uma janela de comando do PowerShell como administrador:

    > collect_info.exe

    A ferramenta gera um arquivo ZIP denominado info-hostname-timestamp.zip ou info-hostname-timestamp-NOFIT.zip para o diretório atual.

    O carimbo de data/hora está no formato YYYMMDDhhmmss. Consulte Formato do arquivo ZIP de saída para ver uma descrição do arquivo ZIP.

    Opcionalmente, é possível usar a opção -o para especificar o caminho para o diretório de saída. Por exemplo: 

    > collect_info.exe -o /home/mydir

    Para ver informações de ajuda, use:

    > collect_info.exe -h

Formato do arquivo ZIP de saída

O arquivo ZIP de saída contém:

  • Um arquivo de registros denominado log.log.
  • Um arquivo chamado collect_info_version.txt contendo a versão da ferramenta.
  • Diretórios contendo informações sobre o sistema:
    • computer_info
    • iis
    • gac
    • odbc

O conteúdo de cada diretório é descrito abaixo.

O diretório computer_info

O diretório computer_info contém:

Arquivo Descrição
hosts.txt Cópia do arquivo hosts da máquina
installed_programs.json Informações dos programas instalados
ipconfig_out.txt Saída de ipconfig /all.
msinfo32_out.txt Relatório do utilitário msinfo32.
netstat_out.txt Informações de todas as conexões e portas de detecção com executáveis envolvidos na criação de cada conexão ou porta de detecção.
routing_tables.txt Tabelas de roteamento da máquina.
schedtasks.csv Informações de tarefas programadas
systeminfo_out.csv Saída do utilitário systeminfo no formato CSV.
win32_product_installed_programs.json Informações dos programas instalados fornecidos pela classe Win32_Product do WMI.
windows_features.json Informações sobre recursos do Windows.

O diretório IIS

O diretório iis contém informações sobre IIS, sites e configurações do .NET, além de outras informações selecionadas que podem nos ajudar a entender os aplicativos.

O diretório contém os seguintes arquivos:

Arquivo Descrição
Framework[64]_v<version>_config Cópia de todos os diretórios de configuração globais do .NET para cada framework e versão.

Inclui global.configs e machine.configs, por exemplo, Framework_v2.0.50727_config, Framework64_v4.0.30319_config. A origem dessas informações é %windir%\Microsoft.NET\Framework[64]\version\config.
iis_config Uma cópia do diretório de configuração do IIS, incluindo configurações e esquemas.
sites_files Um diretório contém arquivos exportados de sites IIS, ou seja, cópias de todos os arquivos web.config em sites.
sites.json Informações sobre todos os sites configurados no IIS, incluindo a listagem de diretórios recursiva para cada site com informações de ACL de arquivos.
version.txt A versão do IIS.

Como lidar com secrets no diretório IIS

Cópias de arquivos de configuração e diretórios (IIS, .NET global e sites) podem conter secrets. Esses arquivos incluem applicationHost.config e web.config.

A ferramenta collect_info.exe filtra senhas de strings de conexão nesses arquivos ( formato .NET 3.5+). Cada senha é substituída por ***. É possível remover e filtrar qualquer informação confidencial adicional manualmente do arquivo ZIP de saída.

O diretório GAC

O diretório gac contém informações do Cache de conjunto global do .NET:

Arquivo Descrição
clr2.txt Uma lista de conjuntos em CLR2.0 GAC.
clr4.txt Uma lista de conjuntos no CLR4.0 GAC.

O diretório ODBC

O diretório odbc contém informações dos DSNs ODBC e drivers instalados:

Arquivo Descrição
system_dsn_32.reg Registros exportados com todas as informações de DSNs e drivers do sistema para 32 bits.
system_dsn_64.reg Registros exportados com todas as informações de DSNs e drivers do sistema para 64 bits.
user_dsn.reg Registros exportados com todas as informações dos DSNs e drivers de usuário para 32 e 64 bits.

Como lidar com secrets no diretório ODBC

DSNs ODBC podem conter secrets. A ferramenta collect_info.exe filtra as senhas dos arquivos .reg exportados. É possível remover e filtrar qualquer informação confidencial adicional manualmente do arquivo ZIP de saída.

A seguir