Kolla-Ansible All-in-One 實作

Kolla-Ansible All-in-One 實作學習單

在一台 Ubuntu 主機上,用 Kolla-Ansible 以 Docker 容器部署一套單節點 OpenStack,最後建立第一台虛擬機。每一步都有要輸入的指令、指令解說,以及完成後該看到的結果。

主機
Ubuntu 24.04 LTS
最低規格
2 vCPU · 8 GB RAM · 40 GB 磁碟
管理網卡
ens3
外部網路網卡
veth-ext(本課程以 veth 模擬)
預估時間
約 60–90 分鐘(deploy 佔大半)
00

環境與架構

Ubuntu 主機 (all-in-one) Docker 容器(由 Kolla-Ansible 管理) keystone · glance · nova · neutron · placement horizon · mariadb · rabbitmq · memcached … API 端點 = kolla_internal_vip_address (未啟用 HAProxy → 直接用主機 IP) ens3 network_interface · 主機 IP veth-ext ⇄ veth-ext-br neutron_external_interface · 不設 IP 實線:管理 / API / SSH 流量走 ens3。 虛線:Neutron 把 veth-ext 接到 br-ex,供 floating IP / provider network 使用。
Kolla 要求外部網路網卡「不能有 IP」,所以單網卡的實驗機用一對 veth 來代替第二張網卡。
先確認

以下指令都在主機上以 ubuntu 身分執行(需要 sudo 權限)。用 ip -br a 確認管理網卡名稱是 ens3 並記下它的 IPv4 位址,第 05 步會用到。

bash
$ ip -br a
$ free -g && nproc && df -h /

指令解說

ip -br a
以精簡格式(-br = brief)列出所有網卡的名稱、狀態(UP/DOWN)與 IP 位址。用來確認管理網卡是不是 ens3、有沒有拿到 IP。
free -g
以 GB 為單位顯示記憶體用量。Kolla all-in-one 至少需要 8 GB,total 欄顯示 7 屬正常(系統會保留一部分)。
nproc
顯示可用的 CPU 核心數,建議至少 2 核。
df -h /
以易讀單位顯示根目錄的磁碟空間,Avail 欄至少要有 40 GB,用來存放容器映像與 VM 磁碟。
&&
前一個指令成功才執行下一個,這裡用來一次看完三項硬體資訊。
01

安裝系統套件

安裝編譯 Python 套件需要的工具與標頭檔。

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

建立 Python 虛擬環境

把 Kolla-Ansible 和 Ansible 裝在獨立的環境裡,不污染系統 Python。

bash · 家目錄 ~
$ cd ~
$ python3 -m venv ./venv
$ source ./venv/bin/activate
(venv) $ pip install -U pip

指令解說

python3 -m venv ./venv
在 ~/venv 建立虛擬環境,裡面有自己的 python 與 pip。
source ./venv/bin/activate
啟用虛擬環境,提示字元前會出現 (venv)。之後的 pip、kolla-ansible、openstack 指令都要在啟用狀態下執行。
pip install -U pip
Ubuntu 內建的 pip 較舊,先升級可避免安裝新套件時解析相依失敗。
提醒

重新登入或開新終端機後,記得先 source ~/venv/bin/activate,否則會出現 kolla-ansible: command not found。

03

安裝 Kolla-Ansible 並準備設定檔

安裝部署工具,並把範例設定與 inventory 複製出來。

