스토리지 서버 설치 여부 및 관련 속성을 정의합니다.

CUBE는 스토리지 서버로 NFS(Network File System)를 설치합니다.

[shared-storage]

install

NFS 설치를 활성화 합니다.

• Type : boolean

• Default : false

• Since : v1.0.0

storage-ip

NFS IP 주소입니다.

설치할 때 사용되는 필수 입력 항목입니다.

• Type : string

• Default : ""

• Since : v1.0.0

private-ip

NFS IP 주소입니다.

설치할 때 사용되는 필수 입력 항목입니다.

shared-storage.storage-ip 과 동일한 IP 주소를 사용하는 경우 건너뛸 수 있습니다.

• Type : string

• Default : ""

• Since : v1.0.0

volume-dir

NFS 데이터 디렉토리입니다.

설치할 때 사용되는 필수 입력 항목입니다.

• Type : string

• Default : "/data/storage"

• Since : v1.0.0

쿠버네티스 노드 관련 속성을 정의합니다.

[node-pool]

노드들의 공통 속성들을 정의합니다.

data-dir

노드별 backup, podman, log, kubelet, etcd, container 데이터 디렉터리입니다.

• Type : string

• Default : /data

• Since : v1.0.0

ssh-port

설치 시 노드에 접속 할 SSH 포트 번호입니다.

• Type : integer

• Default : 22

• Since : v1.0.0

[node-pool.master]

컨트롤 플레인 노드 속성을 정의합니다.

ip

컨트롤 플레인 노드들의 SSH 접속 IP 주소들 입니다.

• Type : []string

• Default : []

• Since : v1.0.0

private-ip

컨트롤 플레인 노드들의 노드 IP입니다.

node-pool.master.ip과 동일할 경우 생략 가능합니다.

• Type : []string

• Default : []

• Since : v1.0.0

isolated

값이 true 면 컨트롤 플레인 노드들에 워크로드가 스케줄링 되지 않도록 taint 처리 합니다.

• Type : boolean

• Default : true (since v1.2.0)

• Since : v1.0.0

lb-ip

컨트롤 플레인 endpoint IP 주소입니다.

• Type : string

• Default : node-pool.master.private-ip[0]

• Since : v1.0.0

lb-port

컨트롤 플레인 endpoint 포트번호입니다.

• Type : integer

• Default : 6443

• Since : v1.0.0

haproxy-install

컨트롤 플레인 노드에 haproxy(static-pod)를 설치를 활성화힙니다.

haproxy는 내부 load balance 역할을 수행합니다.

• Type : boolean

• Default : true

• Since : v1.0.0 ~ v1.0.1

[node-pool.node]

워커 노드의 속성을 정의합니다.

ip

워커 노드들의 SSH 접속 IP 주소들 입니다.

• Type : []string

• Default : []

• Since : v1.0.0

private-ip

워커 노드들의 노드 IP입니다.

node-pool.node.ip과 동일할 경우 생략 가능합니다.

• Type : []string

• Default : []

• Since : v1.0.0

cubectl 실행 환경을 정의합니다.

[cubectl]

cluster-name

설치되는 쿠버네티스 클러스터의 이름입니다.

• Type : string

• Default : kubernetes

• Since : v1.0.0

cert_validity_days

인증서 만료기간 입니다.

• Type : integer

• Default : 36500 (100년)

• Since : v1.0.0

install-dir

노드별 CUBECTL 설치 스크립트 (harbor, shell scripts) 저장 디렉토리입니다.

• Type : string

• Default : "/var/lib/cubectl"

• Since : v1.0.0

closed-network

폐쇄망 설치 여부를 선택합니다.

폐쇄망 설치일 경우 :./archive 디렉토리에 설치 압축파일들이 반드시 존재해야 합니다.

• Type : boolean

• Default : false

• Since : v1.0.0

local-repository-install

리눅스 로컬 저장소 설치를 활성화 합니다.

폐쇄망 설치 시는 true 로 지정해야 하고 {CUBE_HOME}/archive/runtime 디렉토리에 harbor-offline-installer-{VERSION}-linux-{ARCH}.tgz 파일이 존재해야 합니다.

멀티 OS로 클러스터를 구성할 경우 Ubuntu 20.04는 지원하지 않습니다.

• Type : boolean

• Default : -

• Since : v1.0.0

local-repository-url

리눅스 로컬 저장소의 서비스의 URL입니다.

지정하지 않을 경우 사설 저장소의 IP address 가 자동 지정됩니다.

• Type : string

• Default : "http://{{ registry-ip }}:8080"

• Since : v1.0.0

local-repository-port

deprecated v1.2.0

리눅스 로컬 저장소의 서비스 포트번호 입니다.

쿠버네티스와 관련된 속성을 정의합니다.

[kubernetes]

version

쿠버네티스 버전입니다.

버전별 지원 현황은 릴리즈노트를 참고합니다.

• Type : string

• Default : latest

• Since : v1.0.0

kube-proxy-mode

쿠버네티스 프록시 모드입니다.

• Type : string

• Default : "ipvs"

