FEATURE: Add zk deploy command

[f1v3-dev]

🔗 Related Issue

⌨️ What I did

arcusctl zk deploy <version> <topology.yml > 명령어를 구현했습니다.

동작 흐름

1. topology.yml 파싱 및 검증
2. 동일 이름의 ZK Ensemble 존재 확인
3. 실행 계획 출력 및 사용자 확인
4. 로컬 디렉토리(~/.arcusctl/images/zookeeper)에서 ZK tar 파일 확인, 없으면 wget으로 다운로드
5. 각 노드에 SSH/SCP로 tar 전송 → 압축 해제 → 설정 파일 생성 → ZK 시작
6. 클러스터 quorum 형성 확인
7. 메타데이터(~/.arcusctl/clusters/zk/<name>/) 저장

에러 처리

• 설계 문서에 따라 "실패 시 롤백 없음"으로 처리하고 수동 복구 안내 메시지 출력 후 종료

관련 파일

• internal/zk/deploy.go: 전체 배포 흐름
• internal/zk/validate.go: topology 검증
• internal/zk/config.go: zoo.cfg / zoo.cfg.dynamic 생성
• internal/zk/download.go: ZK tar.gz 다운로드
• internal/zk/install.go: 노드별 설치
• internal/zk/znode.go: ZK 연결 문자열 생성

참고

• ZNode 생성은 cluster(community / enterprise) deploy 시점에 처리할 예정이므로 zk deploy에서는 제외

[namsic]

zoo.cfg파일에 이 속성 명시하지 않아도 ZK 서버 구동에 문제 없나요?
(내부적으로 어떠한 default 값을 사용하게 되나요?)

mergeConfig 이후 (또는 mergeConfig 내부에서) cfg 각 값에 대한 validation이 필요해 보입니다.
필수 속성이 명시되지 않은 경우 default 값을 채워 넣거나, 에러 발생시키는 것이 좋겠습니다.

그리고 나서, 실제 설정 파일을 구성할 때는 별도의 value 확인 없이 그대로 쓰면 됩니다.

[f1v3-dev]

zoo.cfg 파일에 명시하지 않았을 때 문제가 되는 옵션들이 존재합니다.

옵션 설명

옵션	내부 기본값	설명
clientPort	없음	명시 필수, 미지정 시 시작 실패
dataDir	없음	명시 필수, 미지정 시 시작 실패
tickTime	3000ms	미지정해도 시작 됨
initLimit	없음	클러스터 모드에서 미지정 시 quorum 형성 실패
syncLimit	없음	클러스터 모드에서 미지정 시 follower 동기화 실패
dataLogDir	dataDir로 사용됨	별도 설정 권장

클러스터 모드를 강제하고 있어 위 옵션을 minimum configuration으로 확인했고, 다음과 같이 처리하려고 합니다.

• clientPort: address에서 자동 추출 (현재 구현)
• dataDir, initLimit, syncLimit: 필수 값으로 검증 (미지정 시 에러)
• tickTime, dataLogDir: 선택 (ZK 기본값 사용)

추가로 검증해야 할 옵션이 있을까요?

[namsic]

path 관련 설정의 경우 사용자가 필수로 입력하도록 해도 문제 없을 것 같은데,
initLimit, syncLimit 같은 설정은 사용자가 어떤 값을 사용해야 할지 알기 어려울 것입니다.
필수로 입력하도록 하되 별도로 가이드 문서를 제공하거나, 미입력 시 arcusctl 수준에서 기본값을 정의하는 것이 좋겠습니다.

참고사항으로, 현재 사용 중인 전체 설정은 아래와 같습니다.

https://github.com/naver/arcus-zookeeper/blob/arcus-3.5.9/conf/zoo_sample.cfg

[f1v3-dev]

아래와 같이 zk-sample-topology.yml 파일을 만들어서 프로젝트에서 관리하는 형태로 제공해도 좋을 것 같습니다.

zk-sample-topology.yml example

# For more configuration options, see:
# https://zookeeper.apache.org/doc/r3.5.9/zookeeperAdmin.html#sc_configuration

name: my-ensemble                                # required
path: /home/arcus/zookeeper                      # required

servers:
  - myid: 1                                      # required
    address: zk1:2181:2888:3888                  # required (host:clientPort:quorumPort:electionPort)
    config:                                      # optional - per-node override
      data_log_dir: /data/zk1-txlog

  - myid: 2
    address: zk2:2181:2888:3888

  - myid: 3
    address: zk3:2181:2888:3888

global_config:
  # optional (default: 2000)
  tick_time: 2000

  # optional (default: 10) - ticks for follower to sync to leader
  init_limit: 10

  # optional (default: 5) - ticks between request and ack
  sync_limit: 5

  # required
  data_dir: /var/lib/zk/data

  # optional (default: data_dir) - dedicated disk recommended
  data_log_dir: /var/lib/zk/datalog

  # optional - other ZK options (string values only)
  properties:
    maxClientCnxns: "60"
    autopurge.snapRetainCount: "10"
    autopurge.purgeInterval: "24"

위 예시 파일 기준에 맞춰 코드 구성(필수 및 기본 값 처리)을 변경하겠습니다.

[f1v3-dev]

동작 흐름 정리

Deploy(version, topologyPath)
│
├── prepare(topologyPath)
│   ├── topology.LoadZK()         // YAML 파싱
│   ├── mergeConfig() x N         // 서버별 global+server config merge → topology에 저장
│   ├── validate()                // 중복 myid/address, dataDir 공백 체크
│   └── store.ZKExists()          // 이미 배포된 앙상블인지 확인
│
├── printPlan()                   // 배포 계획 출력
├── confirm()                     // y/N 입력
│
├── ensureDownloaded(version)     // 로컬에 tar.gz 없으면 wget
│
├── installAll()
│   └── installNode() x N         // 각 서버에 scp + SSH로 ZK 설치/기동
│       └── 실패 시 → printRecoveryGuide() 후 중단
│
├── waitForQuorum()               // ZK 앙상블 구성 확인 (최대 30초)
│
└── store.SaveZK()                // ~/.arcusctl에 meta.yml, topology.yml 저장