Linux 애플리케이션을 컨테이너로 리플랫폼하기

Migrate to Containers를 Cloud Code와 통합하면 가상 머신(VM)에서 실행되는 Linux 애플리케이션 구성요소를 현대화하고 Linux 머신을 사용하여 IDE에서 직접 Google Kubernetes Engine 및 Cloud Run에 배포할 수 있는 아티팩트 생성할 수 있습니다.

이 가이드에서는 Linux 머신의 IDE에서 Cloud Code 확장 프로그램을 사용하여 기존 애플리케이션을 GKE 컨테이너로 플랫폼을 변경하는 방법에 대해 알아봅니다.

이 가이드는 VS Code 관련 실무 지식이 있고 Google Cloud에 익숙하며 애플리케이션 구성요소를 실행하는 VM이 있는 Linux 머신 개발자를 대상으로 합니다.

시작하기 전에

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API.

Enable the API

아직 설치하지 않은 경우 Cloud Code 확장 프로그램을 설치합니다.
GKE 클러스터 만들기 및 구성
수행하려는 마이그레이션 유형을 알고 있는지 확인합니다. 지원되는 워크로드에 관한 자세한 내용은 호환되는 OS, 워크로드, Kubernetes 버전 검토를 참조하세요.
현대화를 위해 소스 및 로컬 머신을 준비합니다. Cloud Code는 현대화를 위한 Linux만 지원합니다.

플랫폼 이전 소스 추가

이 섹션에서는 아직 로컬 머신에 Migration Center 탐색 클라이언트 CLI(mcdc) 및 기타 Migrate to Containers 도구를 설치하지 않은 경우 다음 단계를 수행하여 플랫폼 변경 소스를 추가합니다.

IDE의 작업 표시줄에서 Cloud Code를 클릭한 다음 플랫폼 변경 앱 탐색기를 펼칩니다.
Cloud Code에서 Migrate to Containers를 처음 사용하는 경우 도구 설치를 클릭하여 로컬 머신에 mcdc CLI 및 기타 Migrate to Containers 도구를 설치해야 합니다. 그렇지 않은 경우 다음 단계로 진행합니다.
소스 수정을 클릭합니다. 그러면 빈 mcdc-sources.json 파일이 열립니다. 다음 형식으로 소스를 추가합니다.
```
[
  {
    "title": "SOURCE_NAME",
    "host": "HOSTNAME",
    "user": "USER",
    "identityFile":"IDENTITY-FILE-PATH"
  }
]
```
참고: SSH 명령어에서 동일한 host, user, identityFile 변수를 사용할 수 있습니다.
플랫폼 이전 앱 탐색기에 소스가 표시되는지 확인하려면 플랫폼 이전 앱 탐색기 위에 마우스 포인터를 올려놓고 표시되는 캐시된 소스 새로고침 버튼을 클릭합니다.

선택사항: 적합성 평가 생성

컨테이너로 애플리케이션의 플랫폼 변경을 시도하기 전에 소스의 적합성 평가를 생성하여 소스에서 컨테이너 플랫폼 변경을 수행할 수 있는지 알려주는 것이 좋습니다.

소스의 적합성 평가를 생성하려면 소스를 마우스 오른쪽 버튼으로 클릭하고 소스 평가를 선택합니다. 이렇게 하면 IDE에서 터미널이 열리고 소스 평가의 로그가 표시됩니다.

평가가 완료되면 mcdc는 IDE에 적합성 평가 보고서를 생성합니다.

소스가 적합으로 보고되면 애플리케이션을 플랫폼 변경할 준비가 된 것입니다.

애플리케이션 플랫폼 이전

Cloud Code는 각 플랫폼 변경을 위한 전용 작업공간을 만들고 작업공간에서 복사, 분석, 생성 태스크를 실행하여 플랫폼 변경 단계를 자동화할 수 있습니다. 복사 및 분석 태스크를 먼저 실행하지 않고 생성 태스크를 실행하면 아티팩트를 생성하기 전에 자동으로 두 태스크가 실행됩니다.

다음 섹션에서는 이러한 각 작업을 수행하고 Cloud Code를 사용하여 애플리케이션을 컨테이너로 플랫폼 변경하는 방법을 안내합니다.

마이그레이션 수명 주기에 관한 자세한 내용은 Migrate to Containers CLI 아키텍처를 참조하세요.

새 플랫폼 이전 작업공간 만들기

새로운 플랫폼 이전 작업공간을 만들기 전에 마이그레이션 유형에 대해 선택할 마이그레이션 파라미터를 알아야 합니다. 각 마이그레이션 유형의 파라미터에 관한 자세한 내용은 마이그레이션 계획 만들기를 참조하세요.

