문서 목차
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