![](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/d9d6ce2b-f24a-4501-8192-42864d5d1943_how_to_manually_create_an_openstack_image.png)

>이전 포스팅에서는 오픈스택 구축에 관한 경험을 정리 했었는데 이번 포스팅부터는 구축 후 발생했던 겪었던 이슈에 대한 이슈를 정리 해본다

# 🚨 설치 단계 문제

## 1. OS 설치 관련

### 그래픽 모드 문제
**증상**: Rocky Linux 설치 시 그래픽 화면이 뜨지 않음

**원인**: 
- Nvidia 그래픽 카드 드라이버 이슈
- 하드웨어 호환성 문제

**해결방법**:
```bash
# 방법 1: 부팅 옵션 추가
# GRUB 화면에서 'e' 키를 누르고 다음 추가:
splash nomodeset

# 방법 2: Text mode 설치 후 그래픽 드라이버 설치
sudo dnf install nvidia-driver
```

### 설치 중 네트워크 문제
**증상**: 패키지 다운로드 실패

**해결방법**:
```bash
# DNS 설정 확인
cat /etc/resolv.conf

# 임시 DNS 설정
echo "nameserver 8.8.8.8" | sudo tee -a /etc/resolv.conf
```

---

# 🔧 의존성 및 버전 문제

## 1. Python/Pip 버전 불일치

**증상**: 
- Ansible 설치 실패
- "requirement already satisfied" 오류

**해결방법**:
```bash
# Python 및 pip 업그레이드
sudo dnf update python3 python3-pip

# 가상환경 사용 (권장)
python3 -m venv openstack-env
source openstack-env/bin/activate

# pip 업그레이드
pip install --upgrade pip

# 캐시 클리어
pip cache purge
```

## 2. Ansible 버전 호환성

**증상**: 
- Ansible 실행 시 모듈 오류
- "module not found" 에러

**해결방법**:
```bash
# 특정 버전 설치
pip install ansible==6.0.0

# 의존성 재설치
pip install --force-reinstall ansible

# Galaxy 컬렉션 설치
ansible-galaxy collection install ansible.posix
```

---

# 🐳 Docker 관련 문제

## 1. Docker 권한 문제

**증상**: 
- "permission denied" 오류
- Docker 명령어 실행 불가

**해결방법**:
```bash
# 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

# 그룹 권한 즉시 적용
newgrp docker

# Docker 소켓 권한 확인
sudo chmod 666 /var/run/docker.sock
```

## 2. Docker 서비스 시작 실패

**증상**: Docker 데몬이 시작되지 않음

**해결방법**:
```bash
# 서비스 상태 확인
sudo systemctl status docker

# 로그 확인
sudo journalctl -u docker.service

# 서비스 재시작
sudo systemctl restart docker

# 자동 시작 설정
sudo systemctl enable docker
```

---

# ⚙️ Kolla-Ansible 배포 문제

## 1. 메모리 부족

**증상**: 
- 컨테이너 생성 실패
- OOM (Out of Memory) 오류

**해결방법**:
```bash
# 스왑 파일 생성
sudo fallocate -l 4G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile

# 영구 설정
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# 메모리 사용량 확인
free -h
```

## 2. 네트워크 인터페이스 문제

**증상**: 
- "Network interface not found" 오류
- 외부 연결 불가

**해결방법**:
```bash
# 네트워크 인터페이스 확인
ip addr show

# globals.yml 수정
sudo vim /etc/kolla/globals.yml

# 올바른 인터페이스 설정
network_interface: "enp0s3" # 실제 인터페이스명
neutron_external_interface: "enp0s8"
```

## 3. 포트 충돌

**증상**: 
- "Port already in use" 오류
- 서비스 바인딩 실패

**해결방법**:
```bash
# 포트 사용 현황 확인
sudo netstat -tulpn | grep :80
sudo netstat -tulpn | grep :443

# 기존 서비스 중지
sudo systemctl stop httpd
sudo systemctl stop nginx

# 포트 확인 후 재배포
kolla-ansible -i all-in-one prechecks
```

---

# 🌐 OpenStack 서비스 문제