bash · (venv)
(venv) $ pip install git+https://opendev.org/openstack/kolla-ansible@master
(venv) $ sudo mkdir -p /etc/kolla
(venv) $ sudo chown $USER:$USER /etc/kolla
(venv) $ cp -r ./venv/share/kolla-ansible/etc_examples/kolla/* /etc/kolla
(venv) $ cp ./venv/share/kolla-ansible/ansible/inventory/all-in-one .

指令解說

pip install git+…@master
直接從原始碼安裝 master 分支(開發版)。正式環境建議換成穩定分支,例如 stable/2025.1,並搭配對應版本的映像檔。
/etc/kolla
Kolla-Ansible 預設的設定目錄。改成目前使用者擁有,之後編輯就不用 sudo。
globals.yml
主要設定檔:發行版、網卡、VIP、要啟用哪些服務。
passwords.yml
所有服務密碼的清單,目前都是空的,下一步會自動產生。
all-in-one
Ansible inventory;所有角色(control、network、compute、storage…)都指向 localhost。
注意檔名

設定檔名稱是 globals.yml(不是 globals.yaml)。若存成 .yaml,Kolla 不會讀取。

04

安裝 Galaxy 依賴並產生密碼

補齊 Ansible collections,並一次產生所有服務的隨機密碼。

bash · (venv)
(venv) $ kolla-ansible install-deps
(venv) $ kolla-genpwd

指令解說

kolla-ansible install-deps
依 requirements.yml 從 Ansible Galaxy 安裝 openstack.kolla、community.docker 等 collections 到 ~/.ansible/collections。
kolla-genpwd
填滿 /etc/kolla/passwords.yml 中所有空白欄位,並把檔案權限改成只有擁有者可讀。重複執行不會覆蓋已存在的密碼。
05

建立外部網卡並設定 globals.yml

在部署前告訴 Kolla:用哪個發行版、哪張網卡、API 位址是什麼。

順序調整

這一步必須在 bootstrap / prechecks / deploy 之前完成。所有 kolla-ansible 指令都會讀取 globals.yml,部署完才改設定會造成網卡與 API 位址錯誤。

5-1 建立 veth-ext。實驗機只有一張 ens3,用一對 veth 當作 Neutron 的外部網卡:

bash
$ sudo ip link add veth-ext type veth peer name veth-ext-br
$ sudo ip link set veth-ext up
$ sudo ip link set veth-ext-br up
$ ip -br link | grep veth

指令解說

ip link add … type veth peer …
建立一對虛擬網卡,一端送出的封包會從另一端出來,就像一條網路線的兩頭。
ip link set … up
啟用網卡。外部網卡不需要、也不應該設定 IP 位址。
重開機會消失

用 ip link 建立的 veth 不是永久設定。若實驗機會重開機,請改用下方的「持久化做法」取代 5-1。

(選用)5-1′ 持久化做法。Ubuntu 24.04 由 systemd-networkd 管理網路,把 veth 寫成設定檔,開機時就會自動建立並啟用:

bash
$ sudo tee /etc/systemd/network/25-veth-ext.netdev <<EOF
[NetDev]
Name=veth-ext
Kind=veth

[Peer]
Name=veth-ext-br
EOF
$ sudo tee /etc/systemd/network/25-veth-ext.network <<EOF
[Match]
Name=veth-ext veth-ext-br

[Network]
LinkLocalAddressing=no
ConfigureWithoutCarrier=yes
EOF
$ sudo networkctl reload
$ networkctl list | grep veth

設定解說

.netdev
定義虛擬網卡本身:Kind=veth 加上 [Peer] 就是一對 veth。
.network
讓 networkd 把兩端都啟用。LinkLocalAddressing=no 確保不配任何 IP(包括 IPv6 link-local),符合外部網卡不能有 IP 的要求。
networkctl reload
重新讀取設定並立即建立網卡,不必重開機。兩端狀態應為 configured。

5-2 設定 globals.yml。先把你的 VIP 設成變數,再把設定附加到檔案最後面:

VIP 由講師提供

每位學員的 VIP(kolla_internal_vip_address)會在上課時提供,請把下方的 10.127.0.X 換成你拿到的位址,不要照抄範例。

bash · (venv)
(venv) $ VIP=10.127.0.X   # 改成上課時提供給你的 VIP
(venv) $ echo $VIP
(venv) $ cat >> /etc/kolla/globals.yml <<EOF
kolla_base_distro: "ubuntu"
nova_compute_virt_type: "qemu"
network_interface: "ens3"
neutron_external_interface: "veth-ext"
kolla_internal_vip_address: "${VIP}"
enable_haproxy: "no"
EOF

參數解說

kolla_base_distro
容器映像檔的基底發行版,與主機一致使用 ubuntu。
nova_compute_virt_type
實驗機本身是 VM,沒有巢狀虛擬化(/proc/cpuinfo 沒有 vmx/svm),只能用 qemu 純軟體模擬。實體機可用 kvm。
network_interface
管理、API、內部服務溝通使用的網卡。
neutron_external_interface
交給 Neutron 掛到 br-ex 的網卡,必須沒有 IP。
kolla_internal_vip_address
所有 OpenStack API 端點使用的位址。
enable_haproxy
單節點不需要負載平衡;關閉 HAProxy 時 keepalived 也一併關閉。
VIP 必須是主機自己的 IP

關閉 HAProxy 後就沒有 keepalived 去「掛上」VIP,因此 kolla_internal_vip_address 必須填 ens3 上已存在的 IP。若填一個沒人使用或被別台機器佔用的位址(例如原講義的 10.127.0.34),服務會無法互相連線。

06

Bootstrap 主機

安裝 Docker 與部署所需的主機層級設定,並補齊 venv 內的 Python 模組。

bash · (venv)
(venv) $ kolla-ansible bootstrap-servers -i ./all-in-one
(venv) $ pip install docker dbus-python

指令解說

bootstrap-servers
安裝 Docker Engine、設定 apt 來源、建立 kolla 群組、調整防火牆與 /etc/hosts 等。約 3–5 分鐘。
-i ./all-in-one
指定 inventory 檔。之後所有 kolla-ansible 指令都要帶同一個 inventory。
pip install docker dbus-python
Ansible 在本機執行時使用的是 venv 裡的 Python,它需要 docker SDK 來操作容器、需要 dbus-python 來和 systemd 溝通。
07

部署前檢查

在真正部署前,檢查連接埠、網卡、相依套件與設定是否正確。

bash · (venv)
(venv) $ kolla-ansible prechecks -i ./all-in-one --use-test-images

指令解說

prechecks
只檢查、不修改:連接埠是否被佔用、網卡是否存在、Docker 版本、記憶體等。
--use-test-images
預設映像來源 quay.io/openstack.kolla 被官方定位為「測試用」。不加這個參數,prechecks 會刻意失敗並提示你加上它。
讀懂錯誤

失敗時往上找第一個 fatal:,它的 msg 會直接說明原因。修正後重跑 prechecks 即可,不會有副作用。

08

部署 OpenStack

下載映像檔、產生各服務設定、初始化資料庫並啟動所有容器。

bash · (venv)
# (建議)先把映像檔拉下來
(venv) $ kolla-ansible pull -i ./all-in-one
# 正式部署
(venv) $ kolla-ansible deploy -i ./all-in-one

指令解說

pull
只下載所有已啟用服務的容器映像,不建立、不更動任何容器。這一步是選用的,因為 deploy 遇到本機沒有的映像時也會自動下載。先跑 pull 的好處是:網路或映像來源有問題時會先在這裡報錯,而不是部署到一半才中斷;deploy 本身也會跑得比較快。課前也可以先跑好,節省上課時間。
deploy
依序部署 MariaDB、RabbitMQ、Keystone、Glance、Placement、Nova、Neutron、Horizon 等服務。每個服務會:拉映像 → 產生 /etc/kolla/<服務>/ 設定 → bootstrap 資料庫 → 啟動容器 → 註冊 API 端點。
執行時間
在 2 vCPU / 8 GB 的實驗機實測約 32 分鐘,最後會啟動約 34 個容器(含 Heat、Horizon、OVN 等預設服務)。
看到 fatal 先別慌

部署 MariaDB 時會出現一次 fatal: … Timeout when waiting for search string MariaDB in <IP>:3306,緊接著是 ...ignoring。這是 Kolla 在檢查資料庫是否已存在,首次部署時必然逾時,屬於正常現象。只有最後 PLAY RECAP 的 failed 不為 0 才是真的失敗。

等待時可以做的事

另開一個終端機觀察容器陸續啟動:watch sudo docker ps --format 'table {{.Names}}\t{{.Status}}'

09

Post-deploy 與 OpenStack CLI

安裝命令列工具,並產生管理員的連線設定。

bash · (venv)
(venv) $ pip install python-openstackclient -c https://releases.openstack.org/constraints/upper/master
(venv) $ kolla-ansible post-deploy -i ./all-in-one
(venv) $ ls /etc/kolla/*.sh /etc/kolla/clouds.yaml
(venv) $ mkdir -p ~/.config/openstack
(venv) $ cp /etc/kolla/clouds.yaml ~/.config/openstack/clouds.yaml

指令解說

post-deploy
在 /etc/kolla/ 產生 admin-openrc.sh(環境變數形式)與 clouds.yaml(雲端設定檔形式)兩種管理員憑證。
~/.config/openstack/clouds.yaml
openstack CLI 預設會在目前目錄、~/.config/openstack/、/etc/openstack/ 尋找 clouds.yaml,不會找 /etc/kolla/。複製過去後才能用 --os-cloud=kolla-admin。
10

建立第一台 VM

建立示範用的映像檔、網路、規格與金鑰,然後開機。

bash · (venv)
(venv) $ ./venv/share/kolla-ansible/init-runonce
(venv) $ source /etc/kolla/admin-openrc.sh
(venv) $ openstack --os-cloud=kolla-admin server create \
    --image cirros \
    --flavor m1.tiny \
    --key-name mykey \
    --network demo-net \
    demo1

指令解說

init-runonce
示範用腳本,只需執行一次:下載並上傳 cirros 映像、建立 demo-net 與外部網路 public1、建立路由器、開放 ICMP/SSH 的安全群組規則、用 ~/.ssh/id_ecdsa.pub 建立金鑰 mykey、建立 m1.tiny 等 flavor。
source admin-openrc.sh
把 OS_AUTH_URL、OS_USERNAME 等變數載入目前 shell。之後不加 --os-cloud 也能直接下 openstack 指令。
--image cirros
極小型的測試用 Linux 映像,預設帳號 cirros/密碼 gocubsgo。
--flavor m1.tiny
1 vCPU、512 MB RAM、1 GB 磁碟。
--key-name mykey
把公鑰注入 VM,可以用 SSH 金鑰登入。
--network demo-net
VM 接到租戶網路 demo-net(10.0.0.0/24)。
為什麼 init-runonce 不需要複製 clouds.yaml

init-runonce 腳本內部會自己設定 OS_CLIENT_CONFIG_FILE=/etc/kolla/clouds.yaml,所以它能正常執行;但你在 shell 中手動下的 --os-cloud 指令沒有這個變數,因此需要第 09 步的複製動作。

延伸練習

用 openstack console log show demo1 看開機訊息;用 openstack console url show demo1 取得 VNC 主控台網址;用瀏覽器開 http://<主機 IP> 登入 Horizon(帳號 admin,密碼見 passwords.yml 的 keystone_admin_password)。