環境與架構
以下指令都在主機上以 ubuntu 身分執行(需要 sudo 權限)。用 ip -br a 確認管理網卡名稱是 ens3 並記下它的 IPv4 位址,第 05 步會用到。
$ 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 磁碟。 &&- 前一個指令成功才執行下一個,這裡用來一次看完三項硬體資訊。
安裝系統套件
安裝編譯 Python 套件需要的工具與標頭檔。
$ sudo apt update $ sudo apt install -y git python3-dev libffi-dev gcc libssl-dev libdbus-glib-1-dev python3-venv
建立 Python 虛擬環境
把 Kolla-Ansible 和 Ansible 裝在獨立的環境裡,不污染系統 Python。
$ 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。
安裝 Kolla-Ansible 並準備設定檔
安裝部署工具,並把範例設定與 inventory 複製出來。
(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 不會讀取。
安裝 Galaxy 依賴並產生密碼
補齊 Ansible collections,並一次產生所有服務的隨機密碼。
(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中所有空白欄位,並把檔案權限改成只有擁有者可讀。重複執行不會覆蓋已存在的密碼。
建立外部網卡並設定 globals.yml
在部署前告訴 Kolla:用哪個發行版、哪張網卡、API 位址是什麼。
這一步必須在 bootstrap / prechecks / deploy 之前完成。所有 kolla-ansible 指令都會讀取 globals.yml,部署完才改設定會造成網卡與 API 位址錯誤。
5-1 建立 veth-ext。實驗機只有一張 ens3,用一對 veth 當作 Neutron 的外部網卡:
$ 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 寫成設定檔,開機時就會自動建立並啟用:
$ 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(kolla_internal_vip_address)會在上課時提供,請把下方的 10.127.0.X 換成你拿到的位址,不要照抄範例。
(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 也一併關閉。
關閉 HAProxy 後就沒有 keepalived 去「掛上」VIP,因此 kolla_internal_vip_address 必須填 ens3 上已存在的 IP。若填一個沒人使用或被別台機器佔用的位址(例如原講義的 10.127.0.34),服務會無法互相連線。
Bootstrap 主機
安裝 Docker 與部署所需的主機層級設定,並補齊 venv 內的 Python 模組。
(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,它需要
dockerSDK 來操作容器、需要dbus-python來和 systemd 溝通。
部署前檢查
在真正部署前,檢查連接埠、網卡、相依套件與設定是否正確。
(venv) $ kolla-ansible prechecks -i ./all-in-one --use-test-images指令解說
prechecks- 只檢查、不修改:連接埠是否被佔用、網卡是否存在、Docker 版本、記憶體等。
--use-test-images- 預設映像來源
quay.io/openstack.kolla被官方定位為「測試用」。不加這個參數,prechecks 會刻意失敗並提示你加上它。
失敗時往上找第一個 fatal:,它的 msg 會直接說明原因。修正後重跑 prechecks 即可,不會有副作用。
部署 OpenStack
下載映像檔、產生各服務設定、初始化資料庫並啟動所有容器。
# (建議)先把映像檔拉下來 (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 等預設服務)。
部署 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}}'
Post-deploy 與 OpenStack CLI
安裝命令列工具,並產生管理員的連線設定。
(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。
建立第一台 VM
建立示範用的映像檔、網路、規格與金鑰,然後開機。
(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 腳本內部會自己設定 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)。