IDE에서 아티팩트가 포함된 새 플랫폼 이전 작업공간을 만들려면 다음 단계를 따르세요.

플랫폼 이전 앱 탐색기에서 플랫폼을 이전할 소스를 마우스 오른쪽 버튼으로 클릭한 후 플랫폼 이전을 클릭합니다.
메뉴에 표시되는 옵션 목록에서 플랫폼 이전 여정을 선택합니다.
애플리케이션의 플랫폼을 이전할 새 작업공간 디렉터리를 선택하고 확인을 클릭한 다음 플랫폼 이전 작업공간 만들기를 클릭합니다.
마이그레이션 유형에 대한 마이그레이션 매개변수를 선택합니다.
선택사항: WebSphere 마이그레이션 유형을 선택하고 바이너리 스캐너를 사용하려면 binaryAppScanner.jar 파일을 선택합니다.

작업공간을 생성하는 데 몇 초 정도 걸립니다. 그러면 IDE의 새 창에 새 작업공간 디렉터리가 열립니다.

VM에서 작업공간으로 파일 복사

VM에서 IDE의 작업공간으로 파일을 복사하려면 다음 단계를 수행합니다.

선택사항: mcdc CLI는 필터를 적용하여 사본 크기를 줄이지만 filters.txt 파일을 수정하여 사본 크기를 더 줄일 수 있습니다. 사본 크기를 줄이는 방법은 복사된 파일 시스템 크기 감소를 참조하세요.
Ctrl+Shift+P를 눌러 명령어 팔레트를 엽니다.
태스크: 태스크 실행을 검색하여 선택한 다음 m2c: 복사를 선택합니다. 파일을 복사하는 데 몇 분 정도 걸릴 수 있습니다.

VM 파일 시스템 분석 및 마이그레이션 계획 생성

VM 파일 시스템을 분석하고 마이그레이션 계획을 생성하려면 다음 단계를 수행합니다.

Ctrl+Shift+P를 눌러 명령어 팔레트를 엽니다.
태스크: 태스크 실행을 검색하여 선택한 다음 m2c: 분석을 선택합니다.

분석 태스크가 실패할 경우 analyze-args.ini 파일을 통해 마이그레이션 매개변수를 수정해야 합니다. 이 파일에는 매개변수당 한 줄이 있으며 해당 매개변수에 대한 문서가 포함됩니다.

분석이 성공하면 Cloud Code에서 config.yaml 파일 형식으로 분석 결과를 포함하는 migration-plan이라는 디렉터리를 만듭니다. 이 파일을 수정하여 아티팩트가 생성되는 방식을 변경할 수 있습니다.

config.yaml 파일의 구조는 마이그레이션 유형에 따라 다릅니다. 지원되는 마이그레이션 유형에 관한 자세한 내용은 다음 페이지를 참조하세요.

아티팩트 생성

아티팩트를 생성하려면 IDE에서 생성 태스크를 실행해야 합니다. 이전 섹션에서 복사 및 분석 태스크를 아직 실행하지 않은 경우 생성 태스크에서 아티팩트를 생성하기 전에 자동으로 두 작업을 모두 실행합니다.

아티팩트를 생성하려면 다음 단계를 수행하세요.

Ctrl+Shift+P를 눌러 명령어 팔레트를 엽니다.
태스크: 태스크 실행을 검색하여 선택한 다음 m2c: 생성을 선택합니다. 이렇게 하면 src 디렉터리에 아티팩트가 생성되며, 여기에는 컨테이너 이미지를 빌드하고 배포하는 데 사용되는 skaffold.yaml 파일이 포함됩니다. 각 마이그레이션 유형은 서로 다른 아티팩트를 생성하지만 모든 마이그레이션 유형은 일반적으로 하나 이상의 Dockerfile과 skaffold.yaml이 참조하는 GKE 배포 사양을 만듭니다.

아티팩트 생성이 완료되면 애플리케이션의 플랫폼 이전이 완료된 것입니다.
선택사항: 마이그레이션 계획을 수정하려면 config.yaml 파일을 수정하고 m2c: 생성 태스크를 다시 실행합니다.

그렇지 않고 플랫폼 변경 결과에 만족하는 경우 계속해서 GKE 컨테이너에서 애플리케이션을 실행하면 됩니다.

GKE 컨테이너에서 애플리케이션 실행

이 섹션에서는 GKE 컨테이너에서 플랫폼 변경된 애플리케이션을 실행하고, 실행 중인 애플리케이션의 로그를 보고, 리소스를 삭제합니다.

