소식 및 공지 사항

릴리스 노트

제품 릴리스 기록

제품 소개

제품 장점

제품 아키텍처

시나리오

제품 기능

리전 및 가용존

빠른 시작

신규 사용자 가이드

표준 클러스터를 빠르게 생성

Demo

클라우드에서 컨테이너화된 애플리케이션 배포 Check List

TKE 표준 클러스터 가이드

Tencent Kubernetes Engine(TKE)

클러스터 관리

네트워크 관리

스토리지 관리

Worker 노드 소개

Kubernetes Object Management

워크로드

클라우드 네이티브 서비스 가이드

Tencent Managed Service for Prometheus

TKE Serverless 클러스터 가이드

TKE 클러스터 등록 가이드

실습 튜토리얼

Serverless 클러스터

네트워크

로그

모니터링

유지보수

DevOps

탄력적 스케일링

자주 묻는 질문

클러스터

TKE Serverless 클러스터

유지보수

서비스

이미지 레지스트리

원격 터미널

클러스터에 연결

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-09-28 19:42:31

작업 시나리오
Kubernetes 명령 라인 도구인 kubectl을 사용하여 로컬 클라이언트에서 TKE 클러스터에 연결할 수 있습니다. 본 문서에서는 클러스터 연결 방법을 설명합니다.
참고
보안 및 컴플라이언스 요구 사항을 충족하고 TKE 클러스터의 액세스 보안 및 안정성을 개선하기 위해, TKE는 2022년 8월 10일(UTC +8)부터 도메인 이름 cls-xxx.ccs.tencent-cloud.com을 공식적으로 중단합니다. 
매끄럽고 원활한 마이그레이션과 사용 경험을 보장하기 위해, TKE는 2022년 7월 20일(UTC +8)에 클러스터 액세스를 업그레이드합니다. 업그레이드 후 클러스터에 대한 공중망/사설망 액세스를 활성화하면 새 아키텍처가 사용됩니다. 기존 클러스터의 경우 마이그레이션이 필요합니다. 도메인이 삭제된 후에는 정상적으로 클러스터에 액세스할 수 없으므로, 7월 20일부터 8월 10일(UTC +8)까지 클러스터 액세스를 다시 활성화하여 새 아키텍처로 마이그레이션 하십시오. 자세한 내용은 클러스터 액세스 활성화 및 Kubeconfig 가져오기를 참고하십시오.
이전 아키텍처와 새 아키텍처의 차이점은 다음과 같습니다. 클러스터 액세스 API는 새 아키텍처와 호환됩니다. API를 호출하여 새 아키텍처로 마이그레이션할 수 있습니다. API를 호출하실 계획이라면 07월 20일(UTC +8) 이전에 조정하십시오.
1. 새 아키텍처에서는 공중망 레졸루션 기능을 사용할 수 없습니다. 보안 서명이 제공되는 도메인 이름을 전달할 수 있습니다. 액세스 보안을 보장하기 위해, 공중망 레졸루션를 직접 구성해야 합니다.
2. 새 아키텍처에서 공중망 액세스를 활성화할 때 보안 그룹을 설정하여 액세스 제어 정책을 구성해야 합니다.
3. 새로운 아키텍처에서 공중망 액세스를 활성화하면 계정에 공중망 CLB가 생성됩니다. 공중망 CLB 과금 항목은 IP별 청구 계정 과금 안내를 참고하십시오.
솔루션1: Cloud Shell을 통해 클러스터 연결
TKE는 Tencent Cloud Cloud Shell을 통합하여 Tencent Cloud 콘솔에서 클러스터 원클릭 연결 기능을 구현하고, kubectl을 통해 클러스터에서 효율적인 작업을 구현할 수 있습니다.
작업 단계
1단계: 클러스터 공중망 액세스 활성화
1. TKE 콘솔에 로그인하고 왼쪽 사이드바에서 Cluster를 선택합니다.
2. 클러스터 관리 페이지에서 클러스터가 위치한 리전을 선택하고, 대상 클러스터의 ID를 클릭하여 클러스터 세부 정보 페이지로 이동합니다.
3. 클러스터 기본 정보페이지에서 클러스터 액세스가 활성화되었는지 확인합니다.
﻿
4. 
﻿
을(를) 클릭하여 공중망 액세스를 활성화합니다. 공중망 액세스를 활성화하려면 관련 매개변수를 구성해야 합니다.
﻿
보안 그룹: 공중망 CLB는 공중망 액세스가 활성화된 후 자동으로 할당됩니다. 보안 그룹을 통해 액세스 제어 정책을 구성할 수 있습니다. 액세스를 제어하기 위해 보안 그룹을 공중망 CLB에 바인딩합니다.
ISP 유형, 네트워크 과금 방식, 대역폭 최댓값: 실제 필요에 따라 이러한 CLB 관련 매개변수를 설정합니다. 자세한 내용은 CLB 인스턴스 생성을 참고하십시오.
액세스 유형: 공중망 도메인 이름을 선택하면 보안 서명이 제공될 사용자 지정 도메인 이름을 전달해야 하며, 공중망 레졸루션을 직접 구성해야 합니다. CLB 기본 도메인 이름을 선택하면 레졸루션 등 작업을 수동으로 구성할 필요가 없습니다.
5. 다음과 같이 공중망 액세스가 활성화되었는지 확인합니다.
﻿
2단계: Cloud Shell을 사용하여 클러스터에 연결
1. TKE 콘솔에 로그인하고 왼쪽 사이드바에서 Cluster를 선택합니다.
2. 클러스터 관리 페이지에서 클러스터가 위치한 리전을 선택하고, 다음과 같이 대상 클러스터 오른쪽의 더보기 > 클러스터 연결을 클릭합니다. 
﻿
3. 콘솔 하단에 Cloud Shell이 나타납니다. 명령 창에 kubectl 명령을 직접 입력할 수 있습니다.
솔루션2: 로컬 컴퓨터를 통해 클러스터 연결
전제 조건
curl을 설치하십시오.
작업 단계
1단계: Kubectl 툴 설치
1. ﻿Installing and Setting up kubectl의 지침에 따라 Kubectl을 설치합니다. OS 유형에 따라 Kubectl을 가져오는 적절한 방법을 선택할 수 있습니다.
참고
kubectl을 이미 설치했다면 이 단계를 건너뛰십시오.
명령 라인의 ‘v1.18.4’를 실제 필요에 따라 애플리케이션에 필요한 Kubectl 버전으로 바꿉니다. 클라이언트의 Kubectl 버전은 서비스측의 Kubernetes 최신 버전과 일치해야 합니다. 기본 정보 페이지의 ‘클러스터 정보’ 섹션에서 Kubernetes 버전을 확인할 수 있습니다.
Mac OS X
Linux
Windows
다음 명령을 실행하여 Kubectl을 가져옵니다.
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.4/bin/darwin/amd64/kubectl
다음 명령을 실행하여 Kubectl을 가져옵니다.
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.4/bin/linux/amd64/kubectl
다음 명령을 실행하여 Kubectl을 가져옵니다.
curl -LO https://storage.googleapis.com/kubernetes-release/release/v1.18.4/bin/windows/amd64/kubectl.exe
2. 여기서는 Linux를 예로 들어 설명합니다. 다음 명령을 실행하여 kubectl 사용 권한을 부여합니다.
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
3. 다음 명령어를 실행하여 설치 결과를 확인합니다.
kubectl version
반환된 버전 정보가 다음과 유사하면 설치가 완료된 것입니다.
Client Version: version.Info{Major:"1", Minor:"5", GitVersion:"v1.5.2", GitCommit:"08e099554f3c31f6e6f07b448ab3ed78d0520507", GitTreeState:"clean", BuildDate:"2017-01-12T04:57:25Z", GoVersion:"go1.7.4", Compiler:"gc", Platform:"linux/amd64"}
2단계: 클러스터 액세스 활성화
1. TKE 콘솔에 로그인하고 왼쪽 사이드바에서 Cluster를 선택합니다.
2. ‘클러스터 관리’ 페이지에서 클러스터가 위치한 리전을 선택하고, 대상 클러스터 ID/이름을 클릭하여 클러스터 세부 정보 페이지로 이동합니다.
3. 클러스터 기본 정보 페이지에서 클러스터 액세스가 활성화되었는지 확인합니다.
﻿
공중망 액세스 활성화
사설망 액세스 활성화
공중망 액세스를 활성화하려면 다음과 같이 관련 매개변수를 구성해야 합니다.
﻿
보안 그룹: 공중망 CLB는 공중망 액세스가 활성화된 후 자동으로 할당됩니다. 보안 그룹을 통해 액세스 제어 정책을 구성할 수 있습니다. 액세스를 제어하기 위해 보안 그룹을 공중망 CLB에 바인딩합니다.
ISP 유형, 네트워크 과금 방식, 대역폭 최댓값: 실제 필요에 따라 이러한 CLB 관련 매개변수를 설정합니다. 자세한 내용은 CLB 인스턴스 생성을 참고하십시오.
액세스 유형: 공중망 도메인 이름을 선택하면 보안 서명이 제공될 사용자 지정 도메인 이름을 전달해야 하며, 공중망 레졸루션을 직접 구성해야 합니다. CLB 기본 도메인 이름을 선택하면 레졸루션 등 작업을 수동으로 구성할 필요가 없습니다.
사설망 액세스를 활성화하려면 다음과 같이 관련 매개변수를 구성해야 합니다.
﻿
서브넷: 이 옵션은 기본적으로 비활성화되어 있습니다. 활성화하려면 서브넷을 설정해야 합니다. 사설망 액세스가 성공적으로 활성화되면 설정된 서브넷에서 IP 주소가 할당됩니다.
액세스 유형: 사설망 도메인 이름을 선택하면 보안 서명이 제공될 사용자 지정 도메인 이름을 전달해야 하며, 사설망 레졸루션을 직접 구성해야 합니다. 사설망 IP를 선택하면 사설망 IP이 할당되고 보안 서명이 제공됩니다.
Kubernetes의 service IP 주소 사용: 클러스터 세부 정보 페이지의 왼쪽 사이드바에서 서비스 및 라우팅 > Service를 선택하여 default 네임스페이스에서 Kubernetes의 service IP 주소를 가져옵니다. Kubeconfig 파일의 clusters.cluster.server 필드를 https://<IP>:443으로 교체합니다. 참고: Kubernetes service는 ClusterIP 모드에 있으며 클러스터 내 액세스에만 적용됩니다.
3단계: KubeConfig 가져오기
TKE는 공중망 액세스와 사설망 액세스에 각각 사용할 수 있는 두 가지 유형의 KubeConfig를 제공합니다. 클러스터 액세스가 활성화되면 아래 단계에 따라 해당 Kubeconfig를 가져올 수 있습니다.
1. 클러스터 세부 정보 > 기본 정보 페이지에서 ‘클러스터 APIServer 정보’를 확인합니다.
2. 해당 액세스 유형에 Kubeconfig를 복사 또는 다운로드하거나, 공중망 액세스를 위한 보안 그룹, 액세스 도메인 이름(액세스 활성화 시 구성) 및 액세스 IP를 확인합니다.
 
