Kubernetes 앱 실행

이 페이지에서는 Cloud Code를 빠르게 시작하는 방법을 설명합니다.

시작 'Hello World' 템플릿을 사용하여 새 Kubernetes 애플리케이션을 설정하고, 클러스터를 만들고, 이 클러스터에서 앱을 실행하고, 실행 중인 코드를 디버깅하고, 라이브 애플리케이션의 로그를 보고, 실행 중인 컨테이너에 터미널을 연결합니다.

Cloud Code로 새로운 Hello World 앱 만들기

시작하기 전에

Google Cloud를 사용하려면 Google Cloud 프로젝트를 만들고 결제를 사용 설정해야 합니다.

Cloud Code 설치

  1. 아직 설치하지 않았다면 머신에 Visual Studio Code를 설치합니다.
  2. 모든 Cloud Platform의 경우 Docker 클라이언트(Docker 레지스트리로 인증됨)를 머신의 PATH에 설치합니다(설치 폴더는 PATH 내의 디렉터리 아래에 표시되어야 함).

    • docker -v를 실행하여 Docker가 이미 설치되어 있는지 확인합니다.
    • Windows Home을 사용하는 경우 Windows Home에 Docker Desktop 설치를 참조하세요.
    • WSL을 사용 중이지만 데스크톱용 Docker를 설치할 수 없는 경우 Cloud Code를 사용한 로컬 개발에 minikube를 대신 사용합니다.

    Cloud Code는 kubectl, Skaffold, Cloud SDK를 자동으로 설치합니다.

  3. 다음 옵션 중 하나를 사용하여 Cloud Code를 설치합니다.

    • VS 코드 열기 및 Cloud Code 설치
    • 머신에서 Visual Studio Code를 엽니다. VS Code의 확장 프로그램확장 프로그램 아이콘(왼쪽 작업 표시줄에 있는 정사각형 아이콘)를 사용하여 Cloud Code 확장 프로그램을 검색하고 설치를 클릭합니다.

    설치가 완료되면 Cloud Code 시작 페이지가 표시되고 새 애플리케이션을 빠르게 설정하는 데 사용할 수 있는 기본 제공 템플릿 모음이 시작 앱 아래 표시됩니다.

    Cloud Code 시작 페이지

    또한 일반적인 Cloud Code 작업과 함께 제공되는 Cloud Code 상태 표시줄을 VS Code 상태 표시줄 안에서 사용할 수 있습니다.

    Cloud Code 상태 표시줄

애플리케이션 만들기

  1. 명령어 팔레트(Cmd/Ctrl+Shift+P)에서 Cloud Code: New Application을 실행하고, Kubernetes 애플리케이션을 선택한 다음 원하는 언어로 Hello World 앱을 선택합니다.

    예를 들어 Node.js: Hello World를 선택하면 시작 Node.js Hello World 앱이 생성됩니다.

  2. 새 애플리케이션을 저장합니다.

    애플리케이션이 생성되었음을 알리는 알림이 표시되며 애플리케이션이 포함된 새 창이 열립니다.

Google Kubernetes Engine 클러스터 만들기

스탠더드 GKE 클러스터를 만들려면 다음 단계를 따르세요.

  1. 왼쪽의 VS Code 작업 막대에서 Cloud Code 뷰 Kubernetes 탐색기 아이콘 아이콘을 클릭하여 Google Kubernetes Engine 탐색기로 이동합니다.
  2. Google Cloud SDK에 로그인하려면 여기를 클릭하세요를 클릭하여 Cloud SDK에 인증합니다.
  3. Google Kubernetes Engine 탐색기 패널의 헤더에서 + 버튼(마우스 커서를 갖다 놓으면 사용 가능)을 클릭하여 새 GKE 클러스터를 만듭니다.
  4. 기본 프로젝트에서 클러스터를 만들어야 합니다.
  5. 클러스터 만들기 마법사의 입력란에 필요한 사항을 입력한 후 클러스터 만들기를 클릭합니다.

    이 예시에서는 프로젝트 ID는 기본 프로젝트 ID 버튼을 사용하여 설정했고 영역은 us-central1-a, 클러스터 이름은 my-first-cluster으로 정의되었습니다.

    클러스터를 만들려면 몇 분 정도 걸립니다. 클러스터가 생성되면 GKE 탐색기 뷰 Kubernetes 탐색기 아이콘에 표시됩니다.

    GKE 탐색기로 새 클러스터 만들기

