Migrate to Containers CLI 출시 노트

이 페이지에서는 Migrate to Containers CLI에 대한 프로덕션 업데이트에 대해 설명합니다. 이 페이지를 정기적으로 확인하여 새로운 기능이나 업데이트된 기능, 버그 수정, 알려진 문제, 지원 중단된 기능에 대한 공지를 볼 수 있습니다.

2024년 1월 3일

2024년 1월 3일에 Tomcat 마이그레이션의 버그 수정이 포함된 Migrate to Containers 현대화 플러그인 버전 1.4.1이 출시되었습니다.

2023년 12월 4일

2023년 12월 4일에 Migrate to Containers CLI 버전 1.2.2가 출시되었습니다.

지원 중단됨

websphere-traditional 플러그인은 이제 지원 중단되었습니다. 기존 고객의 경우 이 플러그인은 2023년 12월까지 계속 지원되며, 그 이후에는 더 이상 사용할 수 없습니다. WebSphere 워크로드 현대화를 처음 사용하는 경우 대신 Migrate to Containers CLI와 함께 websphere-container 플러그인을 사용하세요.

2023년 11월 2일

2023년 11월 2일, 버그 수정이 포함된 Migrate to Containers CLI 버전 1.2.1이 출시되었습니다.

2023년 10월 30일

2023년 10월 30일에 Migrate to Containers CLI 버전 1.2.0이 출시되었습니다.

기능

Linux 애플리케이션을 오프라인으로 마이그레이션하기 위한 지원 추가

Migrate to Containers CLI는 이제 새로운 오프라인 모드를 사용하여 인터넷에 연결되지 않은 작업을 지원합니다. 오프라인 모드를 사용하면 오프라인 환경에서 Linux 애플리케이션을 마이그레이션할 수 있습니다.

이는 로컬 및 소스 머신과 배포 클러스터를 포함하는 로컬 환경이 외부 파일 및 바이너리를 다운로드하기 위한 사전 승인 및 보안 스캔이 필요한 보안 네트워크에 위치하는 경우에 유용합니다. 오프라인 모드에서 파일 번들링 및 번들 해제 옵션을 추가하여 외부 소스로부터 소프트웨어 업데이트를 보안 네트워크로 수신하는 프로세스를 간소화했습니다. 또한 로컬 및 보안 레지스트리를 마이그레이션된 애플리케이션에 필요한 아티팩트의 소스로 지정할 수 있습니다.

오프라인 마이그레이션을 설정하려면 Migrate to Containers CLI를 다운로드한 후 다음 단계를 수행합니다.

오프라인 Migrate to Containers CLI 플러그인 번들을 다운로드합니다.

curl -O https://storage.googleapis.com/modernize-plugins-prod/$(curl -s https://storage.googleapis.com/modernize-plugins-prod/latest)/m2c-offline-bundle-linux.tar

필요한 경우 Migrate to Containers CLI 및 오프라인 Migrate to Containers CLI 플러그인 번들을 오프라인 환경에 복사합니다.
오프라인 Migrate to Containers CLI 플러그인 번들을 압축해제합니다.
```
./m2c plugins unpack -i m2c-offline-bundle-linux.tar
```
오프라인 데이터 마이그레이션에 대한 지원을 추가하려면 로컬 네트워크에서 사용할 수 있는 Container Registry를 지정합니다.
```
./m2c plugins unpack -i m2c-offline-bundle-linux.tar --registry HOSTNAME
```
HOSTNAME을 Container Registry 호스트 이름으로 바꿉니다.

자세한 내용은 오프라인 마이그레이션 설정을 참조하세요.

2023년 8월 22일

2023년 8월 22일에 Migrate to Containers CLI 버전 1.1.0이 출시되었습니다.

기능

Windows IIS 서비스 마이그레이션 지원 추가

Migrate to Containers CLI에서 이제 Windows IIS 서비스 마이그레이션이 지원됩니다. Windows IIS 서비스를 마이그레이션하려면 Windows 머신에서 Migrate to Containers CLI를 실행해야 합니다.

