본문 바로가기
문서 목차
ORKESTRIX · 설치

VM 프로비저닝

Terraform을 사용해 OpenStack 위에 클러스터 노드 VM을 생성합니다.

QUANTUM C&S

Terraform을 사용해 OpenStack 위에 클러스터 노드 VM을 생성합니다.

Terraform 설정

Terraform 디렉토리로 이동합니다.

cd terraform/openstack/<cluster-name>

terraform.tfvars 파일을 생성하고 환경에 맞게 값을 입력합니다.

# 클러스터 이름
qks_cluster_name = "<cluster-name>"

# OpenStack 키 페어 이름
qks_kube_node_keypair = "<keypair-name>"

# VM 이미지 ID (Ubuntu 또는 RedHat)
qks_kube_node_image_id = "<image-id>"

# 로드밸런서 사용 여부
create_lb = false

# Control Plane 노드
qks_kube_master_flavor  = "<flavor-id>"
qks_kube_master_num     = 1   # HA 구성 시 3 이상

# Worker 노드
qks_kube_worker_flavor  = "<flavor-id>"
qks_kube_worker_num     = 2

# 추가 노드 (필요 시 0 이상으로 설정)
qks_kube_gpu_num        = 0
qks_kube_nfs_num        = 0
qks_kube_ceph_num       = 0
qks_kube_cicd_num       = 0
qks_kube_master_num은 홀수로 설정해야 합니다. etcd 고가용성 쿼럼을 유지하려면 1 또는 3을 권장합니다.

VM 생성

Terraform을 초기화하고 VM을 생성합니다.

terraform init
terraform plan -var-file=terraform.tfvars
terraform apply -var-file=terraform.tfvars

apply 완료 후 Ansible inventory 파일이 자동으로 생성됩니다.

inventory/<cluster-name>/hosts.ubuntu    # Ubuntu OS용
inventory/<cluster-name>/hosts.redhat    # RedHat OS용

생성 확인

OpenStack 콘솔 또는 CLI에서 VM이 정상 생성되었는지 확인합니다.

openstack server list

배포 서버에서 각 노드로 SSH 접속이 가능한지 확인합니다.

ssh ubuntu@<node-ip>

리소스 정리

클러스터를 삭제할 때는 Terraform으로 VM을 제거합니다.

terraform destroy -var-file=terraform.tfvars

다음 단계

VM 프로비저닝 | QUANTUM C&S