아직 GKE 클러스터를 만들고 구성하지 않았다면 VS Code용 Cloud Code에서 GKE 클러스터 만들기 및 구성의 안내를 따르세요.

GKE 애플리케이션 디버깅에 관해 자세히 알아보려면 VS Code용 Cloud Code로 Kubernetes 애플리케이션 디버그를 참조하세요.

애플리케이션 실행 및 보기

이제 모든 설정이 완료되었으므로 애플리케이션을 실행하고 라이브로 볼 수 있습니다. Cloud Code가 파일 시스템에서 변경사항을 감시하므로 앱을 실시간으로 수정하고 다시 실행할 수 있습니다.

애플리케이션을 실행하려면 다음 단계를 따르세요.

Cloud Code 상태 표시줄에서 활성 프로젝트 이름을 클릭합니다.
표시되는 빠른 선택 메뉴에서 Kubernetes에서 실행을 선택합니다.
현재의 클러스터 컨텍스트를 사용할지 또는 다른 컨텍스트로 전환할지 확인합니다.
메시지가 표시되면 이미지를 푸시할 이미지 레지스트리를 선택합니다. gcr.io/PROJECT_ID를 사용하여 새 이미지 레지스트리를 만드는 경우 이미지 레지스트리가 클러스터와 동일한 프로젝트에 있는지 확인합니다.

실행 중인 애플리케이션의 진행 상태를 추적할 수 있는 출력 창이 표시됩니다. 터미널 출력에서 실행 중인 포드의 실시간 로그 스트림도 볼 수 있습니다.
애플리케이션이 Kubernetes에서 실행된 후 출력 창에 IP 주소가 표시됩니다. 이 연결된 IP 주소를 사용하여 애플리케이션에 액세스하려면 Ctrl를 누르고 주소를 클릭합니다.

디버깅 세션이 시작되면 개발 세션 창에 구조화된 로깅 뷰가 표시됩니다. 태스크가 시작되면 태스크는 회전하는 반원 progress_activity으로 표시됩니다.

태스크가 성공하면 단계 옆에 체크표시 check_circle가 표시됩니다.

단계에 대한 세부정보를 보려면 개발 세션 창에서 단계를 클릭합니다. 출력 창에는 로깅 출력의 단계가 표시됩니다.

삭제

애플리케이션을 중지하면 실행 중에 배포된 모든 Kubernetes 리소스가 자동으로 삭제됩니다.

이 빠른 시작에서 사용되는 다른 리소스에 대한 비용이 계정에 청구되지 않도록 하려면 프로젝트를 삭제하거나 프로젝트를 다시 사용하려면 만든 클러스터를 삭제해야 합니다.

클러스터를 삭제하려면 다음을 실행하세요.

Cloud Code를 클릭한 다음 Kubernetes 탐색기를 펼칩니다.
클러스터 이름 위에 마우스 포인터를 올려놓고 open_in_new Google Cloud 콘솔에서 열기를 클릭합니다.
삭제를 클릭한 다음 삭제를 클릭합니다.

프로젝트 및 클러스터를 포함한 관련 리소스를 삭제하려면 다음 안내를 따르세요.

주의: 프로젝트를 삭제하면 다음과 같은 효과가 발생합니다.

프로젝트의 모든 항목이 삭제됩니다. 이 문서의 태스크에 기존 프로젝트를 사용한 경우 프로젝트를 삭제하면 프로젝트에서 수행한 다른 작업도 삭제됩니다.
커스텀 프로젝트 ID가 손실됩니다. 이 프로젝트를 만들 때 앞으로 사용할 커스텀 프로젝트 ID를 만들었을 수 있습니다. appspot.com URL과 같이 프로젝트 ID를 사용하는 URL을 보존하려면 전체 프로젝트를 삭제하는 대신 프로젝트 내에서 선택한 리소스만 삭제합니다.

여러 아키텍처, 튜토리얼, 빠른 시작을 살펴보려는 경우 프로젝트를 재사용하면 프로젝트 할당량 한도 초과를 방지할 수 있습니다.

In the Google Cloud console, go to the Manage resources page.
Go to Manage resources
In the project list, select the project that you want to delete, and then click Delete.
In the dialog, type the project ID, and then click Shut down to delete the project.

플랫폼 이전 프로세스 중에 생성된 모든 로컬 파일을 삭제하려면 다음 단계를 따르세요.

명령어 팔레트를 엽니다(Ctrl+Shift+P).
태스크: 태스크 실행을 검색하여 선택한 다음 m2c: 정리를 선택합니다.