Windows IIS 서비스를 현대화하려면 다음 단계를 따르세요.

소스 VM 디스크 이미지를 VHD 파일로 내보냅니다.

예를 들어 Compute Engine에서 이미지를 내보내려면 먼저 이미지를 Cloud Storage로 내보낸 다음 이미지를 로컬 머신에 다운로드합니다.
```
gcloud compute images export \
    --export-format vhdx \
    --destination-uri DESTINATION_URI \
    --image IMAGE_NAME
gcloud storage cp DESTINATION_URI LOCAL_PATH
```

디스크 이미지를 분석하여 마이그레이션 계획을 만듭니다.

./m2c analyze \
   -s PATH_TO_IMAGE \
   -p windows-iis-container \
   -o ANALYSIS_OUTPUT_PATH

마이그레이션 계획을 수정합니다.
디스크 이미지 및 마이그레이션 계획에서 마이그레이션 아티팩트를 생성합니다.
```
./m2c generate \
   -i ANALYSIS_PATH \
   -o OUTPUT_ARTIFACTS_PATH
```

IBM WebSphere 애플리케이션 마이그레이션 지원 강화

IBM WebSphere 지원이 수정 및 확장되었습니다. 기존 플러그인은 기존 WebSphere Application Server를 마이그레이션 소스로 지원합니다. WebSphere Application Server Liberty를 마이그레이션 소스로 지원하기 위한 새로운 플러그인이 추가되었습니다.

기존 IBM WebSphere Application Server 마이그레이션의 변경사항

기존 IBM WebSphere Application Server 마이그레이션의 변경사항은 다음과 같습니다.

이제 websphere-traditional-container 플러그인이 IBM WebSphere Application Server 기존 워크로드를 마이그레이션하는 데 사용됩니다.
WebSphere Application Server Liberty를 대상으로 추가 지원합니다.
이제 mFit을 사용하여 소스 VM을 스캔하는 경우에도 was-home 매개변수가 필수입니다.

IBM WebSphere Application Server 기존 워크로드를 마이그레이션하려면 다음 명령어를 실행하세요.

./m2c analyze \
    -s PATH_TO_COPIED_FILESYSTEM \
    -p websphere-traditional-container -o ANALYSIS_OUTPUT_PATH \
    -r was-home=PATH_TO_WAS_HOME \
    --volume PATH_TO_BINARYAPPSCANNER:/binaryAppScanner.jar

자세한 내용은 WebSphere 기존 워크로드의 마이그레이션 계획 만들기를 참조하세요.

IBM WebSphere Application Server Liberty 마이그레이션 지원 추가

WebSphere Application Server Liberty의 현대화가 이제 websphere-container 플러그인과 함께 정식 버전으로 제공됩니다.

IBM WebSphere Liberty 워크로드를 마이그레이션하려면 다음 명령어를 실행합니다.

./m2c analyze \
    -s PATH_TO_COPIED_FILESYSTEM \
    -p websphere-container \
    -o ANALYSIS_OUTPUT_PATH \
    -r websphere-home=WEBSPHERE_HOME \
    -r websphere-java-home=WEBSPHERE_JAVA_HOME
    -r target-base-image=TARGET_BASE_IMAGE

자세한 내용은 WebSphere Application Server Liberty 워크로드의 마이그레이션 계획 만들기를 참조하세요.

Tomcat 플러그인 업데이트

Tomcat 플러그인의 검색 매개변수가 업데이트되었습니다.

이제 java-version 매개변수가 Tomcat 마이그레이션에 입력으로 추가됩니다.
이제 catalina-base 매개변수에 콜론(:)으로 구분된 여러 디렉터리를 포함할 수 있습니다.
이제 mFit을 사용하여 소스 VM을 스캔하는 경우에도 java-version, catalina-base, catalina-home 매개변수가 필요합니다.

자세한 내용은 Tomcat 워크로드의 마이그레이션 계획 만들기를 참조하세요.

Linux 시스템 컨테이너 플러그인 업데이트

