Kubernetes에서 IntelliJ용 Cloud Code 시작하기

Cloud Code를 사용하면 샘플 또는 기존 프로젝트를 기반으로 Kubernetes 애플리케이션을 만들 수 있습니다.

템플릿에서 애플리케이션 만들기

Cloud Code에는 빠른 시작을 위한 코드 샘플 템플릿 모음이 포함되어 있습니다. 기존 샘플을 사용하여 Kubernetes 애플리케이션을 만들려면 다음 단계를 따르세요.

  1. File(파일) > New Project(새 프로젝트)를 엽니다.
  2. Cloud Code: Kubernetes를 선택합니다.
  3. 시작 애플리케이션 목록에서 템플릿을 선택합니다.
  4. 프로젝트 이름을 선택합니다.

    Finish(마침)를 클릭하면 Cloud Code에서 선택한 템플릿을 클론하고 새로 만든 프로젝트를 사용합니다.

    자바 템플릿의 경우 Maven 프로젝트를 가져와서 pom.xml을 동기화하라는 메시지가 표시됩니다. Maven 프로젝트로 추가를 클릭하세요. 또한 Import Changes(변경사항 가져오기)를 클릭하여 필요한 Maven 프로젝트를 가져옵니다.

  5. 프로젝트의 Kubernetes 실행 및 개발 IDE 실행 대상이 자동으로 생성되어 바로 실행할 수 있습니다.

    선택사항: 실행 대상을 수동으로 만들어도 됩니다.

    1. Run Configuration(실행 구성) 드롭다운을 선택하고 Edit Configurations(구성 수정)를 클릭합니다.
    2. + Add New Configuration(새 구성 추가)을 클릭하여 새 실행 구성을 추가합니다.
    3. Cloud Code: Kubernetes로 이동합니다.
    4. 새 구성의 이름을 입력합니다(기본값은 '이름 없음').
    5. OK(확인)를 클릭하면 실행 대상이 생성됩니다.

자체 애플리케이션 사용

기존 프로젝트를 사용하는 단계는 기존 Kubernetes 애플리케이션에 Cloud Code 사용을 참조하세요.

Kubernetes 컨텍스트 설정

애플리케이션을 실행하기 전 원하는 Kubernetes 컨텍스트에 앱을 배포하도록 설정되었는지 확인합니다. 이는 구성에서 지정할 수 있습니다.

현재 컨텍스트를 전환하려면 오른쪽 사이드바 패널에서 또는 도구 > Cloud Code > Kubernetes > 클러스터 탐색기 보기를 사용하여 Kubernetes 탐색기로 전환할 수 있습니다

이미지를 다시 빌드할 필요 없이 특정 유형의 파일 변경사항을 빠르게 선택하여 개발 루프를 최적화하려면 파일 동기화 및 핫 리로드(Hot reloading)를 사용 설정하면 됩니다.

구성

Cloud Code: Develop on Kubernetes 실행 구성을 사용하는 경우 사용 가능한 설정을 구성하여 배포를 맞춤설정할 수 있습니다.

구성을 추가하거나 수정하려면 실행 > 구성 수정으로 이동합니다.

컨테이너 이미지 스토리지 옵션

원격 클러스터를 컨텍스트로 선택한 경우 이미지를 푸시할 이미지 레지스트리를 선택합니다. 실행 >구성 수정으로 이동하여 실행/디버그 구성에서 이미지 레지스트리를 설정합니다.

자세한 내용은 컨테이너 이미지 저장 가이드를 참조하세요.

빌드 설정

Cloud Code는 Docker, Jib, Buildpacks 아티팩트 유형을 지원합니다. 원하는 빌더 및 관련 설정을 설정하는 방법에 대한 자세한 내용은 컨테이너 이미지 빌드 환경설정 구성 가이드를 참조하세요.

시작 구성 맞춤설정

애플리케이션 실행 방법을 구성하려면 skaffold.yaml 파일을 맞춤설정하면 됩니다.

실행/디버그 구성에서 시작을 구성할 수도 있습니다. 구성을 수정하려면 실행 > 구성 수정으로 이동합니다.

시작 구성 맞춤설정에 대한 자세한 내용은 Cloud Code의 Kubernetes를 참조하세요.

애플리케이션 실행