## 1. Keystone 인증 실패

**증상**: 
- "Authentication failure" 오류
- 대시보드 로그인 불가

**해결방법**:
```bash
# 패스워드 확인
grep keystone_admin_password /etc/kolla/passwords.yml

# 환경 변수 재설정
source /etc/kolla/admin-openrc.sh

# Keystone 컨테이너 재시작
sudo docker restart keystone
```

## 2. Nova 컴퓨트 서비스 문제

**증상**: 
- 인스턴스 생성 실패
- "No valid host found" 오류

**해결방법**:
```bash
# 컴퓨트 서비스 상태 확인
openstack compute service list

# Nova 컨테이너 로그 확인
sudo docker logs nova_compute

# 리소스 사용량 확인
openstack usage show
```

## 3. Neutron 네트워크 문제

**증상**: 
- 네트워크 생성 실패
- 인스턴스 네트워크 연결 안됨

**해결방법**:
```bash
# 네트워크 에이전트 상태 확인
openstack network agent list

# OVS 브리지 확인
sudo ovs-vsctl show

# Neutron 서비스 재시작
sudo docker restart neutron_server
sudo docker restart neutron_openvswitch_agent
```

---

# 💾 스토리지 문제

## 1. Cinder 볼륨 생성 실패

**증상**: 
- 볼륨 생성 시 오류
- "No space left" 메시지

**해결방법**:
```bash
# 디스크 사용량 확인
df -h

# Cinder 설정 확인
sudo docker exec cinder_volume cat /etc/cinder/cinder.conf

# LVM 설정 확인 (LVM 백엔드 사용 시)
sudo vgs
sudo lvs
```

## 2. 스토리지 백엔드 문제

**증상**: 
- 백엔드 초기화 실패
- 스토리지 서비스 다운

**해결방법**:
```bash
# 스토리지 서비스 상태 확인
openstack volume service list

# 로그 확인
sudo docker logs cinder_volume
sudo docker logs cinder_scheduler
```

---

# 🔍 진단 및 모니터링

## 1. 시스템 리소스 모니터링

```bash
# CPU 사용률
top
htop

# 메모리 사용률
free -h
cat /proc/meminfo

# 디스크 I/O
iostat -x 1

# 네트워크 트래픽
iftop
nethogs
```

## 2. 컨테이너 상태 확인

```bash
# 모든 컨테이너 상태
sudo docker ps -a

# 특정 컨테이너 로그
sudo docker logs <container_name>

# 컨테이너 리소스 사용량
sudo docker stats

# 컨테이너 내부 접근
sudo docker exec -it <container_name> bash
```

## 3. OpenStack 서비스 상태

```bash
# 모든 서비스 상태
openstack endpoint list
openstack service list

# 컴퓨트 서비스
openstack compute service list
openstack hypervisor list

# 네트워크 서비스
openstack network agent list

# 볼륨 서비스
openstack volume service list
```

오픈스택 구축 및 운영시 발생할 수 있는 이슈 정리

![how_to_manually_create_an_openstack_image](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/d9d6ce2b-f24a-4501-8192-42864d5d1943_how_to_manually_create_an_openstack_image.png)

> 회사에서 진행한 프로젝트를 통해 OpenStack을 직접 구축하며 학습했던 과정을 정리해보려 합니다. 
당시엔 시행착오도 많고 정말 힘들었지만, 프로젝트 중에 남겨둔 문서와 제 기억을 바탕으로 가능한 한 자세하게 기술해보고자 합니다. 
다양한 시도 과정, 맨땅에 헤딩하듯 해왔던 삽질까지 모두 기록하려 합니다. 
훗날 저와 비슷한 상황에 놓인 분들에게 작은 도움이라도 되길 바라는 마음으로 이 글을 작성합니다.

# 📋 프로젝트 개요

## 배경
- **프로젝트**: 재산관리통합 프로젝트
- **메인목표**: 고객사와 유사한 개발 환경 구축
- **서브목표**: 개발자들이 통합 환경에서 배포 및 소스코드를 관리 할 수 있는 환경 구축
- **요구사항**: OpenStack 기반 클라우드 인프라 구성


