우분투 22.04 서버에 DevStack을 설치하려다 3시간 만에 포기한 경험이 있다. Dell R630 장비에서 OpenStack 개발 환경을 구성하려던 시도였는데, 결국 원인을 찾지 못해 설치를 중단했다. 실패 과정에서 만난 오류들을 정리해두면 같은 삽질을 반복하지 않을 수 있을 것 같아 기록을 남긴다.
DevStack 설치 전 준비 작업, 여기서부터 문제가 시작됐다
우분투 22.04를 Dell R630에 설치한 뒤 DevStack을 받기 전에 시스템 업데이트부터 진행했다. sudo apt update && sudo apt upgrade -y 명령으로 패키지를 최신 상태로 유지했고, git과 python 관련 기본 도구도 함께 설치했다. 이 과정 자체는 순조로웠다. 문제는 이후 DevStack 스크립트가 요구하는 파이썬 버전과 우분투 22.04 기본 파이썬 환경 사이의 충돌에서 시작됐다.
DevStack 저장소를 클론할 때는 브랜치 선택이 중요하다. 참고 자료에서는 stable/stein 브랜치를 사용했는데, 이는 OpenStack Stein 릴리즈용이다. 우분투 22.04는 파이썬 3.10을 기본으로 제공하는데, Stein 브랜치는 상대적으로 오래된 버전이라 일부 의존성 패키지가 현재 저장소에서 제거되거나 변경된 상태였다. 이 조합이 첫 번째 오류의 원인이 됐다.
local.conf 설정에서 발생한 오류와 재시도 과정
DevStack 설치에서 가장 중요한 파일은 local.conf다. 샘플 파일을 복사한 뒤 서버 IP와 설치 디렉토리를 지정하고 스크립트를 실행했는데, 바로 에러가 발생했다. 로그를 확인해보니 특정 파이썬 모듈이 없다는 내용이 반복됐다. pip로 해당 모듈을 설치한 뒤 다시 실행했지만, 이번에는 다른 의존성 문제가 나타났다.
git clone https://github.com/openstack-dev/devstack.git -b stable/stein
cd devstack
cp samples/local.conf .
local.conf 파일에서 HOST_IP와 DATA_DIR 정도만 수정했는데, 실제로는 더 세밀한 설정이 필요했다. 우분투 22.04 환경에서는 파이썬 패키지 관리자 버전이나 가상 환경 구성 방식이 이전 LTS 버전과 달라서, DevStack 스크립트가 예상하는 환경과 차이가 있었다. 특히 python3-dev 패키지가 누락되어 있어 컴파일이 필요한 일부 모듈에서 오류가 발생했다.
네트워크 서비스(Neutron) 오류, 가장 해결하기 어려웠던 부분
설치 과정에서 가장 큰 벽은 Neutron 네트워크 서비스였다. 스크립트가 네트워크 구성을 자동으로 처리하는 과정에서 인터페이스 설정 충돌이 발생했다. Dell R630은 다수의 네트워크 포트를 가지고 있는데, DevStack이 기본적으로 선택하는 네트워크 인터페이스와 실제 서버의 인터페이스 이름이 달라 문제가 생긴 것이다.
/etc/network/interfaces 파일을 수정하고 네트워크 서비스를 재시작하는 방법을 시도했지만, 서버 재부팅 후 설정이 유지되지 않는 문제가 있었다. netplan을 사용하는 우분투 22.04 환경에서는 기존 네트워크 설정 방식이 잘 맞지 않았다. 결국 이 부분에서 시간을 가장 많이 소비했고, 해결책을 찾지 못한 채 설치를 중단했다.
설치 실패 후 확인해볼 만한 로그 위치와 참고 자료
DevStack 설치가 실패했을 때 로그는 /opt/stack/logs 디렉토리에서 확인할 수 있다. 참고 자료에 따르면 각 서비스별 로그는 /var/log/nova/, /var/log/neutron/, /var/log/horizon/ 경로에 남는다. 오류가 발생한 단계를 특정하려면 이 로그 파일들을 살펴보는 것이 가장 빠르다.
/opt/stack/logs/: DevStack 스크립트 실행 로그/var/log/neutron/: 네트워크 서비스 관련 로그/var/log/nova/: 컴퓨트 서비스 관련 로그
우분투 22.04에서 DevStack을 설치할 때는 안정적인 브랜치를 선택하고, 네트워크 인터페이스 설정을 사전에 확인하는 것이 중요하다. 특히 최소 8GB RAM과 2CPU 이상의 자원이 필요하다는 점도 참고 자료에서 확인할 수 있었다.
FAQ
Q. DevStack 설치에 필요한 최소 사양은 어느 정도인가요?
참고 자료 기준으로 최소 8GB RAM과 2CPU가 권장된다. Dell R630 같은 서버급 장비라면 대부분 충족하는 사양이다.
Q. 우분투 22.04에서 어떤 DevStack 브랜치를 선택해야 하나요?
stable/stein 브랜치를 사용했을 때 파이썬 3.10 환경과 충돌이 발생했다. 가능하다면 최신 안정 브랜치를 사용하거나, 우분투 20.04처럼 파이썬 3.8 기반 환경에서 설치하는 편이 안전하다.
Q. 설치 중 누락된 파이썬 패키지는 어떻게 처리하나요?
sudo apt install python3-dev 명령으로 기본 개발 도구를 설치한 뒤 다시 시도하는 것이 좋다. 그래도 문제가 있다면 오류 메시지에 표시된 패키지 이름을 확인해서 개별적으로 설치하면 된다.