클러스터 템플릿

AerospikeClusterTemplate을 사용하면 Aerospike 클러스터를 위한 재사용 가능한 설정 프로필을 정의할 수 있습니다. 모든 클러스터에 동일한 스케줄링, 스토리지, Aerospike 설정을 반복하는 대신, 템플릿에 한 번 정의하고 여러 클러스터에서 참조할 수 있습니다.

---

템플릿 사용 시기

• 다중 환경 — 서로 다른 리소스 크기와 anti-affinity 수준을 가진 dev/stage/prod 템플릿을 정의
• 조직 기본값 — 팀 간에 스토리지 클래스, 톨러레이션, heartbeat 설정을 통일
• 설정 표준화 — 공유 설정을 한 곳에 유지하여 설정 드리프트를 방지

---

템플릿 생성

템플릿은 이제 기존의 스케줄링, 스토리지, Aerospike 설정 필드 외에도 컨테이너 image, 클러스터 size, monitoring 사이드카, network policy를 기본값으로 제공할 수 있습니다.

apiVersion: acko.io/v1alpha1
kind: AerospikeClusterTemplate
metadata:
  name: hard-rack
  # AerospikeClusterTemplate은 클러스터 스코프 리소스입니다 (namespace 불필요)
spec:
  # 모든 hard-rack 클러스터에 걸쳐 Aerospike 이미지와 기본 클러스터 크기를 표준화
  image: aerospike:ce-8.1.1.1
  size: 6

  # 기본적으로 Prometheus 모니터링 사이드카를 활성화
  monitoring:
    enabled: true
    port: 9145
    resources:
      requests:
        cpu: 50m
        memory: 64Mi
      limits:
        cpu: 200m
        memory: 128Mi
    serviceMonitor:
      enabled: true
      interval: 30s

  # 기본 네트워크 접근 정책
  aerospikeNetworkPolicy:
    accessType: pod
    alternateAccessType: pod
    fabricType: pod

  scheduling:
    podAntiAffinityLevel: required   # 노드당 하나의 Aerospike pod
    tolerations:
      - key: "aerospike"
        operator: "Exists"
        effect: "NoSchedule"

  storage:
    storageClassName: local-path
    localPVRequired: true
    resources:
      requests:
        storage: 100Gi

  resources:
    requests:
      cpu: "2"
      memory: "4Gi"
    limits:
      cpu: "2"
      memory: "4Gi"

  aerospikeConfig:
    service:
      proto-fd-max: 15000
    namespaceDefaults:
      replication-factor: 2
      data-size: 2147483648   # 2 GiB

kubectl apply -f config/samples/acko_v1alpha1_template_prod.yaml   # hard-rack

---

클러스터에서 템플릿 참조

템플릿이 image와 size를 제공하는 경우, 클러스터에서 해당 필드를 완전히 생략할 수 있습니다:

apiVersion: acko.io/v1alpha1
kind: AerospikeCluster
metadata:
  name: hard-rack-cluster
spec:
  # image와 size는 "hard-rack" 템플릿에서 제공됨 (image: aerospike:ce-8.1.1.1, size: 6)
  templateRef:
    name: hard-rack

  aerospikeConfig:
    namespaces:
      - name: data
        storage-engine:
          type: memory

클러스터에서 spec.image 또는 spec.size를 명시적으로 설정하여 템플릿을 오버라이드할 수도 있습니다:

spec:
  image: aerospike:ce-8.1.1.1   # 오버라이드: 특정 이미지를 고정
  size: 3                         # 오버라이드: 템플릿의 6 대신 3개 노드 사용
  templateRef:
    name: hard-rack

오퍼레이터는 생성 시 템플릿을 해석하고 spec을 status.templateSnapshot에 저장합니다. 그 시점부터 클러스터는 독립적으로 운영됩니다 — 템플릿 변경 사항은 이 클러스터에 자동으로 영향을 미치지 않습니다.

