tencent-dev

Tencent Cloud dev 환경 (K8s)

사전 준비

1. Tencent Cloud CLI (tccli) 설치 및 인증

# macOS (Homebrew Python 환경에서는 pipx 또는 --break-system-packages 필요)
pipx install tccli
# 또는
pip3 install tccli --break-system-packages

# Linux
pip install tccli

tccli configure

프롬프트에 다음 정보를 입력합니다:

• SecretId: Tencent Cloud API SecretId
• SecretKey: Tencent Cloud API SecretKey
• Region: ap-seoul (또는 사용 중인 리전)
• Output: json

API 키는 Tencent Cloud 콘솔 → CAM → API Keys에서 생성합니다.

2. kubectl + kubeconfig 설정

TKE(Tencent Kubernetes Engine) 클러스터의 kubeconfig를 가져옵니다:

# 클러스터 목록 확인
tccli tke DescribeClusters --region ap-seoul

# kubeconfig 가져오기
tccli tke DescribeClusterKubeconfig \
  --region ap-seoul \
  --ClusterId cls-xxxxxxxx \
  --IsExtranet true

# 또는 Tencent Cloud 콘솔에서 kubeconfig 파일을 직접 다운로드:
# TKE 콘솔 → 클러스터 → 기본 정보 → Kubeconfig

kubeconfig 파일을 ~/.kube/config에 저장하거나 KUBECONFIG 환경변수로 지정합니다.

3. Helm 설치

# macOS
brew install helm

# 또는
curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

4. TCR (Tencent Container Registry) 인증

docker login xxx.tencentcloudcr.com -u <username>

kubectl create namespace deck-dev

# K8s에서 이미지 pull을 위한 Secret 생성
kubectl create secret docker-registry tcr-cred \
  -n deck-dev \
  --docker-server=xxx.tencentcloudcr.com \
  --docker-username=<username> \
  --docker-password=<password>

5. DB 시크릿 생성

kubectl create secret generic deck-db-credentials \
  -n deck-dev \
  --from-literal=password=<db-password>

배포

helm upgrade --install deck gitops/helm/deck \
  -f gitops/helm/examples/tencent-dev/values.yaml \
  -n deck-dev --create-namespace

이 예시는 values.yaml의 image.pullSecrets로 tcr-cred를 참조합니다.

리소스 확인

# Pod 상태
kubectl get pods -n deck-dev

# 서비스 상태
kubectl get svc -n deck-dev

# Ingress 상태
kubectl get ingress -n deck-dev

# 로그 확인
kubectl logs -n deck-dev -l app.kubernetes.io/name=app -f