앱 실행

구성 테스트 실행 수행

앱 구성의 유효성을 확인하려면 다음 단계를 따르세요.

  1. IDE에서 검증하려는 구성 파일을 엽니다(Hello World 앱의 경우 구성 파일은 kubernetes-manifests 폴더 아래에 있음).
  2. 명령어 팔레트에서(관리 메뉴관리 아이콘에서 액세스 가능) Cloud Code: Dry-run current config for server-side validationCloud Code: Dry-run current config for client-side validation 명령어를 사용하면 됩니다.

    그러면 kubectl apply -f dry-run=server(클라이언트 옵션의 경우 kubectl apply -f dry-run=client)가 실행되며 유효성 검사가 성공하면(또는 구성 파일이 유효하지 않은 경우 오류 메시지) 토스트 메시지가 표시됩니다.

    명령어 팔레트에 나열된 명령어 테스트 실행 및 서버 측 유효성 검사에 대해 현재 구성 테스트 실행 선택됨

앱 실행 및 보기

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

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

  1. Cloud Code 상태 표시줄을 사용하고 Kubernetes에서 실행을 선택합니다.
  2. 현재의 클러스터 컨텍스트를 사용할지 또는 다른 컨텍스트로 전환할지 확인합니다.
  3. 메시지가 표시되면 이미지를 푸시할 이미지 레지스트리를 선택합니다.

    실행 중인 애플리케이션의 진행 상태를 추적할 수 있는 출력 창이 표시됩니다. 터미널 출력에서 실행 중인 pod의 실시간 로그 스트림도 볼 수 있습니다.

  4. 애플리케이션이 Kubernetes에서 실행된 후 출력 창에 IP 주소가 표시됩니다. 이 링크된 IP 주소를 사용하여 애플리케이션에 액세스하려면 Ctrl/Cmd + 클릭합니다.

    Hello World 앱 실행

문제 해결 도움말

기존 클러스터를 사용하는 경우 클러스터 사용자 인증 정보를 가져와서 클러스터를 kubectl에 추가하려면 다음 명령어를 실행합니다.

 gcloud container clusters get-credentials ${CLUSTER} --zone=${ZONE}
 

또는 클러스터를 활성으로 설정하고 다음과 같이 GKE 탐색기를 사용하여 클러스터 사용자 인증 정보를 가져올 수 있습니다.

  1. GKE 탐색기(Cloud Code 보기 Kubernetes 탐색기 아이콘Kubernetes 탐색기를 통해 액세스할 수 있는 패널)로 이동합니다.
  2. 클러스터를 마우스 오른쪽 버튼으로 클릭한 후 활성 클러스터로 설정을 클릭합니다.

