쿠버네티스

k3s helm-crd Helm Chart 기반의 애드온 자동 설치

ipxy 2025. 3. 26. 14:26
728x90

 

✅ 1. "k3s에 Helm이 내장돼 있다"는 의미?

✔️ k3s는 Helm CLI를 내장하지 않습니다.

  • helm 명령어는 별도로 설치해야 합니다 (로컬에 Helm CLI 필요).

✔️ 하지만 k3s는 다음을 지원합니다:

  • Helm Chart 기반의 애드온 자동 설치
  • /var/lib/rancher/k3s/server/manifests/ 디렉토리에 YAML/Helm 파일 넣으면 자동으로 배포

✅ 2. k3s의 내장 애드온 설치 방식 (Helm 지원)

k3s는 설치 후 다음 경로에 있는 모든 YAML 또는 Helm 관련 .yaml 파일을 자동으로 배포합니다:

/var/lib/rancher/k3s/server/manifests/

여기에 HelmChart 리소스를 넣으면, Helm Chart가 자동 배포됩니다.


📄 예: HelmChart CR로 Traefik 설치 제어

# /var/lib/rancher/k3s/server/manifests/my-nginx-helmchart.yaml
apiVersion: helm.cattle.io/v1
kind: HelmChart
metadata:
  name: my-nginx
  namespace: kube-system
spec:
  chart: bitnami/nginx
  repo: https://charts.bitnami.com/bitnami
  targetNamespace: default
  version: 15.5.2
  set:
    service.type: "LoadBalancer"
    replicaCount: 2

저장하면, k3s는 이를 감지하고 자동으로 Helm Chart를 설치합니다. 🎉


✅ 3. 추가적으로 알아두면 좋은 CRD

  • HelmChart: Helm 차트를 배포할 수 있는 Custom Resource
  • HelmChartConfig: 차트 값이나 설정을 따로 분리해서 관리

✅ 사용 예시 요약

 

Helm CLI 사용 helm install 등 로컬에 Helm 설치 후 직접 명령어 실행
자동 배포 HelmChart CR 작성 후 /var/lib/rancher/k3s/server/manifests/에 배치

 

Helm CLI k3s에 내장되어 있지 않음, 직접 설치해야 함
HelmChart CR k3s에서 지원, Helm 차트를 자동으로 배포할 수 있음
/manifests 디렉토리 여기에 넣으면 자동 배포됨 (YAML, HelmChart 다 가능)

 

728x90