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

高度な移行シナリオ

このセクションでは、複雑な IIS デプロイの高度な移行シナリオについて説明します。

アプリケーションリクエストルーティング (ARR) を使用したマルチサイト移行

eb migrate コマンドは、移行中に ARR 設定を自動的に検出して保持します。IIS で ARR 設定を識別するとapplicationHost.config、ターゲット EC2 インスタンスに ARR を再インストールして設定するために必要な PowerShell スクリプトが生成されます。

ARR 設定検出

移行プロセスでは、IIS の 3 つの主要な設定セクションを調べます。

たとえば、ポート 80 でRouterSite実行されている が へのリクエストをプロキシし、ポート 8081 APIService と 8082 でAdminPortal実行されている一般的な ARR 設定を考えてみましょう。

<!-- Original IIS ARR Configuration -->
<rewrite>
    <rules>
        <rule name="Route to API" stopProcessing="true">
            <match url="^api/(.*)$" />
            <action type="Rewrite" url="http://backend:8081/api/{R:1}" />
        </rule>
        <rule name="Route to Admin" stopProcessing="true">
            <match url="^admin/(.*)$" />
            <action type="Rewrite" url="http://backend:8082/admin/{R:1}" />
        </rule>
    </rules>
</rewrite>

次の図は、これらのルールが IIS サーバーのポート 80 の背後に隠れていて、EC2 セキュリティグループを介して公開されていない方法を示しています。Application Load Balancer はポート 80 にのみアクセスでき、そこからのすべてのトラフィックはポート 80 のターゲットグループにルーティングされます。

次のコマンドは、この設定を移行できます。

PS C:\migrations_workspace> eb migrate --sites "RouterSite,APIService,AdminPortal" `
    --copy-firewall-config

ARR 移行プロセス

移行プロセスでは、いくつかのステップで ARR 設定が保持されます。

ロードバランサーの統合

移行プロセスは、可能な限り ARR ルールを Application Load Balancer (ALB) リスナールールに変換します。例えば、上記の ARR 設定は、EC2 インスタンスの内部ルーティングを維持しながら、URL パスパターンに基づいてトラフィックをルーティングする ALB ルールになります。

結果として得られる環境は、 AWSのエラスティックインフラストラクチャを活用しながら、ARR ルーティングロジックを維持します。Application Load Balancer が外部トラフィック分散を管理している間、アプリケーションは以前と同じように動作し、ARR は内部ルーティングを処理します。

ホストベースのルーティングを使用した ARR なしのマルチサイト移行

Application Request Routing (ARR) は IIS で複数のサイトを管理するための一般的なアプローチですが、Application Load Balancer のホストベースのルーティング機能を活用することで、ARR なしでマルチサイトデプロイを Elastic Beanstalk に直接移行することもできます。このアプローチは、追加のルーティングレイヤーを排除することで、複雑さを軽減し、パフォーマンスを向上させることができます。

ホストベースのルーティングの概要

このアプローチでは、各 IIS サイトが EC2 インスタンスの外部に公開され、Application Load Balancer はホストヘッダーに基づいてトラフィックを適切なポートに直接ルーティングします。これにより、アプリケーション間の分離を維持しながら ARR が不要になります。

3 つのサイトを持つマルチサイト IIS 設定を考えてみましょう。それぞれに独自のホスト名バインディングがあります。

<sites>
    <site name="Default Web Site" id="1">
        <bindings>
            <binding protocol="http" bindingInformation="*:8081:www.example.com" />
        </bindings>
    </site>
    <site name="InternalAPI" id="2">
        <bindings>
            <binding protocol="http" bindingInformation="*:8082:api.internal" />
        </bindings>
    </site>
    <site name="ReportingPortal" id="3">
        <bindings>
            <binding protocol="http" bindingInformation="*:8083:reports.internal" />
        </bindings>
    </site>
</sites>

これらのサイトは、EC2 セキュリティグループを介してポート 8081、8082、および 8083 で公開されます。Application Load Balancer は、Load Balancerリスナールール設定に基づいてルーティングされます。

移行プロセス

ARR を使用せずにこの設定を Elastic Beanstalk に移行するには、次の例の eb migrate コマンドを使用します。

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

移行プロセスでは、ホストヘッダーに基づいてトラフィックを適切なターゲットグループに転送するホストベースのルーティングルールを使用して Application Load Balancer が自動的に設定されます。各ターゲットグループは、EC2 インスタンスの対応するポートにトラフィックを転送します。

SSL/TLS 設定

SSL/TLS を使用してアプリケーションを保護するには、次の手順を実行します。

この設定では、SSL 終了はロードバランサーで発生し、トラフィックは HTTP 経由でインスタンスに転送されます。これにより、クライアントとの安全な接続を維持しながら、証明書管理が簡素化されます。

ベストプラクティス

仮想ディレクトリ管理

eb migrate このコマンドは、IIS アプリケーションを Elastic Beanstalk に移行する間、仮想ディレクトリ構造を保持します。

デフォルトのアクセス許可設定

仮想ディレクトリを移行する場合、 は、以下へのアクセスを ReadAndExecute に付与することで、アクセス許可のベースラインセットeb migrateを確立します。

たとえば、一般的な仮想ディレクトリ構造を考えてみましょう。

<site name="CorporatePortal">
    <application path="/" applicationPool="CorporatePortalPool">
        <virtualDirectory path="/" physicalPath="C:\sites\portal" />
        <virtualDirectory path="/shared" physicalPath="C:\shared\content" />
        <virtualDirectory path="/reports" physicalPath="D:\reports" />
    </application>
</site>

パスワードで保護された仮想ディレクトリ

がパスワードで保護された仮想ディレクトリeb migrateを検出すると、警告が発行され、手動による介入が必要になります。

次の設定例では、この例に続く警告レスポンスが発生します。

<virtualDirectory path="/secure" 
                 physicalPath="C:\secure\content"
                 userName="DOMAIN\User"
                 password="[encrypted]" />

[WARNING] CorporatePortal/secure is hosted at C:\secure\content which is password-protected and won't be copied.

パスワード保護を維持するには、次のようなカスタムデプロイスクリプトを作成します。

# PS C:\migrations_workspace> cat secure_vdir_config.ps1

$vdirPath = "C:\secure\content"
$siteName = "CorporatePortal"
$vdirName = "secure"
$username = "DOMAIN\User"
$password = "SecurePassword"

# Ensure directory exists
if (-not (Test-Path $vdirPath)) {
    Write-Host "Creating directory: $vdirPath"
    New-Item -Path $vdirPath -ItemType Directory -Force
}

# Configure virtual directory with credentials
Write-Host "Configuring protected virtual directory: $vdirName"
New-WebVirtualDirectory -Site $siteName -Name $vdirName `
    -PhysicalPath $vdirPath -UserName $username -Password $password

