OpenStack 설치 9 — Kolla Ansible Multinode 배포

이 글에서 다루는 내용

• Deployment·Controller·Compute 3노드 구성

• VirtualBox NAT Network와 Port Forwarding

• Ansible용 일반 사용자의 SSH·Passwordless sudo 설정

• Management Network와 Provider Network 분리

• Multinode inventory와 globals.yml 작성

• bootstrap → prechecks → deploy 배포 흐름

• Provider Network와 br-ex 검증

1. 전체 아키텍처

노드 구성

네트워크 구성

flowchart LR
    D["deployment<br>192.168.56.50"] -->|"SSH · Ansible<br>Management Network"| C["controller<br>192.168.56.101"]
    D -->|"SSH · Ansible<br>Management Network"| N["compute1<br>192.168.56.111"]
    C <-->|"API · DB · MQ · VXLAN"| N
    C --- P["Provider Network<br>10.0.2.0/24 · br-ex"]
    N --- P
    VIP["Kolla Internal VIP<br>192.168.56.250"] --- C

2. VirtualBox 네트워크 준비

1. OpenStack-Mgmt: 192.168.56.0/24, Gateway 192.168.56.1, DHCP 끔

2. OpenStack-Provider: 10.0.2.0/24, Gateway 10.0.2.1, DHCP 끔

3. Deployment에는 Management NIC만 연결

4. Controller와 Compute에는 Management NIC와 Provider NIC를 연결

5. Provider NIC의 Promiscuous Mode를 Allow All로 설정

Port Forwarding

ssh -p 2221 ubuntu@127.0.0.1
ssh -p 2222 ubuntu@127.0.0.1
ssh -p 2223 ubuntu@127.0.0.1

3. 각 노드의 네트워크 설정

• enp0s3: Management NIC

• enp0s8: Provider NIC

ip -br link
ip -br addr

Deployment Netplan

network:
  version: 2
  ethernets:
    enp0s3:
      addresses:
        - 192.168.56.50/24
      routes:
        - to: default
          via: 192.168.56.1
      nameservers:
        addresses:
          - 8.8.8.8
          - 8.8.4.4

Controller Netplan

network:
  version: 2
  ethernets:
    enp0s3:
      addresses:
        - 192.168.56.101/24
      routes:
        - to: default
          via: 192.168.56.1
      nameservers:
        addresses:
          - 8.8.8.8
          - 8.8.4.4
    enp0s8: {}

Compute Netplan

network:
  version: 2
  ethernets:
    enp0s3:
      addresses:
        - 192.168.56.111/24
      routes:
        - to: default
          via: 192.168.56.1
      nameservers:
        addresses:
          - 8.8.8.8
          - 8.8.4.4
    enp0s8: {}

sudo chmod 600 /etc/netplan/00-kolla.yaml
sudo netplan generate
sudo netplan try
sudo netplan apply

• Management NIC에만 192.168.56.x/24 주소가 있다.

• Controller와 Compute의 Provider NIC에는 IP가 없다.

• Default Route는 Management NIC에 하나만 있다.

호스트 이름과 이름 해석

# deployment
sudo hostnamectl set-hostname deployment

# controller
sudo hostnamectl set-hostname controller

# compute1
sudo hostnamectl set-hostname compute1

192.168.56.50   deployment
192.168.56.101  controller
192.168.56.111  compute1

getent hosts deployment controller compute1

4. Ansible용 SSH와 sudo 준비

일반 사용자와 Passwordless sudo

sudo usermod -aG sudo ubuntu

echo 'ubuntu ALL=(ALL) NOPASSWD:ALL' | \
  sudo tee /etc/sudoers.d/90-kolla-ansible-ubuntu
sudo chmod 440 /etc/sudoers.d/90-kolla-ansible-ubuntu
sudo visudo -cf /etc/sudoers.d/90-kolla-ansible-ubuntu
sudo visudo -cf /etc/sudoers
sudo -n true && echo 'NOPASSWD sudo OK'

