eb migrate

설명

인터넷 정보 서비스(IIS) 사이트와 애플리케이션을 Windows 서버에서 Elastic Beanstalk으로 마이그레이션합니다. 이 명령은 애플리케이션을 패키징하고 구성 정보를 보존한 뒤, 새로운 Elastic Beanstalk 환경에 배포합니다.

IIS 사이트 및 애플리케이션 마이그레이션에 대한 자세한 내용은 Elastic Beanstalk로 IIS 애플리케이션 마이그레이션 섹션을 참조하세요.

다음 단계는 마이그레이션 절차를 요약한 것입니다.

이 명령은 다음과 같이 구조화된 디렉터리에 마이그레이션 아티팩트를 생성합니다.

C:\migration_workspace\
└── .\migrations\latest\
    ├── upload_target.zip
    └── upload_target\
        ├── [SiteName].zip                      # One ZIP per default application of IIS site
        ├── [SiteName-ApplicationName].zip      # One ZIP per additional application
        ├── aws-windows-deployment-manifest.json
        └── ebmigrateScripts\
            ├── site_installer.ps1              # Site installation scripts
            ├── permission_handler.ps1          # Permission management
            └── other helper scripts

eb migrate cleanup을 사용하여 이러한 아티팩트를 관리합니다.

구문

eb migrate [options]

eb migrate explore [options]

eb migrate cleanup [options]

인수를 지정하지 않고 실행하면 eb migrate가 비대화형 모드로 동작합니다. 대화형 모드로 실행하려면 eb migrate --interactive를 실행하세요.

대화형 모드 명령은 다음 정보를 묻는 프롬프트를 표시합니다.

하위 명령

explore

eb migrate explore 하위 명령은 IIS 서버를 검사하여 사용 가능한 사이트 목록을 출력합니다.

다음 정보를 표시하려면 이 명령을 사용하세요.

PS C:\migrations_workspace >  eb migrate explore
Default Web Site
Site2
site3
router

PS C:\migrations_workspace >  eb migrate explore --verbose
1: Default Web Site:
  - Bindings:
    - *:8083:
  - Application '/':
    - Application Pool: DefaultAppPool
    - Enabled Protocols: http
    - Virtual Directories:
      - /:
        - Physical Path: C:\inetpub\wwwroot
        - Logon Method: ClearText
  - Application '/dotnet-6-0':
    - Application Pool: DefaultAppPool
    - Enabled Protocols: http
    - Virtual Directories:
      - /:
        - Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-6-0
        - Logon Method: ClearText
  - Application '/dotnet-8-0':
    - Application Pool: DefaultAppPool
    - Enabled Protocols: http
    - Virtual Directories:
      - /:
        - Physical Path: C:\inetpub\AspNetCoreWebApps\CoreWebApp-8-0
        - Logon Method: ClearText
2: Site2:
  - Bindings:
    - *:8081:
...

정리

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

옵션

이러한 옵션이 필요하지 않습니다. 옵션 없이 eb migrate를 실행하면 EB CLI는 비대화형 모드로 작동합니다. eb migrate --interactive를 사용하면 EB CLI가 필수 설정 값을 입력하거나 선택하라는 프롬프트를 표시합니다.

{
    "id": "vpc-1234567890abcdef0",
    "publicip": "true|false",
    "elbscheme": "public|private",
    "ec2subnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"],
    "securitygroups": "sg-123456,sg-789012",
    "elbsubnets": ["subnet-a1b2c3d4", "subnet-e5f6g7h8"]
}

출력

이 명령은 마이그레이션 과정 전반에 걸쳐 상태 업데이트를 제공합니다.

성공할 경우, 새 환경의 세부 정보가 표시됩니다.

마이그레이션 중 문제가 발생하면 eb events 및 eb health 명령을 사용해 상세 정보를 확인하세요.

예시

기본 사용법

대화형 모드에서의 기본 마이그레이션:

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

Creating application version
Creating environment

Environment details for: EBMigratedEnv
  Application name: EBMigratedApp
  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: ebmigratedenv.us-west-2.elasticbeanstalk.com
  Updated: 2023-03-20 15:30:45

사용자 지정 구성을 포함한 특정 사이트 마이그레이션:

PS C:\migrations_workspace >  eb migrate `
    --sites "Default Web Site,InternalAPI" `
    --application-name "CorporateApp" `
    --environment-name "Production" `
    --instance-type "c5.xlarge" `
    --tags "Environment=Production,Team=WebOps" `
    --copy-firewall-config

배포 없이 마이그레이션 아카이브 생성:

PS C:\migrations_workspace >  eb migrate --archive-only
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

Generated destination archive directory at .\migrations\latest\upload_target
You can execute `eb init` and `eb create` from this directory to deploy to EB.

고급 구성 예제

JSON 파일을 사용한 사용자 지정 VPC 구성으로 마이그레이션:

PS C:\migrations_workspace >  cat vpc-config.json
{
    "id": "vpc-1234567890abcdef0",
    "publicip": "false",
    "elbscheme": "internal",
    "ec2subnets": [
        "subnet-private1",
        "subnet-private2"
    ],
    "securitygroups": [
        "sg-app",
        "sg-database",
        "sg-monitoring"
    ],
    "elbsubnets": [
        "subnet-private1",
        "subnet-private2"
    ]
}

PS C:\migrations_workspace eb migrate `
    --sites "InternalAPI" `
    --vpc-config vpc-config.json `
    --instance-type "r5.xlarge" `
    --tags "Environment=Internal,Security=High"

SSL 인증서 및 호스트 헤더를 사용하는 사이트 마이그레이션:

PS C:\migrations_workspace >  eb migrate `
    --sites "SecurePortal" `
    --ssl-certificates "arn:aws:acm:region:account:certificate/cert1,arn:aws:acm:region:account:certificate/cert2" `
    --verbose
INFO: Detected HTTPS bindings:
  - www.example.com:443
  - api.example.com:443

INFO: Configuring Application Load Balancer with SSL certificates
INFO: Creating host-based routing rules:
  - www.example.com -> target group 1
  - api.example.com -> target group 2

EBS 스냅샷 구성을 포함한 마이그레이션:fo

PS C:\migrations_workspace >  eb migrate `
    --sites "Default Web Site" `
    --ebs-snapshots "snap-1234567890abcdef0" "snap-0987654321fedcba1" `
    --encrypt-ebs-volumes
Using .\migrations\latest to contain artifacts for this migration run.
INFO: Enabling EBS encryption for all new volumes in us-west-2
INFO: Configuring environment with specified EBS snapshots

보안 구성 예제

복잡한 방화벽 규칙이 있는 사이트 처리:

PS C:\migrations_workspace >  eb migrate `
    --sites "Default Web Site,ReportingService" `
    --copy-firewall-config `
    --verbose
INFO: Detected the following Windows Firewall rules:
  - Allow Web Traffic (TCP 80, 443)
  - Allow Reporting Traffic (TCP 8081)
INFO: Creating corresponding security group rules

사용자 지정 IAM 역할을 사용하는 마이그레이션:

PS C:\migrations_workspace >  eb migrate `
    --sites "SecureApp" `
    --instance-profile "CustomInstanceProfile" `
    --service-role "CustomServiceRole"

원격 실행 예제

원격 Windows 서버에서 IIS 애플리케이션 마이그레이션:

PS C:\migrations_workspace >  eb migrate `
    --remote `
    --target-ip "192.0.2.10" `
    --username "administrator" `
    --password "YourPassword123" `
    --application-name "RemoteApp" `
    --environment-name "RemoteEnv"
INFO: Establishing SSH connection to remote host 192.0.2.10...
INFO: Connection established
INFO: Discovering IIS sites on remote host...
INFO: Found 2 sites: Default Web Site, API
INFO: Extracting site configurations...
INFO: Generating source bundle for sites, applications, and virtual directories...
  Default Web Site/ -> .\migrations\latest\upload_target\DefaultWebSite.zip
  API/ -> .\migrations\latest\upload_target\API.zip

Creating application version
Creating environment

Environment details for: RemoteEnv
  Application name: RemoteAppstage mi
  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: remoteenv.us-west-2.elasticbeanstalk.com
  Updated: 2023-03-20 15:30:45

특정 사이트를 선택한 원격 마이그레이션:

PS C:\migrations_workspace >  eb migrate `
    --remote `
    --target-ip "192.0.2.10" `
    --username "administrator" `
    --password "YourPassword123" `
    --sites "API" `
    --instance-type "c5.large"