## 고객사 플랫폼 구성
- **상태**: 개발 중인 플랫폼 (불안정)
- **아키텍처**:
 - OpenStack 기반 클라우드
 - VM 위에 OpenShift 컨테이너 플랫폼
 - 별도 서버의 Git 및 Database

---

# 🛠 프로젝트 개발서버 구축 환경

## 시스템 사양
- **OS**: Rocky Linux 9.4
- **네트워크**: Online망 -> Offline망

## 기술 스택
- **클라우드 플랫폼**: OpenStack
- **자동화 도구**: Ansible
- **컨테이너**: Kubernetes

---

# ⚡ 주요 도전과제 및 해결방법

## 1. OpenStack 설치 도구 선택

### 시도한 방법들
1. **DevStack** ❌
 - Red Hat 지원 중단
 - Rocky Linux 9.4 비호환

2. **PackStack** ❌
 - 동일하게 지원 중단
 - 설치 패키지 부재

3. **Ansible (Kolla-Ansible)** ✅
 - 최종 선택한 방법
 - 안정적인 지원 및 커뮤니티

---


## 2. 버전 호환성 문제

### 문제 상황
- Python과 pip 버전 불일치
- Ansible 요구 버전 미충족
- 의존성 패키지 충돌

### 해결 과정
```bash
# Python 및 pip 업그레이드
sudo dnf update python3 python3-pip

# 가상환경을 통한 Ansible 설치
python3 -m venv ansible-env
source ansible-env/bin/activate
pip install ansible

# 버전 확인
ansible --version
python3 --version
pip --version
```

**소요 시간**: 2-3일 (OS 재설치 반복 포함)

## 3. OpenStack 설정 복잡성

### 주요 난점
1. **아키텍처 선택**
 - All-in-one vs Multi-node 구성
 - 리소스 및 용도에 따른 선택 기준 부족

2. **환경 설정**
 - `globals.yaml` 파일 설정
 - 네트워크, 스토리지 구성
 - 보안 설정

3. **설치 진행 상황 판단**
 - 에러와 정상 진행 구분 어려움
 - 로그 분석 능력 부족

---

# 📚 학습 포인트

## 기술적 측면
- **시스템 관리**: Linux 시스템 관리 능력 필요
- **네트워크**: 가상 네트워크 구성 이해
- **가상화**: OpenStack 아키텍처 및 컴포넌트 이해
- **자동화**: Ansible 플레이북 작성 및 실행

## 프로젝트 관리 측면
- **문서화**: 충분한 레퍼런스 부족 시 대응 방법
- **문제 해결**: 체계적인 디버깅 접근법
- **시간 관리**: 예상보다 긴 구축 시간 고려

---

# ⚠️ 주요 교훈

## 사전 준비의 중요성
1. **환경 조사**: 하드웨어 호환성 사전 확인
2. **도구 선택**: 지원 상태 및 커뮤니티 활성도 검토
3. **백업 계획**: 실패 시 복구 방안 수립

## 학습 접근법
1. **기초 지식**: OpenStack 아키텍처 이해 우선
2. **단계별 접근**: 컴포넌트별 순차 학습
3. **실습 환경**: 테스트 환경에서 충분한 검증

## 커뮤니티 활용
1. **공식 문서**: OpenStack 공식 문서 숙지
2. **커뮤니티**: Stack Overflow, Reddit 등 활용
3. **현업 조언**: 경험자 멘토링의 중요성

---

# ✅ 최종 결과
1. OpenStack 폐쇄망 구성 완료
2. 각 서비스별 VM 발행 후 CI/CD 구축 준비 완료
3. CI/CD 구축 후 개발 환경 구성완료

---

# 💭 회고 및 느낀 점

OpenStack 구축하면서 제일 먼저 느낀 건 이거였습니다. 
"아… 이건 그냥 설치만 한다고 되는 시스템이 아니구나." 
클라우드 인프라 전체를 알아야 하고, 네트워크 구조에 대한 감도 어느 정도 필요했습니다. 

