IntelliJ용 Cloud Code에서 Kubernetes 탐색기 사용

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

Kubernetes 탐색기 창을 사용하면 IDE에서 바로 클러스터, 노드, 워크로드 등에 대한 정보에 액세스할 수 있습니다. 또한 Kubernetes 탐색기를 사용하여 현재 컨텍스트 설정, 로그 스트리밍 및 보기, 대화형 터미널 열기, 리소스 설명 조회를 수행할 수 있습니다.

Kubernetes 탐색기 액세스

오른쪽 측면 패널에서 액세스할 수 있는 Kubernetes 탐색기를 사용하면 Kubernetes 리소스를 더 쉽게 관리할 수 있습니다. 또는 Tools(도구) > Cloud Code > Kubernetes > View Cluster Explorer(클러스터 탐색기 보기)를 사용하여 액세스할 수 있습니다.

오른쪽 작업 표시줄의 탭에 열려 있는 Kubernetes 탐색기 패널

Cloud Code는 '$HOME/.kube' 디렉터리 아래에 있는 기본 kubeconfig 파일을 사용하지만 Kubernetes 리소스를 검색하기 위해 대체 kubeconfig 파일을 사용할 수 있습니다. kubeconfig 관리 방법에 대한 자세한 내용은 추가 kubeconfig 파일로 작업을 참조하세요.

기본 작업

Kubernetes 탐색기를 구동하는 도구는 kubectl입니다. 클러스터에 액세스하도록 kubectl 컨텍스트를 구성했다면 Kubernetes 탐색기를 사용하여 활성 또는 비활성 컨텍스트에 관계없이 클러스터에 사용할 수 있는 모든 네임스페이스, 리소스, 노드를 찾아볼 수 있습니다.

탐색기에서 아이콘을 통해 액세스할 수 있는 사용 가능한 일반적인 Kubernetes 탐색기 작업은 다음과 같습니다.

  • 샘플에서 새 Kubernetes 앱 아이콘 샘플에서 새 Kubernetes 애플리케이션 생성
  • 탐색기 새로고침 아이콘 탐색기 새로고침
  • 문서 열기 아이콘 웹브라우저에서 Cloud Code Kubernetes 문서 열기

리소스 이름 복사

모든 Kubernetes 리소스 이름을 클립보드에 복사할 수 있습니다(컨테이너 및 클러스터 이름 포함).

마우스 오른쪽 버튼 클릭 메뉴를 사용하여 리소스 이름 복사

리소스 새로고침

Kubernetes 탐색기는 변경 사항을 감시하고 업데이트를 반영하도록 자동으로 새로고침합니다. Kubernetes 리소스를 새로고침하여 최신 정보를 가져 오려면 리소스를 마우스 오른쪽 버튼으로 클릭하고 새로고침을 선택합니다.

마우스 오른쪽 버튼 클릭으로 액세스할 수 있는 새로고침 메뉴를 사용하여 pod 새로고침

Kubernetes 탐색기의 새로고침 버튼을 사용하여 전체 탐색기를 강제로 새로고침 할 수 있습니다.

Kubernetes 탐색기의 새로고침 버튼

리소스 설명

클러스터가 아닌 리소스의 세부정보를 표시하려면 설명을 선택합니다. 그러면 Kubernetes 탐색기 콘솔 패널에 리소스 정보가 표시됩니다.

Kubernetes 탐색기 패널 안에서 적절한 리소스를 마우스 오른쪽 버튼으로 클릭하고 설명을 선택할 때 사용할 수 있는 설명 옵션

리소스를 클릭하여 리소스 세부정보를 볼 수도 있습니다. 메타데이터가 연결되어 있으면 Kubernetes 탐색기의 리소스 세부정보 패널에서 메타데이터를 사용할 수 있습니다.

Kubernetes 탐색기의 뒷부분에서 사용할 수 있는 리소스 세부정보 패널 내에서 리소스 메타데이터 보기

원격 YAML보기

Kubernetes 탐색기에서 바로 클러스터의 리소스 YAML을 볼 수 있습니다. Kubernetes 탐색기에서 pod 같은 리소스로 이동하고 리소스 이름을 마우스 오른쪽 버튼으로 클릭하여 원격 YAML 보기를 선택합니다.

그러면 새 편집기 탭에서 지정된 리소스에 해당하는 YAML 파일이 열립니다.

Kubernetes 탐색기에서 pod 라벨을 마우스 오른쪽 버튼으로 클릭하고 '원격 YAML 보기'를 선택하여 pod의 YAML보기

로그 스트리밍

pod, 컨테이너, 배포, 서비스, 복제본 세트의 경우 이러한 리소스의 로그를 Kubernetes 탐색기 콘솔로 스트리밍하고 확인하여 진행 상황을 모니터링할 수 있습니다.