---

템플릿 필드 오버라이드

새 템플릿을 만들지 않고 특정 필드를 변경하려면 spec.overrides를 사용합니다:

spec:
  templateRef:
    name: hard-rack
  overrides:
    resources:
      requests:
        cpu: "4"
        memory: "8Gi"
      limits:
        cpu: "4"
        memory: "8Gi"
    scheduling:
      podAntiAffinityLevel: preferred   # 이 클러스터에 대해 anti-affinity를 완화

병합 우선순위: overrides > template.spec > 오퍼레이터 기본값

맵(예: aerospikeConfig.service)의 경우 병합은 재귀적으로 수행됩니다 — 지정된 키만 오버라이드됩니다. 배열(예: tolerations)과 스칼라 필드의 경우, 오버라이드가 템플릿 값을 완전히 대체합니다.

---

템플릿 업데이트 후 재동기화

템플릿을 업데이트한 후, 기존 클러스터는 status.templateSnapshot.synced: false를 표시하고 TemplateDrifted 경고 이벤트를 발행합니다. 클러스터는 스냅샷을 기반으로 계속 운영됩니다.

업데이트된 템플릿을 클러스터에 적용하려면:

kubectl annotate aerospikecluster hard-rack-cluster acko.io/resync-template=true

오퍼레이터가 수행하는 작업:

1. 템플릿을 다시 가져옴
2. status.templateSnapshot을 업데이트
3. TemplateApplied 이벤트를 발행
4. 어노테이션을 제거

---

템플릿 스냅샷 상태 확인

kubectl get aerospikecluster hard-rack-cluster -o jsonpath='{.status.templateSnapshot}'

출력 예시:

{
  "name": "hard-rack",
  "resourceVersion": "12345",
  "snapshotTimestamp": "2026-03-01T10:00:00Z",
  "synced": true
}

---

샘플 템플릿

config/samples/ 디렉토리에 세 가지 티어의 기본 템플릿이 포함되어 있습니다:

	minimal	soft-rack	hard-rack
용도	개발 / 빠른 시작	스테이징	프로덕션
size	1	3 (상속)	6
anti-affinity	none	preferred	required
storage	standard 1Gi	standard 10Gi	local-path 100Gi
rack 보장	없음	soft (동일 노드 허용)	hard (노드당 1 rack)
resources	100m/256Mi	500m/1Gi	2/4Gi (Guaranteed QoS)
monitoring	disabled	disabled	enabled
RF	1	2	2

파일:

• acko_v1alpha1_template_dev.yaml — minimal
• acko_v1alpha1_template_stage.yaml — soft-rack
• acko_v1alpha1_template_prod.yaml — hard-rack
• aerospike-cluster-with-template.yaml — 템플릿을 사용하는 예제 클러스터

kubectl apply -f config/samples/acko_v1alpha1_template_prod.yaml   # hard-rack
kubectl apply -f config/samples/aerospike-cluster-with-template.yaml

---

Helm으로 설치

defaultTemplates.enabled=true 옵션을 사용하면 릴리스 네임스페이스에 세 가지 티어 템플릿이 자동으로 생성됩니다:

helm install aerospike-ce-kubernetes-operator oci://ghcr.io/kimsoungryoul/charts/aerospike-ce-kubernetes-operator \
  -n aerospike-operator --create-namespace \
  --set certManagerSubchart.enabled=true \
  --set defaultTemplates.enabled=true

템플릿이 생성되었는지 확인:

kubectl get aerospikeclustertemplate
# NAME         AGE
# minimal      10s
# soft-rack    10s
# hard-rack    10s

클러스터에서 템플릿 참조:

apiVersion: acko.io/v1alpha1
kind: AerospikeCluster
metadata:
  name: my-cluster
spec:
  templateRef:
    name: soft-rack
  aerospikeConfig:
    namespaces:
      - name: data
        storage-engine:
          type: memory