처음엔 오류 로그만 봐도 머리가 아파서 
반나절은 로그 읽고, 반나절은 구글링하고, 또 반나절은 삽질하면서 보냈습니다. 
근데 이 과정을 겪다보니
자동화의 필요성이랑 환경 격리의 중요성은 진짜 몸으로 느낄 수 있었습니다. 

**이번에 얻은 핵심 교훈은 딱 세 가지입니다** 

	1.	문서 없는 환경에서 문제 해결은 결국 ‘시도 → 실패 → 기록’ 반복이 유일한 답이다.
	2.	OpenStack 같은 대형 시스템은 설치보다 유지보수가 난이도 최상이다.
	3.	Ansible은 선택지가 아니라 필수다. 자동화 없으면 재현성도 확장성도 없다.

다음에는 OpenStack을 그냥 구축하는 데서 끝내지 않고, 
각 컴포넌트가 내부에서 어떻게 통신하고 연결되는지 
아키텍처 레벨에서 제대로 뜯어보고 싶습니다. 
실제로 알아가다 보니 더 깊이 파고싶다는 생각이 들었습니다. 
지금은 시간이 없으니 추후 프로젝트 종료 후에 다시한번 깊게 공부하면서 파볼 예정입니다.

오픈스택 구축 경험 정리

> "우리 회사도 프라이빗 클라우드를 구축하고 싶어요."
> "AWS 비용이 너무 비싸서 온프레미스로 내리고 싶어요."
> 이럴 때 가장 먼저 거론되는 이름이 바로 **OpenStack**입니다. 수십 개의 프로젝트가 얽혀 있어 진입 장벽이 높기로 악명 높은 OpenStack. 하지만 핵심만 알면 **"데이터센터를 위한 운영체제"**라는 말이 딱 들어맞는 매력적인 도구입니다. 오늘은 OpenStack의 정체와 핵심 컴포넌트, 그리고 동작 원리를 아주 깊이 있게 파헤쳐 봅니다.