SSH Key 복사

ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
ssh-copy-id ubuntu@controller
ssh-copy-id ubuntu@compute1

ssh ubuntu@controller 'hostname && sudo -n true'
ssh ubuntu@compute1 'hostname && sudo -n true'

5. Kolla Ansible 2026.1 설치

sudo apt update
sudo apt install -y \
  git python3-dev python3-venv libffi-dev gcc \
  libssl-dev libdbus-glib-1-dev

sudo mkdir -p /etc/kolla
sudo chown "$USER:$USER" /etc/kolla

python3 -m venv /etc/kolla/.venv
source /etc/kolla/.venv/bin/activate
pip install -U pip
pip install git+https://opendev.org/openstack/kolla-ansible@stable/2026.1

cp -r "$VIRTUAL_ENV/share/kolla-ansible/etc_examples/kolla/"* /etc/kolla/
cp "$VIRTUAL_ENV/share/kolla-ansible/ansible/inventory/multinode" \
  /etc/kolla/multinode

kolla-ansible install-deps
kolla-ansible --version
ansible --version

source /etc/kolla/.venv/bin/activate

6. Multinode inventory 작성

[control]
controller ansible_host=192.168.56.101

[network]
controller

[compute]
compute1 ansible_host=192.168.56.111

[monitoring]
controller

[storage]
controller

[deployment]
localhost ansible_connection=local

[all:vars]
ansible_ssh_user=ubuntu
ansible_become=true
ansible_python_interpreter=/usr/bin/python3
ansible_private_key_file=/home/ubuntu/.ssh/id_ed25519

ansible -i /etc/kolla/multinode all -m ping

7. globals.yml 설정

# 이미지와 OpenStack 버전
kolla_base_distro: "ubuntu"
openstack_release: "2026.1"

# Management Network
network_interface: "enp0s3"
api_interface: "enp0s3"
tunnel_interface: "enp0s3"
kolla_internal_vip_address: "192.168.56.250"

# Provider Network
neutron_external_interface: "enp0s8"
neutron_bridge_name: "br-ex"
neutron_physical_networks: "physnet1"
neutron_plugin_agent: "openvswitch"
enable_neutron_provider_networks: "yes"

# 핵심 서비스
enable_openstack_core: "yes"
enable_horizon: "yes"
enable_cinder: "no"

# Nested virtualization이 없는 VirtualBox 실습 기준
nova_compute_virt_type: "qemu"

ssh compute1 'test -e /dev/kvm && echo KVM_OK || echo USE_QEMU'

kolla-genpwd
sudo chmod 600 /etc/kolla/passwords.yml

8. OpenStack 배포

Bootstrap

kolla-ansible bootstrap-servers -i /etc/kolla/multinode

Prechecks

kolla-ansible prechecks -i /etc/kolla/multinode

kolla-ansible prechecks --help | grep -F -- '--use-test-images'

kolla-ansible prechecks -i /etc/kolla/multinode \
  --use-test-images

# 운영 환경 예시
# docker_registry: "registry.example.com:5000"
# docker_namespace: "kolla"
# docker_registry_insecure: false

이미지 다운로드와 배포

kolla-ansible pull -i /etc/kolla/multinode
kolla-ansible deploy -i /etc/kolla/multinode

kolla-ansible validate-config -i /etc/kolla/multinode

9. OpenStack CLI와 서비스 검증

kolla-ansible post-deploy -i /etc/kolla/multinode

pip install python-openstackclient \
  -c https://releases.openstack.org/constraints/upper/2026.1

export OS_CLIENT_CONFIG_FILE=/etc/kolla/clouds.yaml

openstack --os-cloud kolla-admin service list
openstack --os-cloud kolla-admin endpoint list
openstack --os-cloud kolla-admin compute service list
openstack --os-cloud kolla-admin hypervisor list
openstack --os-cloud kolla-admin network agent list