• Ranges: ["ipvs" | "iptables"]

service-cidr

Service CIDR 입니다.

• Type : string

• Default : "10.96.0.0/20"

• Since : v1.0.0

pod-cidr

Pod CIDR 입니다.

• Type : string

• Default : "10.4.0.0/16"

• Since : v1.0.0

node-port-range

노드 포트 범위입니다.

• Type : string

• Default : "30000-32767"

• Since : v1.0.0

audit-log-enable

쿠버네티스 audit 로그를 활성화합니다.

로그는 {{node-pool.data-dir}}/k8s-audit/kubernetes-audit.log 에서 확인할 수 있습니다.

• Type : boolean

• Default : true

• Since : v1.0.0

api-sans

apiserver SAN을 추가합니다. --apiserver-cert-extra-sans 설정과 동일합니다.

• version : v0.1.0

• Type : []string

• Default : 첫번째 컨트롤 플레인 노드 IP

kubelet-dir

kubelet root directory를 변경합니다.

• Type : string

• Default : "/data"

• Since : v1.2.4

container-runtime

kubernetes container runtime을 지정합니다.

• Type : string

• Default : "containerd"

• Ranges: ["containerd" | "cri-o"]

• Since : v1.3.4

[kubernetes.calico]

Calico-cni를 설정합니다.

CUBE는 기본적으로 calico ipip 모드로 설치됩니다.

vxlan-mode

Calico VXLAN 모드를 활성화합니다. vxlan모드는 UDP 4789 포트를 사용합니다.

• Type : boolean

• Default : false

• Since : v1.0.0

[local-repository]

install

local repository 설치를 활성화합니다.

• Type : boolean

• Default : false

• Since : v1.2.4

ip

local repository 노드의 공개 IP 주소입니다. local repository를 설치할 때 사용되는 필수 항목입니다.

• Type : string

• Default : ""

• Since : v1.2.4

private-ip

local repository 노드의 사설 IP 주소입니다. local repository 설치할 때 사용하는 필수 항목입니다.

ip과 동일한 IP 주소를 사용하는 경우 건너뛸 수 있습니다.

• Type : string

• Default : ""

• Since : v1.2.4

service-port

local repository 노드의 서비스 포트 입니다.

• Type : int

• Default : 8080

• Since : v1.2.4

data-dir

local repository 노드가 설치되는 경로입니다.

• Type : string

• Default : "/data/localrepo"

• Since : v1.2.4

사설 저장소 설치 여부 및 관련 속성을 정의합니다.

CUBE는 사설 저장소로 harbor를 설치합니다.

[private-registry]

install

Harbor 설치를 활성화합니다.

• Type : boolean

• Default : false

• Since : v1.0.0

registry-ip

Harbor 노드의 공개 IP 주소입니다. Harbor를 설치할 때 사용되는 필수 항목입니다.

• Type : string

• Default : ""

• Since : v1.0.0

private-ip

Harbor 노드의 사설 IP 주소입니다. Harbor 설치할 때 사용하는 필수 항목입니다.

registry-ip과 동일한 IP 주소를 사용하는 경우 건너뛸 수 있습니다.

• Type : string

• Default : ""

• Since : v1.0.0

registry-version

since v1.0.0 (deprecated v1.2.0)

~~설치될 Harbor 버전을 지정합니다. Harbor를 설치할 때 사용하는 필수 입력 항목입니다. ~~

주 버전만 입력하면 부 버전이 자동으로 마지막 버전을 선택합니다.

registry-domain

도메인 주소입니다. 도메인을 사용하는 경우 입력합니다.

• Type : string

• Default : private-registry.registry-ip

• Since : v1.0.0

admin-password

Admin 계정의 비밀번호입니다.

• Type : string

• Default : 미공개

• Since : v1.2.2

• 참고 - 비밀번호 변경 관련

data-dir

Harbor 데이터 디렉터리 입니다.

• Type : string

• Default : "/data/harbor"

• Since : v1.0.0

public-cert

Harbor 서버 공개 인증을 활성화합니다.

• Type : boolean

• Default : false

• Since : v1.0.0

[private-registry.cert-file]

인증서 파일을 지정합니다.

ssl-certificate

인증서 경로 입니다. 공인 인증을 활성화 했을 경우 필수 입력 항목입니다.

• Type : string

• Default : ""

• Since : v1.0.0

ssl-certificate-key

인증서 키 경로입니다. 공인 인증을 활성화 했을 경우 필수 입력 항목입니다.

• Type : string

• Default : ""

• Since : v1.0.0

cubectl.toml 은 클러스터를 설치하고 업데이트기 위한 기본 설정 정보 파일입니다.

"cubectl config new" 명령으로 template 파일을 생성할 수 있습니다.

$ bin/cubectl config new

# cat config/cubectl.toml

구조

cubectl.toml 의 설정 구조는 아래와 같습니다.

목차

• : cubectl 실행 환경을 정의합니다.

• : 쿠버네티스 관련 속성을 정의합니다.

• : 노드 IP와 같은 노드관련 속성을 정의합니다.