220 words
1 minute
[Kubernetes]configure k3s for local kubectl
2025-01-30

Overview#

리모트 서버에 있는 k3s 구성 파일을 local kubectl에 등록하는 법

절차#

1. 리모트 서버에서 k3s 구성 파일 위치 확인

  • k3s의 기본 구성 파일은 /etc/rancher/k3s/k3s.yaml에 위치
  1. 구성 파일을 로컬 시스템으로 복사

    Terminal window
    scp username@remote_server:/etc/rancher/k3s/k3s.yaml ~/.kube/config
    • 만약 이미 kubectl 구성이 있다면, 새 파일로 저장하고 나중에 병합
    Terminal window
    scp username@remote_server:/etc/rancher/k3s/k3s.yaml ~/.kube/k3s-config
  2. 구성 파일에서 서버 주소 수정

    • k3s.yaml 파일 내의 서버 주소를 실제 리모트 서버의 IP나 호스트명으로 변경해야 합니다
    Terminal window
    sed -i 's/127.0.0.1/your_server_ip/g' ~/.kube/k3s-config
  3. 환경 변수 설정 또는 구성 병합

    • 새 구성 파일을 사용하려면:
    Terminal window
    export KUBECONFIG=~/.kube/k3s-config
    • 또는 기존 config와 병합하려면:
    Terminal window
    KUBECONFIG=~/.kube/config:~/.kube/k3s-config kubectl config view --flatten > ~/.kube/merged-config
    mv ~/.kube/merged-config ~/.kube/config
  4. 권한 문제 방지를 위해 파일 권한 조정

    Terminal window
    chmod 600 ~/.kube/config
  5. 연결 테스트

    Terminal window
    kubectl get nodes

Reference#

[Kubernetes]configure k3s for local kubectl
https://yjinheon.netlify.app/posts/05system/k8s/k8s_k3s_configure/
Author
Datamind
Published at
2025-01-30
License
CC BY-NC-SA 4.0