앱 디버깅

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

  1. Cloud Code 상태 표시줄을 사용하고 Kubernetes에서 디버그를 선택합니다.
  2. 메시지가 표시되면 현재의 클러스터 컨텍스트를 사용할지 또는 선호하는 컨텍스트로 전환할지 확인합니다.

    Cloud Code는 .vscode/launch.json 파일에서 cloudcode.kubernetes 구성을 사용하여 애플리케이션을 실행하고 디버거 세션을 연결합니다.

    그러면 Cloud Code는 컨테이너를 빌드하고 레지스트리로 푸시하여 Kubernetes 구성을 클러스터에 적용한 후 라이브 애플리케이션을 탐색하는 데 사용할 수 있는 IP 주소를 반환합니다.

  3. 디버거 세션이 연결되기 전에 디버그하려는 프로그램이 있는 원격 컨테이너의 디렉터리를 확인하거나 입력하라는 메시지가 표시됩니다. 컨테이너 디버깅을 건너뛰려면 ESC를 누릅니다.

  4. #9행에 중단점을 추가하려면 src/app.js를 열고 편집기 여백을 클릭합니다.

    빨간색으로 채워진 원은 활성 중단점을, 회색의 속이 빈 원은 사용 중지된 중단점을 나타냅니다. 중단점을 더 세밀하게 제어하려면 VS Code의 디버그 뷰에서 중단점 섹션을 사용할 수 있습니다.

    중단점을 추가, 삭제, 사용 중지할 수 있는 디버그 뷰 왼쪽 패널의 중단점 섹션

    애플리케이션에 새 요청을 전송하면 디버거가 첫 번째 활성 중단점에서 일시 중지됩니다.

    다음 샘플에서 변수 섹션의 로컬에서 Hello, world!res._contentLength; 값이 13임을 기록합니다.

    중단점 및 변수에서 일시중지된 앱과 범위의 값으로 채워진 호출 스택 섹션

  5. #8행에서 전송되는 문자열을 Hello, goodbye!로 수정한 후 Kubernetes에서 디버그 작업을 다시 시작합니다.

    앱이 다시 빌드되고 다시 배포된 후 업데이트된 res._contentLength의 값을 확인합니다.

    값이 업데이트된 중단점에서 일시중지된 앱

로그 보기

실행 중인 애플리케이션의 터미널 출력에서 실행 중인 Pod의 라이브 로그 스트림을 보는 것 외에도 Cloud Code에 제공되는 로그 뷰어로 로그를 볼 수 있습니다.

로그를 보려면 다음 단계를 따르세요.

  1. 명령어 팔레트(Ctrl/Cmd+Shift+P 또는 톱니바퀴 아이콘 관리 아이콘으로 표시된 관리 메뉴를 통해 액세스 가능)를 사용해 Cloud Code: View Logs를 입력하여 로그 뷰어를 시작합니다.
  2. 로그 뷰어 검색창의 배포 필드를 사용하여 로그를 보려면 실행 중인 앱(이 경우 nodejs-hello-world)을 검색합니다.

    로그 뷰어 검색창 내의 배포 필드를 'nodejs-hello-world'로 설정하여 로그 보기

보너스: 컨테이너에서 터미널 열기

컨테이너에서 터미널을 열려면 다음 안내를 따르세요.

  1. Kubernetes 탐색기로 이동합니다.
  2. 클러스터를 선택하고 기본 pod 섹션에서 연결할 pod를 선택합니다.
  3. 지정된 Pod에서 컨테이너 섹션을 확장합니다.
  4. 터미널을 열려는 컨테이너를 마우스 오른쪽 버튼으로 클릭한 후 터미널 가져오기를 클릭합니다.

    그러면 터미널이 시작됩니다. 이제 실행 중인 컨테이너 내에서 셸에 액세스할 수 있습니다!

    지정된 pod의 터미널 열기

삭제

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

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

Google Cloud를 사용하고 클러스터만 삭제하려면 다음을 수행하세요.

  • Cloud Code 뷰 Kubernetes 탐색기 아이콘 아래의 Kubernetes 탐색기에서 Google Kubernetes Engine 탐색기 창에서 삭제할 클러스터를 마우스 오른쪽 버튼으로 클릭하고 클러스터 삭제를 선택합니다.

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

  1. Cloud Console의 프로젝트 페이지로 이동합니다.

    프로젝트 페이지로 이동

  2. 이 빠른 시작에서 만든 프로젝트를 선택한 다음 옆에 있는 휴지통 아이콘을 클릭하여 삭제합니다.

    그러면 프로젝트가 종료되고 삭제 일정이 예약됩니다.

다음 단계