![](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
```


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

독자의 메모