애플리케이션이 설정되면 Kubernetes 클러스터에서 실행하고 skaffold dev를 활용하여 실시간으로 볼 수 있습니다. Minikube 또는 Docker Desktop과 같은 로컬 클러스터, Google Kubernetes Engine 또는 다른 클라우드 제공업체에서 애플리케이션을 실행할 수 있습니다.

  1. 원하는 실행 작업에서 실행 아이콘을 클릭합니다. 그런 다음 로그 탭의 출력 창에서 수신되는 애플리케이션 로그를 볼 수 있습니다.

    배포가 시작되면 배포된 애플리케이션의 전달된 포트 목록이 표시됩니다.

  2. 배포가 성공하면 새로운 서비스 URL을 사용할 수 있다는 알림이 표시됩니다. 서비스 URL 탭을 클릭하여 URL을 확인한 후 URL 링크를 클릭하여 실행 중인 애플리케이션으로 브라우저를 엽니다.

    또는 이벤트 로그를 연 후 링크를 클릭하여 실행 중인 애플리케이션으로 브라우저를 열 수 있습니다.

    배포된 리소스 창에는 개발 세션 중에 배포한 항목이 표시됩니다.

로그 보기

애플리케이션을 개발하고 실행하는 동안 터미널 출력에서 pod를 실시간 스트림으로 보는 로그 외에 Kubernetes 탐색기로 이동하여 특정 pod의 로그를 볼 수 있습니다.

특정 포드의 로그를 보려면 다음 단계를 따릅니다.

  1. Kubernetes 탐색기로 이동합니다. 오른쪽 측면 패널에서 또는 Tools(도구) > Cloud Code > Kubernetes > View Cluster Explorer(클러스터 탐색기 보기)를 사용해 액세스할 수 있습니다.

  2. 로그를 보려는 포드를 선택합니다.

  3. pod를 마우스 오른쪽 버튼으로 클릭한 다음 스트림 로그를 클릭합니다. 또는 pod에서 실행되는 개별 컨테이너의 로그를 스트리밍할 수 있습니다.

    Kubernetes 탐색기 콘솔에 로그가 표시됩니다.

변경, 다시 빌드, 삭제

시작 구성에서 감시 모드가 주문형으로 설정되어 있고 애플리케이션을 변경한 다음 애플리케이션을 다시 빌드하고 다시 배포하려면 다음 안내를 따르세요.

  1. 변경사항을 적용하고 저장합니다.

  2. 빌드 및 배포 트리거 아이콘을 클릭하거나 Option + Ctrl/Cmd + Comma를 눌러 애플리케이션을 다시 빌드하고 재배포합니다.

  3. 애플리케이션 실행을 중지하려면 중지 아이콘을 클릭하거나 Ctrl/Cmd + F2를 누릅니다.

애플리케이션을 중지한 후 배포된 모든 Kubernetes 리소스가 클러스터에서 삭제됩니다. 시작 구성에서 cleanUp 플래그를 사용하여 이 동작을 변경할 수 있습니다.

보안 비밀 저장

코드에 API 키, 비밀번호, 인증서와 같이 민감할 수 있는 데이터가 포함된 경우 이를 보안 비밀로 저장하는 것이 좋습니다. Cloud Code를 사용하면 이러한 보안 비밀을 Secret Manager에 안전하게 저장하고 필요할 때 프로그래매틱 방식으로 가져올 수 있습니다.

Cloud Code를 사용하여 보안 비밀을 만들고 관리하는 방법에 대한 자세한 내용은 Secret Manager 가이드를 참조하세요.

리소스 세부정보 보기

Kubernetes 탐색기에는 클러스터, 네임스페이스, 노드, 워크로드(예: 배포, 복제본, 포드, 컨테이너 등), 서비스 및 인그레스, 구성(보안 비밀, 구성 맵 등), 스토리지(볼륨 등)가 표시됩니다. Kubernetes 탐색기를 사용하면 이러한 리소스 중 일부에 대해 고유한 작업을 수행할 수 있습니다.

리소스 세부정보 보기에 대한 자세한 내용은 Kubernetes 개요를 참조하세요.

다음 단계

지원 받기

IntelliJ IDE에서 의견을 제출하거나 문제를 신고하려면 도구 > Cloud Code > 도움말 / 정보 > 의견 제출 또는 문제 신고로 이동하여 GitHub에 문제를 신고하거나 Stack Overflow에서 질문합니다.