本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

進階遷移案例

本節涵蓋複雜 IIS 部署的進階遷移案例。

使用應用程式請求路由 (ARR) 進行多站台遷移

eb migrate 命令會在遷移期間自動偵測並保留 ARR 組態。在 IIS 中識別 ARR 設定時applicationHost.config，它會產生必要的 PowerShell 指令碼，以在目標 EC2 執行個體上重新安裝和設定 ARR。

ARR 組態偵測

遷移程序會檢查 IIS 中的三個金鑰組態區段：

例如，請考慮在連接埠 80 RouterSite上執行的 會分別向連接埠 8081 和 8082 請求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 安全群組公開。只有連接埠 80 可供 Application Load Balancer 存取，且來自它的所有流量都會路由到連接埠 80 的目標群組。

下列命令可以遷移此組態：

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

ARR 遷移程序

遷移程序會透過數個步驟保留您的 ARR 組態。

負載平衡器整合

遷移程序會盡可能將您的 ARR 規則轉譯為 Application Load Balancer (ALB) 接聽程式規則。例如，上述 ARR 組態會產生根據 URL 路徑模式路由流量的 ALB 規則，同時在 EC2 執行個體上維持內部路由。

產生的環境會維護您的 ARR 路由邏輯，同時利用 AWS的彈性基礎設施。您的應用程式會繼續如往常一樣運作，在 Application Load Balancer 管理外部流量分佈時處理內部路由。

使用主機型路由的無 ARR 多站台遷移

雖然 Application Request Routing (ARR) 是管理 IIS 中多個站台的常見方法，但您也可以利用 Application Load Balancer 的主機型路由功能，直接將多站台部署遷移至 Elastic Beanstalk 而不需 ARR。這種方法可以透過消除額外的路由層來降低複雜性並改善效能。

主機型路由概觀

在此方法中，每個 IIS 網站都會在 EC2 執行個體外公開，而 Application Load Balancer 會根據主機標頭，將流量直接路由至適當的連接埠。這消除了對 ARR 的需求，同時保持應用程式之間的區隔。

考慮具有三個站台的多站台 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 接聽程式規則組態路由至它們。

遷移程序

若要將此組態遷移至 Elastic Beanstalk，而不使用 ARR，請使用下列範例中的 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 符號連結一律指向最近建立的遷移成品目錄。除了相關的應用程式和錯誤日誌，每個遷移成品目錄還包含一個upload_target.zip檔案，您可以部署到 Elastic Beanstalk。

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