기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

고급 마이그레이션 시나리오

이 섹션에서는 복잡한 IIS 배포에 대한 고급 마이그레이션 시나리오를 다룹니다.

Application Request Routing(ARR)을 사용하는 다중 사이트 마이그레이션

eb migrate 명령은 마이그레이션 중 ARR 구성을 자동으로 감지하고 보존합니다. IIS applicationHost.config에서 ARR 설정을 식별하면 대상 EC2 인스턴스에 ARR을 다시 설치하고 구성하기 위한 PowerShell 스크립트를 생성합니다.

ARR 구성 감지

이그레이션 프로세스는 IIS의 세 가지 핵심 구성 섹션을 검사합니다.

예를 들어, 포트 80에서 실행되는 RouterSite이 각각 포트 8081과 8082에서 실행되는 APIService 및 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 라우팅 로직을 유지합니다. 애플리케이션은 기존과 동일하게 동작하며, 내부 라우팅은 ARR이 처리하고 외부 트래픽 분산은 Application Load Balancer에서 처리합니다.

호스트 기반 라우팅을 사용한 ARR 없는 다중 사이트 마이그레이션

Application Request Routing(ARR)은 IIS에서 여러 사이트를 관리하기 위한 일반적인 방식이지만, Application Load Balancer의 호스트 기반 라우팅 기능을 활용하면 ARR 없이도 다중 사이트 배포를 직접 Elastic Beanstalk으로 마이그레이션할 수 있습니다. 이 접근 방식은 추가 라우팅 계층을 제거하여 복잡성을 줄이고 성능을 향상할 수 있습니다.

호스트 기반 라우팅 개요

이 방식에서는 각 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는 로드 밸런서 리스너 규칙 구성에 따라 해당 대상으로 트래픽을 라우팅합니다.

마이그레이션 프로세스

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로 마이그레이션하는 동안 가상 디렉터리 구조를 유지합니다.

기본 권한 구성

가상 디렉터리를 마이그레이션할 때 eb migrate는 다음 항목에 ReadAndExecute 액세스를 부여하여 기본 권한 집합을 구성합니다.

예를 들어, 다음과 같은 일반적인 가상 디렉터리 구조를 고려하세요.

<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에 이전에 생성된 소스 코드를 사용하도록 지시해 새 아카이브 생성을 방지합니다.

이전 버전 배포

eb migrate는 Elastic Beanstalk의 타임스탬프가 있는 디렉터리와 애플리케이션 버전을 통해 마이그레이션 기록을 유지합니다. 각 마이그레이션은 필요할 경우 배포할 수 있는 고유한 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