# Set additional permissions as needed
$acl = Get-Acl $vdirPath
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule(
    $username, "ReadAndExecute", "ContainerInherit,ObjectInherit", "None", "Allow"
)
$acl.AddAccessRule($rule)
Set-Acl $vdirPath $acl

このスクリプトをマニフェストに含めることで、デプロイに追加します。

{
    "manifestVersion": 1,
    "deployments": {
        "custom": [
            {
                "name": "SecureVirtualDirectory",
                "scripts": {
                    "install": {
                        "file": "secure_vdir_config.ps1"
                    }
                }
            }
        ]
    }
}

カスタムアクセス許可管理

eb migrate コマンドは、デフォルト以外のアクセス許可を必要とするアプリケーションに対応するためのカスタムアクセス許可スクリプトのフレームワークを提供します。

$paths = @(
    "C:\sites\portal\uploads",
    "C:\shared\content"
)

foreach ($path in $paths) {
    if (-not (Test-Path $path)) {
        Write-Host "Creating directory: $path"
        New-Item -Path $path -ItemType Directory -Force
    }

    $acl = Get-Acl $path

    # Add custom permissions
    $customRules = @(
        # Application Pool Identity - Full Control
        [System.Security.AccessControl.FileSystemAccessRule]::new(
            "IIS AppPool\CorporatePortalPool", 
            "FullControl", 
            "ContainerInherit,ObjectInherit", 
            "None", 
            "Allow"
        ),
        # Custom Service Account
        [System.Security.AccessControl.FileSystemAccessRule]::new(
            "NT SERVICE\CustomService", 
            "Modify", 
            "ContainerInherit,ObjectInherit", 
            "None", 
            "Allow"
        )
    )

    foreach ($rule in $customRules) {
        $acl.AddAccessRule($rule)
    }
    
    Set-Acl $path $acl
    Write-Host "Custom permissions applied to: $path"
}

ベストプラクティス

これらのベストプラクティスに従って、移行を計画、実行、モニタリング、検証します。

カスタムアプリケーションプール設定

eb migrate コマンドは、デフォルトではカスタムアプリケーションプール設定をコピーしません。カスタムアプリケーションプール設定を保持するには、以下の手順でカスタムマニフェストセクションを作成して適用します。

--archive-dir 引数は、新しいアーカイブの作成を回避するために、以前に作成したソースコードを使用するeb migrateように に指示します。

以前のバージョンのデプロイ

は、Elastic Beanstalk のタイムスタンプ付きディレクトリとアプリケーションバージョンを通じて移行の履歴eb migrateを維持します。各移行では、必要に応じてデプロイできる一意の zip ファイルが作成されます。

PS C:\migrations_workspace> ls .\migrations\

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d----l        3/18/2025  10:34 PM                latest
d-----        3/16/2025   5:47 AM                migration_1742104049.479849
d-----        3/17/2025   9:18 PM                migration_1742246303.18056
d-----        3/17/2025   9:22 PM                migration_1742246546.565739
...
d-----        3/18/2025  10:34 PM                migration_1742337258.30742

latest シンボリックリンクは常に、最後に作成された移行アーティファクトディレクトリを指します。関連するアプリケーションログとエラーログに加えて、各移行アーティファクトディレクトリには、Elastic Beanstalk にデプロイできるupload_target.zipファイルも含まれています。

PS C:\migrations_workspace> ls .\migrations\latest\

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        3/18/2025  10:34 PM                upload_target
-a----        3/18/2025  10:34 PM          13137 application.log
-a----        3/18/2025  10:34 PM              0 error.log
-a----        3/18/2025  10:34 PM        1650642 upload_target.zip

を使用してupload_target.zipファイルをデプロイできますeb migrate。

PS C:\migrations_workspace> eb migrate --zip .\migrations\latest\upload_target.zip