Linux 시스템 서비스 엔드포인트는 더 이상 자동으로 검색되지 않으며 mFit을 사용하여 소스 VM을 스캔하더라도 Linux 마이그레이션 계획을 맞춤설정하는 동안 수동으로 지정해야 합니다.

고정

이전 버전의 Migrate to Containers CLI에서 일부 시스템에서 자동으로 삭제되는 /tmp 디렉터리의 소켓을 사용하려고 하면 copy 명령어가 실패할 수 있습니다. 이 버전에서는 기본값이 변경되었으며 소켓 위치를 맞춤설정하려면 SOCKDIR 환경 변수를 설정할 수 있습니다.

문제

Skaffold가 잘못된 대상에 대한 기본 이미지를 가져오려고 시도하므로 Windows 머신에서 Windows 이미지용 Skaffold 빌드가 실패할 수 있습니다.

이 문제를 해결하려면 docker pull 명령어를 사용하여 이미지를 수동으로 가져오고 Skaffold 빌드를 다시 실행합니다.
제한 시간이 짧으면 Windows IIS 워크로드 배포가 준비되지 않은 것으로 표시될 수 있습니다. Skaffold를 사용하여 워크로드를 배포하는 경우 배포가 실패한 것으로 표시될 수 있습니다.

이 문제를 해결하려면 PowerShell을 사용하여 준비 프로브 제한 시간과 기간을 늘립니다.
```
foreach ($file in (Get-ChildItem . -Recurse -Include "deployment_spec.yaml")) { (Get-Content $file).replace("periodSeconds: 10", "periodSe
conds: 30").replace("timeoutSeconds: 1", "timeoutSeconds: 10") | Set-Content $file }
```

2023년 6월 27일

2023년 6월 27일, Migrate to Containers CLI 버전 1.0.0이 출시되었습니다.

기능

업그레이드된 Skaffold API 버전

Migrate to Containers CLI가 이제 v2beta25 버전 대신 Skaffold API 버전 v4beta4를 사용하여 Skaffold 구성을 생성합니다.

Linux VM 컨테이너화에 대한 지원 추가

Migrate to Containers CLI를 사용하면 이제 Linux VM을 시스템 컨테이너로 마이그레이션할 수 있습니다. 소스 애플리케이션 파일을 검색하고 처리하여 Dockerfile, Kubernetes 매니페스트, Skaffold 기반 자동 배포 스크립트를 포함하는 마이그레이션 아티팩트를 생성합니다.

Migrate to Containers CLI는 현대화된 애플리케이션에 필요한 서비스의 부트 로더로 작동하는 사전 빌드된 Linux 시스템 컨테이너를 사용합니다. Migrate to Containers CLI를 사용하면 GKE, Cloud Run, GKE Enterprise 클러스터에서 실행할 수 있는 다양한 스테이트리스(Stateless) Linux 기반 애플리케이션을 현대화할 수 있습니다.

자세한 내용은 Linux VM 컨테이너의 마이그레이션 계획 만들기를 참조하세요.

`copy` 작업 개선

이제 copy 작업의 개선사항을 이용할 수 있습니다.

Migrate to Containers CLI copy 작업은 이제 로컬 컨테이너를 사용하여 로컬 tar 파일을 사용하는 대신 소스 VM 파일 시스템을 로컬 디렉터리에 복사합니다. 이렇게 하면 로컬 머신에 rsync를 설치할 필요가 없고 소스 머신의 파일 시스템을 복사하는 데 필요한 디스크 공간이 줄어듭니다.
오류가 발생하면 Migrate to Containers CLI가 이제 오류 지점에서부터 복사 프로세스를 계속 진행합니다.

자세한 내용은 소스 머신의 파일 시스템 복사를 참조하세요.

복사된 파일 시스템을 삭제하는 기능 추가

마이그레이션이 완료되면 새로운 cleanup 명령어를 사용하여 권한 문제 없이 로컬 머신에서 copy 명령어로 만든 소스 머신의 파일 시스템 사본을 삭제할 수 있습니다.

