alexellis/k3sup

어떤 프로젝트인가요?

핵심 기능

• 01SSH를 통해 명령 하나로 원격 Linux 호스트에 K3s를 설치합니다.
• 02kubeconfig를 로컬 컴퓨터로 가져오며, 지정한 컨텍스트 이름으로 기존 파일에 병합할 수 있습니다.
• 03추가 Linux 호스트를 K3s 에이전트로 클러스터에 참여시킵니다.
• 04내장 etcd 또는 외부 SQL 데이터스토어를 사용하는 HA 서버 구성을 지원합니다.
• 05현재 머신에 설치할 때 SSH 없이 로컬 모드로 실행할 수 있습니다.
• 06Linux, Windows, macOS용 정적 바이너리로 제공됩니다.

활용 사례

• 클라우드 VM에 단일 노드 또는 다중 노드 K3s 클러스터를 빠르게 구성합니다.
• Raspberry Pi 기기로 홈랩 Kubernetes 클러스터를 구축합니다.
• CI 작업이나 cloud-init 스크립트에서 K3s를 부트스트랩합니다.
• 여러 서버로 고가용성 K3s 컨트롤 플레인을 구성합니다.

빠른 시작

1. 1

   README의 공식 설치 스크립트로 k3sup 바이너리를 설치합니다

2. 2

   바이너리를 PATH에 배치합니다

   sudo install k3sup /usr/local/bin/
3. 3

   SSH 없이 로컬 머신에 K3s를 설치합니다

   k3sup install --local

사용 전 알아둘 점

• !클라우드 이미지에서 이미 허용하는 경우가 아니라면 대상 호스트에서 비밀번호 없이 sudo를 사용할 수 있어야 합니다.
• !K3sup Pro를 사용하려면 GitHub Sponsorship 또는 상용 라이선스가 필요하며 EULA가 적용됩니다.
• !메타데이터에는 명확한 라이선스가 표시되지 않습니다(NOASSERTION). 상업적으로 사용하기 전에 LICENSE 파일을 확인하세요.

토픽

자주 묻는 질문

k3sup은(는) 무엇인가요?

SSH를 통해 원격 또는 로컬 VM에 K3s Kubernetes를 설치하고 kubectl 접속용 kubeconfig를 가져오는 CLI 도구입니다. k3sup은 Linux 머신에 K3s Kubernetes 클러스터를 설치해 바로 사용할 수 있도록 해 주는 작은 Go CLI 유틸리티입니다. 자신의 컴퓨터에서 실행한 뒤 SSH로 접속할 수 있는 호스트를 지정하면 해당 호스트에 K3s를 설치하고, kubeconfig를 로컬 컴퓨터로 복사해 kubectl을 바로 사용할 수 있게 합니다. 추가 Linux 호스트를 K3s 에이전트로 클러스터에 참여시킬 수도 있으며, SSH를 사용하지 않는 로컬 설치 모드도 지원합니다.

k3sup은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

k3sup은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

k3sup은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. k3sup의 마지막 커밋은 2026년 9월 3일입니다.

k3sup은(는) 어디에 사용할 수 있나요?

클라우드 VM에 단일 노드 또는 다중 노드 K3s 클러스터를 빠르게 구성합니다. Raspberry Pi 기기로 홈랩 Kubernetes 클러스터를 구축합니다. CI 작업이나 cloud-init 스크립트에서 K3s를 부트스트랩합니다. 여러 서버로 고가용성 K3s 컨트롤 플레인을 구성합니다.

k3sup는 어떻게 설치하나요?

README의 공식 설치 스크립트로 k3sup 바이너리를 설치합니다 바이너리를 PATH에 배치합니다: sudo install k3sup /usr/local/bin/ SSH 없이 로컬 머신에 K3s를 설치합니다: k3sup install --local

k3sup은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/alexellis/k3sup