Command-line option enhancement

[itnpeople]

사용성 문제점

• yaml/json 포멧 제공되나 EOF, 파일패스, URL을 통한 값 지정 방법을 지원하지 않음
• 클러스터 생성, 노드 추가 시 --cluster 옵션만을 지원, 클러스터 생성, 노드 추가 명령에서 json, yaml 포멧으로만 실행 가능
• mandatory 옵션(--config, --ns)을 명령줄에 항상 기입하는 문제
• git clone 빌드를 통해 cli 사용
• 클러스터의 Kubeconfig 를 클러스터 정보 조회 후 북사 붙여넣는 수동 방식만 가능

개선내용

--config 옵션

• Not required.
• 기본 config 파일 운용 ${HOME}/.cbaadm
• 없을 경우 config 파일 자동생성
• 환경변수 지정 기능

--ns 옵션

• 환경변수 지정 기능
• config 구조에 ns 속성 추가 가능 여부 검토 후 결과에 따라 구현

subcommand 구조변경

• subcommand 대상 object(cluster,node)에서 action (create, delete, get) 으로 변경, 아래 예 참조

# cbadm cluster
$ cbadm create cluster ....
$ cbadm get cluster
$ cbadm get cluster  cb-cluster
$ cbadm delete cluster cb-cluster

# node
$ cbadm create node --cluster cb-cluster ....
$ cbadm get node --cluster cb-cluster
$ cbadm get node c-1-qv9mn --cluster cb-cluster
$ cbadm delete node c-1-qv9mn --cluster cb-cluster

create 명령

• cluster 생성

$ cbadm create cluster  \
  --name [ClusterName]\
  --control-plane-connection=[ControlPlane ConnctionInfo.Name]\
  --control-plane-count=[ControlPlane Count]\
  --control-plane-spec=[ControlPlane Machine Spec]\
  --worker-connection=[WorkerNode ConnctionInfo.Name]\
  --worker-count=[WorkerNode Count]\
  --worker-spec=[WorkerNode Machine Spec]

# example
$ cbadm create cluster  \
  --name "cb-cluster"\
  --control-plane-connection="config-aws-tokyo"\
  --control-plane-count="1"\
  --control-plane-spec="t2.medium"\
  --worker-connection="config-aws-tokyo"\
  --worker-count="1"\
  --worker-spec="t2.medium"

• 노드 생성

$ cbadm create node \
 --cluster [ClusterName]\
 --worker-connection=[WorkerNode ConnctionInfo.Name]\
 --worker-count=[WorkerNode Count]\
 --worker-spec=[WorkerNode Machine Spec]

# example
$ cbadm create node \
 --cluster "cb-cluster"\
 --worker-connection="config-aws-tokyo"\
 --worker-count="1"\
 --worker-spec="t2.medium"

get 명령

• cluster 목록 조회

$ cbadm get cluster

• cluster 조회

$ cbadm get cluster [ClusterName]

• node 목록 조회

  $ cbadm get node --cluster [ClusterName]

• node 조회

  $ cbadm get node [NodeName] --cluster [ClusterName]

delete 명령

• cluster 삭제

$ cbadm delete cluster [ClusterName]

• node 삭제

$ cbadm delete node [NodeName] --cluster [ClusterName]

create 명령에서 EOF, 파일패스, URL 형식 지원

$ cbadm create node --cluster cb-cluster -f - <<EOF
worker: 
  - connection: config-aws-tokyo
    count: 1
    spec: t2.medium
EOF

$ cbadm create node --cluster cb-cluster -f examples/yaml/create-cluster.yaml 

$ cbadm create node --cluster cb-cluster -f http://examples.com/examples/yaml/create-cluster.yaml 

update-kubeconfig 명령

• 해당 클러스터의 kubeconfig를 로컬 kubeconfig 에 반영

$ cbadm update-kubeconfig [ClusterName]

config 명령

• 보기 기능만 제공

$ cbadm config view

빌드

• 빌드 시 CLI 컴파일 및 릴리즈 첨부파일로 자동 추가 여부 검토 및 반영

문서

• 개선 내용 반영
• 문서 보강 (user, developer 구분 정리 )
• 위키 & README (markdown)

기타이슈

• config 수정 기능은 config 파일 구조 개선이 선행되어야 할 것으로 판단.
• grpc ?