• nova-compute가 compute1에서 enabled / up 상태다.

• Hypervisor 목록에 compute1이 보인다.

• Neutron agent가 Controller와 Compute에서 정상이다.

• Keystone, Glance, Nova, Neutron endpoint가 생성됐다.

ssh controller 'sudo docker ps'
ssh controller 'sudo ovs-vsctl show'

ssh compute1 'sudo docker ps'
ssh compute1 'sudo ovs-vsctl show'

http://127.0.0.1:8080

10. Provider Network 생성

openstack --os-cloud kolla-admin network create provider \
  --external \
  --share \
  --provider-network-type flat \
  --provider-physical-network physnet1

openstack --os-cloud kolla-admin subnet create provider-subnet \
  --network provider \
  --subnet-range 10.0.2.0/24 \
  --gateway 10.0.2.1 \
  --allocation-pool start=10.0.2.100,end=10.0.2.200 \
  --no-dhcp

openstack --os-cloud kolla-admin network create private

openstack --os-cloud kolla-admin subnet create private-subnet \
  --network private \
  --subnet-range 172.16.0.0/24 \
  --dns-nameserver 8.8.8.8

openstack --os-cloud kolla-admin router create router1
openstack --os-cloud kolla-admin router set router1 \
  --external-gateway provider
openstack --os-cloud kolla-admin router add subnet router1 private-subnet

openstack --os-cloud kolla-admin network list
openstack --os-cloud kolla-admin subnet list
openstack --os-cloud kolla-admin router show router1
openstack --os-cloud kolla-admin floating ip create provider

11. 자주 막히는 지점

SSH가 UNREACHABLE인 경우

ansible -i /etc/kolla/multinode all -m ping -vv
ssh -v ubuntu@controller
ssh ubuntu@controller 'sudo -n true'

VIP Precheck가 실패하는 경우

ping -c 2 192.168.56.250
sudo arping -I enp0s3 192.168.56.250

br-ex는 있지만 외부 통신이 안 되는 경우

1. Provider NIC에 IP나 DHCP 설정이 남아 있는가

2. Controller와 Compute가 같은 Provider L2 네트워크에 연결됐는가

3. VirtualBox Promiscuous Mode가 Allow All인가

4. physnet1 ↔ br-ex ↔ enp0s8 매핑이 일치하는가

5. Floating IP 풀이 NAT Network의 다른 주소와 충돌하지 않는가

ssh controller 'ip -br addr; sudo ovs-vsctl show'
ssh compute1 'ip -br addr; sudo ovs-vsctl show'

컨테이너가 Exited 상태인 경우

ssh controller 'sudo docker ps -a --filter status=exited'
ssh compute1 'sudo docker ps -a --filter status=exited'
ssh controller 'sudo find /var/log/kolla -maxdepth 2 -type f | head'

kolla-ansible prechecks -i /etc/kolla/multinode
kolla-ansible reconfigure -i /etc/kolla/multinode

재발 방지 체크리스트

핵심 정리

1. Deployment 노드는 OpenStack 서비스를 실행하지 않고 Ansible 제어 노드 역할을 한다.

2. Management NIC에는 고정 IP를 주고, Provider NIC는 IP 없이 Neutron에 넘긴다.

3. Multinode 배포의 핵심은 inventory의 역할 배치, SSH·sudo 권한, NIC 이름, VIP 네 가지다.

4. Provider Network를 Compute에서 직접 사용하려면 enable_neutron_provider_networks와 외부 브리지 구성이 필요하다.

5. Controller가 한 대인 이번 구성은 HA가 아니다. 운영 환경에서는 Controller를 3대로 확장하고 Registry·DB·MQ·VIP의 고가용성을 함께 설계해야 한다.

참고 자료

• Kolla Ansible 2026.1 Quick Start

• Kolla Ansible Multinode Deployment

• Kolla Ansible Neutron 설정

• Kolla Ansible Troubleshooting Guide