자세한 내용은 로컬 머신 삭제를 참조하세요.

데이터 마이그레이션에 대한 지원 추가

마이그레이션을 실행한 후 이제 새로운 migrate-data 명령어를 사용하여 대상 클러스터에서 신규 또는 기존 영구 볼륨 신청(PVC)에 데이터 디렉터리를 복사할 수 있습니다.

이 단계는 소스 VM에서 대상 컨테이너에 마운트된 영구 볼륨으로 영구 데이터 디렉터리를 마이그레이션해야 하는 경우에 필요합니다.

자세한 내용은 데이터 마이그레이션을 참조하세요.

2023년 6월 13일

2023년 6월 13일에 Migrate to Containers CLI가 이제 정식 버전으로 제공된다고 발표했습니다.

Migrate to Containers CLI를 사용하면 VM에서 실행되는 애플리케이션 구성요소를 GKE, GKE Autopilot, Cloud Run 또는 GKE Enterprise 클러스터에서 실행되는 컨테이너로 현대화할 수 있습니다.

자세한 내용은 명령줄에서 애플리케이션을 컨테이너 기반 워크로드로 이동 | Google Cloud 블로그를 참조하세요.

2023년 5월 2일

2023년 5월 2일, Migrate to Containers CLI 버전 0.2.0이 미리보기로 출시되었습니다. Migrate to Containers CLI를 사용하면 VM에서 실행되는 애플리케이션 구성요소를 GKE, GKE Autopilot, Cloud Run 또는 GKE Enterprise 클러스터에서 실행되는 컨테이너로 현대화할 수 있습니다. 이 도구는 4개의 기본 단계로 구성된 간소화된 흐름을 제공합니다.

SSH 또는 gcloud CLI를 사용해서 소스 VM에서 애플리케이션 파일을 복사합니다.
애플리케이션 파일의 로컬 복사본을 분석하여 마이그레이션 계획을 생성합니다.
마이그레이션 계획 파일을 수정하여 마이그레이션 계획을 맞춤설정합니다.
컨테이너 이미지, 배포 YAML, Skaffold 구성 파일로 필요한 아티팩트를 생성합니다.

자세한 내용은 Migrate to Containers | Google Cloud를 참조하세요.

기능

소스 애플리케이션 파일 복사

SSH를 사용하여 원격 VM 온프레미스에서 또는 gcloud CLI를 사용하여 Google Cloud에서 실행되는 VM에서 애플리케이션 파일을 복사합니다.

애플리케이션 파일에서 현대화 변경사항 분석

애플리케이션 바이너리 및 구성 파일을 분석하고 복사한 파일에서 추출한 매개변수를 사용해서 마이그레이션 계획 파일 보고서 및 마이그레이션 계획을 생성합니다.

컨테이너로 실행할 애플리케이션 아티팩트 생성

대상 클러스터에서 생성된 아티팩트의 배포를 자동화할 수 있게 해주는 Skaffold 구성 파일을 사용하여 애플리케이션을 컨테이너로 실행하기 위해 필요한 아티팩트를 생성합니다.

지원되는 현대화 흐름

새 Migrate to Containers CLI를 사용하면 로컬 환경에서 애플리케이션 현대화 작업을 수행하고 생성된 아티팩트를 로컬 또는 원격 클러스터에 직접 배포할 수 있습니다.

Migrate to Containers CLI는 다음 현대화 흐름을 지원합니다.

커뮤니티 기본 이미지를 사용하는 컨테이너에 대한 Tomcat 애플리케이션
커뮤니티 기본 이미지를 사용하는 컨테이너에 대한 Apache 애플리케이션
커뮤니티 WildFly 기본 이미지를 사용하는 컨테이너에 대한 IBM JBoss 애플리케이션
IBM WebSphere Application Server 기존 이미지를 사용하는 컨테이너에 대한 기존 IBM Websphere Application Server 애플리케이션
Open Liberty 컨테이너 이미지를 사용하는 컨테이너에 대한 기존 IBM Websphere Application Server 애플리케이션