﻿
﻿
4단계: KubeConfig 구성 및 Kubernetes 클러스터 액세스
1. 필요에 따라 클러스터 자격 증명을 구성합니다.
설정하기 전에 클러스터에 대한 액세스 자격 증명이 현재 클라이언트에 설정되었는지 확인합니다.
No인 경우 ~/.kube/config 파일이 비어 있어 획득한 Kubeconfig 액세스 자격 증명을 파일에 복사할 수 있습니다. ~/.kube/config 파일이 클라이언트에 없으면 새로 생성합니다.
Yes인 경우 획득한 Kubeconfig를 지정된 위치에 다운로드하고 다음 명령을 순서대로 실행하여 여러 클러스터의 config 파일을 병합할 수 있습니다.
KUBECONFIG=~/.kube/config:~/Downloads/cls-3jju4zdc-config kubectl config view --merge --flatten > ~/.kube/config
export KUBECONFIG=~/.kube/config
위 명령어에서 ~/Downloads/cls-3jju4zdc-config는 현재 클러스터의 kubeconfig 파일 경로를 나타냅니다. 이 경로를 다운로드한 파일의 실제 로컬 경로로 바꿉니다.
2. Kubeconfig를 구성한 후, 다음 명령을 순서대로 실행하여 context를 보고 컨텍스트를 전환하여 클러스터에 액세스합니다.
kubectl config get-contexts
kubectl config use-context cls-3jju4zdc-context-default
3. 다음 명령어를 실행하여 클러스터에 액세스할 수 있는지 확인합니다.
kubectl get node
클러스터에 연결할 수 없는 경우 공중망 액세스 또는 사설망 액세스가 활성화되어 있는지 확인하고 액세스 클라이언트가 지정된 네트워크 환경에 있는지 확인합니다.
관련 설명
Kubectl 명령 라인 소개
Kubectl은 Kubernetes 클러스터에서 작업을 수행하기 위한 명령 라인 도구입니다. 이 문서에서는 kubectl 구문, 일반적인 명령 작업 및 몇 가지 예를 다룹니다. 각 명령(모든 기본 명령 및 서브 명령 포함)에 대한 자세한 내용은 kubectl reference document를 참고하거나 kubectl help 명령을 실행하여 도움말 정보를 확인하십시오.