基本的な IIS の移行を実行する - AWS Elastic Beanstalk
IIS 環境を探索する移行の準備最初の移行移行を制御する進行状況の監視移行を検証する移行アーティファクトを管理する

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

基本的な IIS の移行を実行する

このセクションでは、eb migrate コマンドを使用して IIS アプリケーションを Elastic Beanstalk に移行するプロセスについて説明します。

IIS 環境を探索する

変更を行う前に、サーバーに存在するリソースは何かを理解しておく必要があります。まず、次の例に示すように、eb migrate explore を実行して IIS サイトを調べます。

PS C:\migrations_workspace> eb migrate explore

このコマンドは IIS サイトを明らかにします。次のリストを参照してください。

Default Web Site
Intranet
API.Internal
Reports

バインディング、アプリケーション、仮想ディレクトリなど、各サイトの設定の詳細なビューについては、次の例に示すように、--verbose オプションを追加します。

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

次のリストは、 コマンドが提供するユーザーの環境に関する包括的な情報を示しています。

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

検出出力を理解する

詳細な出力は、移行計画に関する以下の重要な情報を提供します。

サイト

検出出力には、サーバー上のすべての IIS サイトが一覧表示されます。各サイトは名前 (「Default Web Site」、「Intranet」、「API.Internal」など) で識別され、順番に番号が付けられます。サーバーに複数のサイトが存在する場合、eb migrate コマンドは移行戦略に応じて、それぞれを個別に、または一緒にパッケージ化およびデプロイできます。

バインディング

プロトコルバインディングは、サイトがどのプロトコル (HTTP/HTTPS) を使用し、どのポートで動作するかを明らかにします。バインディング情報には、ドメインベースのルーティング設定を定義するホストヘッダー要件が含まれます。

アプリケーション

アプリケーションパスには、IIS 設定内のルートアプリケーション構造とネストされたアプリケーション構造の両方が表示されます。アプリケーションプールの割り当ては、セキュリティとリソース管理のためにアプリケーションが互いに分離される方法を示します。

仮想ディレクトリ

物理パスマッピングは、コンテンツがファイルシステム上に存在する場所を示します。認証設定には、移行後に維持する必要がある特別なアクセス要件が表示されます。

移行の準備

環境を理解することで、サーバーが前提条件を満たしていることを確認します。まず、次の PowerShell コマンドを使用して IIS バージョンを確認します。

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

IIS 7.0 以降が必要です。移行ツールは、アプリケーションをパッケージ化するために Web Deploy 3.6 を使用します。次のコマンドを使用してそのインストールを確認します。

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

Web Deploy がサーバーにインストールされていない場合は、Microsoft Web Platform Installer ダウンロードページからダウンロードできます。

最初の移行

デフォルトウェブサイトの基本的な移行から始めましょう。以下の例は、最もシンプルなコマンド eb migrate を示しています。

PS C:\migrations_workspace> eb migrate

このコマンドは、次の出力の例に示すように、一連の自動ステップを開始します。

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

移行ツールは、デプロイアーティファクトを含む構造化ディレクトリを作成します。次のリストでは、ディレクトリ構造について示しています。

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

移行を制御する

移行プロセスをより詳細に制御するには、次のコマンドを使用して、移行するサイトを正確に指定できます。

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

次のコマンドの例に示すように、環境名とアプリケーション名をカスタマイズすることもできます。

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

オプションの完全な一覧については、「eb migrate」を参照してください。

進行状況の監視

移行中、eb migrate はリアルタイムのステータス更新を提供します。次の出力例を参照します。

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

移行を検証する

環境の準備ができたら、Elastic Beanstalk はデプロイを検証するためのいくつかの方法を提供します。

アプリケーションにアクセスする

ウェブブラウザでアプリケーション URL (CNAME) を開き、それが正しく動作していることを確認します。

環境の正常性を確認する

eb health コマンドを使用して、環境の正常性を表示します。

PS C:\migrations_workspace> eb health

次の画面画像は、インスタンスの正常性、アプリケーションレスポンスメトリクス、およびシステムリソース使用率を示しています。

eb health コマンドからの出力は、インスタンスの正常性、アプリケーションレスポンスメトリクス、およびシステムリソース使用率を示します。
eb logs コマンドを使用してログにアクセスし、問題をトラブルシューティングします。
PS C:\migrations_workspace> eb logs --zip

eb logs コマンドは、.elasticbeanstalk/logs ディレクトリにログをダウンロードします。詳細については、「Amazon CloudWatch Logs で Elastic Beanstalk を使用する」を参照してください。

インスタンスに接続します

移行中にキーペアを指定した場合は、RDP を使用してインスタンスに接続し、直接トラブルシューティングすることができます。

Elastic Beanstalk コンソールにアクセスする

環境の正常性、ログ、および設定のプロパティは、その環境の環境マネジメントコンソールから表示できます。

移行アーティファクトを管理する

eb migrate コマンドは、移行プロセス中にローカルアーティファクトを作成します。これらのアーティファクトには機密情報が含まれており、時間の経過とともに大量のディスク容量を消費する可能性があります。次の例に示すように、cleanup サブコマンドを使用してこれらのアーティファクトを管理します。

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

確認なしで強制クリーンアップするには、--force オプションを使用します。

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

クリーンアッププロセスは、最後に成功した移行を ./migrations/latest ディレクトリに保持し、古い移行ディレクトリを削除します