![OpenStack Services](https://superuser.openstack.org/wp-content/uploads/2018/09/Screen-Shot-2018-09-17-at-9.39.54-PM.png)

# 1. OpenStack이란 무엇인가?

쉽게 말해 **"오픈소스 버전의 AWS"**입니다.
여러분의 서버(컴퓨팅), 스토리지, 네트워크 장비들을 하나로 묶어서, 사용자가 웹 대시보드(Horizon)나 API를 통해 클릭 몇 번으로 가상 머신(VM)을 만들고, 네트워크를 구성할 수 있게 해주는 **IaaS(Infrastructure as a Service) 플랫폼**입니다.

### 🌍 누가 만드나요?
NASA와 Rackspace가 시작하여, 현재는 전 세계 수천 명의 개발자와 Red Hat, Canonical, Mirantis 등 거대 기업들이 참여하는 거대한 오픈소스 프로젝트입니다.

# 2. 핵심 아키텍처: 서비스들의 집합

OpenStack은 하나의 프로그램이 아닙니다. 수많은 **"프로젝트(서비스)"**들이 서로 API로 통신하며 유기적으로 동작합니다.
가장 기본이 되는 핵심 6대 서비스(**Keystone, Nova, Glance, Neutron, Cinder, Horizon**)만 알면 80%는 이해한 것입니다.

### 🔑 1. Keystone (Identity Service) - "문지기"
모든 요청은 Keystone을 통과해야 합니다.
* **역할**: 인증(Authentication) 및 인가(Authorization).
* **기능**: 사용자 관리, 서비스 카탈로그(어떤 서비스가 어디에 있는지) 제공.
* **비유**: AWS IAM + Service Discovery.

### 🖥️ 2. Nova (Compute Service) - "두뇌"
OpenStack의 주인공입니다. 가상 머신(VM)의 생명주기를 관리합니다.
* **역할**: Hypervisor(KVM, Xen 등)를 제어하여 VM을 생성(`spawn`), 삭제(`terminate`), 재부팅합니다.
* **비유**: AWS EC2.

### 💿 3. Glance (Image Service) - "설계도 보관소"
VM을 띄우려면 OS 이미지가 필요하겠죠? (Ubuntu, CentOS 등)
* **역할**: VM 이미지를 등록하고 관리합니다.
* **비유**: AWS AMI.

### 🕸️ 4. Neutron (Networking Service) - "혈관"
가장 복잡하고 중요한 부분입니다. 가상 네트워크를 정의합니다.
* **역할**: 가상 라우터, 스위치, 방화벽(Security Group), Floating IP 등을 관리합니다.
* **기술**: OVS(Open vSwitch), Linux Bridge 등을 사용하여 SDN(Software Defined Networking)을 구현합니다.
* **비유**: AWS VPC.

### 💾 5. Cinder (Block Storage) - "하드 디스크"
VM에 붙였다 뗐다 할 수 있는 영구 저장소입니다.
* **역할**: 외장 하드처럼 동작하는 블록 스토리지를 생성하고 VM에 마운트합니다.
* **비유**: AWS EBS.

### 🖥️ 6. Horizon (Dashboard) - "얼굴"
이 모든 것을 웹 브라우저에서 제어할 수 있는 GUI입니다.
* **역할**: 관리자 및 사용자용 웹 인터페이스.
* **비유**: AWS Management Console.

# 3. 어떻게 동작하나요? (VM 생성 흐름)

사용자가 "VM 하나 만들어줘"라고 요청하면 내부적으로 어떤 일이 일어날까요?

1. **사용자 -> Horizon**: 로그인 후 "인스턴스 시작" 버튼 클릭.
2. **Horizon -> Keystone**: 사용자 인증 토큰 발급.
3. **Horizon -> Nova-API**: "이 스펙(Flavor)으로, 이 이미지(Glance) 써서 VM 만들어줘."
4. **Nova -> Glance**: "OS 이미지 위치 좀 알려줘."
5. **Nova -> Neutron**: "이 VM이 쓸 IP랑 네트워크 포트 좀 만들어줘."
6. **Nova -> Cinder**: (필요시) "볼륨 하나 만들어서 붙여줘."
7. **Nova-Compute -> Hypervisor(KVM)**: "준비 다 됐다. 실제 프로세스 띄워!"

이 모든 과정이 API 호출과 Message Queue(RabbitMQ)를 통해 비동기로 척척 진행됩니다.

# 4. OpenStack 설치 및 운영 (현실)

### 🛠 설치 방법
맨땅에 헤딩(소스코드 컴파일)은 추천하지 않습니다. 배포 도구를 쓰세요.
* **DevStack**: 개발/테스트용. 스크립트 하나로 설치 끝. (운영용 절대 아님) - 현재 지원 중단
* **Kolla-Ansible**: 모든 서비스를 **Docker 컨테이너**로 띄워서 관리합니다. (현재 대세)
* **OpenStack-Ansible**: LXC 컨테이너 기반.
* **Red Hat OpenStack Platform (RHOSP)**: 엔터프라이즈 상용 솔루션.

### ⚠️ 운영 시 주의사항
* **네트워크(Neutron)**가 제일 어렵습니다. 패킷 흐름(VLAN, VXLAN)을 이해하지 못하면 트러블슈팅이 불가능합니다.
* **로그 분석**: 각 서비스(`nova-api.log`, `neutron-server.log` 등)가 분산되어 있으므로 ELK 스택 같은 중앙 집중형 로깅이 필수입니다.

# 마치며

OpenStack은 배우기 어렵지만, 한번 익히고 나면 **"클라우드가 밑바닥에서 어떻게 도는가"** 를 완벽하게 이해하게 됩니다. 가상화, 네트워크, 스토리지, 분산 시스템의 종합 선물 세트이기 때문이죠.

나만의 프라이빗 클라우드를 구축해보고 싶다면, 남는 PC 두어 대로 Kolla-Ansible과 All-in-one으로 시작해 보세요. 그곳이 바로 여러분만의 작은 데이터센터가 될 것입니다. ☁️

OpenStack

이 주제의 기록

오픈스택 구축 및 운영시 발생할 수 있는 이슈 정리

오픈스택 구축 경험 정리

OpenStack 기초 가이드: 나만의 AWS를 만드는 오픈소스 클라우드 OS