마우스 오른쪽 버튼 클릭 메뉴를 사용하여 Kubernetes 탐색기 콘솔에 로그를 출력하는 pod의 스트리밍 로그

터미널 실행

pod 및 컨테이너의 경우 대화형 터미널을 열 수 있습니다.

포드의 오른쪽 클릭 메뉴를 사용하여 Kubernetes 탐색기 콘솔의 대화형 터미널에 액세스

리소스 관련 작업

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

클러스터

  • Google Kubernetes Engine 클러스터 추가: Kubernetes 탐색기 내에서 GKE 클러스터 추가를 클릭하여 기존 표준 클러스터나 Autopilot GKE 클러스터를 추가하거나 새로 만듭니다.

    그러면 사용할 프로젝트와 클러스터를 선택할 수 있는 GKE 클러스터 추가 대화상자가 표시됩니다. 새 클러스터를 만들고 이 대화상자로 돌아갈 수도 있습니다.

    완료되면 확인을 클릭하고 Kubernetes 탐색기를 통해 선택한 클러스터 및 해당 기본 리소스에 액세스합니다.

    프로젝트 및 클러스터 이름의 필드가 있는 Kubernetes 탐색기 대화상자가 포함된 GKE 클러스터 추가

  • 현재 컨텍스트로 설정: 구성된 kubectl 컨텍스트가 기본적으로 이 클러스터에 액세스할 수 있도록 지정된 클러스터를 활성으로 설정합니다.

    Kubernetes 탐색기에서 클러스터를 현재 컨텍스트로 설정

    이 작업이 성공하면 탐색기가 자동으로 새로고침되고 적절한 클러스터 옆에 Kubernetes 기호가 표시됩니다.

    또한 클러스터에 여러 컨텍스트가 구성되어 있으면 사용 가능한 컨텍스트 중 하나를 선택하여 현재 컨텍스트로 설정할 수 있습니다.

    Kubernetes 탐색기를 사용하여 여러 컨텍스트 목록에서 활성 클러스터 선택 및 설정

네임스페이스

  • 현재 컨텍스트로 설정: 구성된 kubectl 컨텍스트가 기본적으로 이 네임스페이스에 액세스할 수 있도록 네임스페이스를 활성으로 설정합니다.

    마우스 오른쪽 버튼 클릭 메뉴를 사용하여 네임스페이스를 현재로 설정

    이 작업이 성공하면 탐색기가 자동으로 새로고침되고 네임스페이스 옆에 별표가 표시되어 현재 컨텍스트의 일부임을 나타냅니다.

    Kubernetes 컨텍스트는 클러스터의 네임스페이스에 빠르게 액세스할 수 있는 단축키입니다. 일반적으로 minikube 또는 GKE 클러스터를 시작할 때 컨텍스트가 자동으로 생성됩니다. 지정된 네임스페이스에 현재 컨텍스트로 설정 옵션이 표시되지 않은 상태에서 관련 컨텍스트를 만들려면 kubectl config set-context 명령어를 사용하여 원하는 클러스터, 사용자, 네임스페이스로 컨텍스트를 설정합니다.

포드

  • 로그 스트림: pod에서 Kubernetes 탐색기 콘솔로 로그를 스트리밍합니다.
  • 터미널 가져오기: Kubernetes 탐색기 콘솔에서 pod의 터미널을 가져옵니다.

    또한 실행 중인 pod에는 라벨 옆에 색이 지정된 상태 표시가 있습니다.

    • 빨간색: pod가 실패 상태입니다.
    • 노란색: pod가 시작 또는 종료 중입니다.
    • 녹색: pod가 정상이고 실행 중입니다.

    pod 라벨 옆에 녹색 체크 표시가 보이면 pod 상태가 정상입니다.

컨테이너

배포

  • 로그 스트림: 배포에서 Kubernetes 탐색기 콘솔로 로그를 스트리밍합니다.

    라이브 배포에는 라벨 및 현재/총 복제본 수 옆에 색이 지정된 상태 표시가 있습니다.

    • 노란색: 배포에 최소 가용성이 없거나 이미지 문제가 있습니다.
    • 녹색: 배포가 정상이며 최소 가용성이 있습니다.

    배포 라벨 옆에 녹색 체크 표시가 보이면 배포 상태가 정상입니다.

노드

클러스터의 노드에는 이름 옆에 색이 지정된 상태 표시가 있습니다.

  • 노란색: 노드에 메모리 또는 디스크 가용성과 같은 리소스 문제가 있습니다.
  • 녹색: 노드가 정상입니다.

커스텀 리소스 정의(CRD)

Kubernetes 탐색기에는 클러스터에 설치되어 사용 가능한 모든 커스텀 리소스 정의(CRD)가 나열됩니다.

탐색기의 커스텀 리소스 정의 목록

지원 받기

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

Google Cloud Slack 커뮤니티에 속한 #cloud-code 채널에도 가입할 수 있습니다.