![IMG_5857](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/b88f18d7-2620-4d08-908a-942bfb5bf69e_IMG_5857.jpeg)

바르셀로나 카사바뜨요에요 신기하죠~~😅

유럽여행

![](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. 오픈스택 같은 대규모 시스템은 설치보다 유지보수 전략이 더 중요하다
3. Ansible을 통한 자동화는 단순한 도구가 아니라, 재현성과 확장성을 확보하는 핵심이었다

다음엔 OpenStack을 단순히 구축하는 걸 넘어, 
모듈별 컴포넌트 구조와 내부 통신 로직을 직접 뜯어보며 아키텍처 관점에서 분석해보고 싶다.

오픈스택 구축 경험 정리 - 1

![typescript](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/e8c1cc3c-8aa3-42f8-9382-60df0d5c2cee_typescript.jpeg)

# react-native와 typescript로 공부를 하다 진짜 너무 황당한 에러를 맞딱뜨렸다..
>'string | null' 형식의 인수는 'string' 형식의 매개 변수에 할당될 수 없습니다. 'null' 형식은 'string' 형식에 할당할 수 없습니다.

#### 1. 무슨 내용의 에러인가
##### 1. 우선 코드를 살펴보자
```typescript
const key = 'todos';
const rawTodos = await AsyncStorage.getItem(key);
const savedTodos: ITodos[] = JSON.parse(rawTodos);
```
1. AsyncStorage에 있는 todos라는 key로 Object Value를 가져와서 rawTodos 변수에 저장한다.
2. rawTodos에 저장되어있는 Object를 JSON.parse를 통해 파싱을 해서 savedTodos 변수에 저장한다.
3. 이때 JSON.parse(rawTodos)에서 rawTodos에 빨간색 밑줄이 생기면서 위의 에러를 떨군다

##### 2. 무엇이 문제인가
해당 코드의 에러는 typescript에서 발생해서 타입이 맞지않는다는 에러인데 rawTodos에
const rawTodos: string | null
으로 type을 지정해줘도 위의 에러는 사라지지않았다
2. 해결방법
정말 온갖 생쇼를 하다가 정말 간단하게 해결했다
1. **해결방법1**
```typescript
const key = 'todos';
const rawTodos = await AsyncStorage.getItem(key);
if (!rawTodos) {
 throw new Error('No saved todos');
}
const savedTodos: ITodos[] = JSON.parse(rawTodos);
```
위의 코드처럼 rawTodos가 없을때 즉 null일 경우 처리해준다

2. **해결방법2** 
tsconfig.json에서 
strictNullChecks: false 
로 설정해준다 
typescript로 개발하다보면 현재의 경우처럼 빡세게 null 체크를 할 때가있는데 이걸 false로 해주면 좀 널널하게 바꿔준다는것 같다

3. **마무리** 
typescript를 공부하는 중이라 정말 여러가지 난관에 부딪히는거 같다
특히 저런 에러는 구글링을해도 잘 못찾겠더라
typescript를 잘다루기까지의 난관이 너무 험난하다...

typescript 에러

![nestjs](https://librarian-blog-images.s3.ap-northeast-2.amazonaws.com/709b0388-fd0c-4648-a768-381a590ad90e_nestjs.jpg)

# NestJS 패키지 설치시 ts-jest 때문에 설치가 안되는 현상

### 1. 2023년 1월 중순부터 현재(1월 31일)까지 ts-jest 설치가 안되는 현상이 발견됨

1. 일단 이렇게 패키지 설치가 안될경우에 패키지의 문제인지 아닌지를 확인하기위해서 스택오버플로우에 검색을 해봤지만 외국인들은 설치가 잘만 되는것 같았다
2. 그럼 집에있는 네트워크가 문제인가 싶어 노트북에 핸드폰 테더링을 연결해서 install 해봤지만 실패 (집에있는 인터넷, 핸드폰 모두 KT 사용중)
3. 그렇다면 생각해볼 수 있는건 통신사 문제라는것으로 결론이 났고 그렇게 구글링 시작


### 2. 현재 이 문제는 KT를 사용하고 있는 한국사람들 대상으로 일어나고 있는 문제가 맞았다

1. https://github.com/kulshekhar/ts-jest/issues/3992 확인해보니
2. 한국인들이 이슈를 열어 놓은게 있어 읽어봤다
3. KT망에서만 설치가 안되는것을 확인했다
4. npm support 팀에서 KT망에서만 안되는 원인을 파악중이라고 한다


### 3. 해결책
`npm config set registry https://registry.npmjs.cf/`을 터미널에 입력해 mirror로 바꿔주고 install 하면 제대로 설치된다
나중에 이슈가 해결되면

`npm config set registry https://registry.npmjs.org/`
로 다시 바꿔주는것도 잊지말자..



### 4. 결론
KT나 npm쪽에서 아직 공식적인 발표가 없어 뭐라 하긴 힘들지만... 1월 초까지만 해도 분명 잘됐었다 지금 KT 사용자만 안되는걸로봐선 거의 KT 잘못이 확실한것 같다... 통신사를 바꾸던지 해야지...



ts-jest 설치 안되는 현상


# 새로운 시작 블로그를 열며

저만의 공간을 가지고 싶어 블로그를 하나 만들어 제 생각을 남길 예정입니다

지금 상용하고있는 여러 블로그도 있지만 내 입맛대로 꾸미고싶은 욕심이 항상 있어서

이렇게 만들어서 운영하게 됐습니다

제 블로그에 쓴 글 들이 누군가에겐 도움이 되길 바라며...