Tag 1: miniONE
Ziel: OpenNebula mit einem Befehl installieren, die CLI einrichten, die erste VM starten und sich in Sunstone umsehen. · Dauer: ca. 60 min · Voraussetzung: Tag 0
Briefing
- miniONE ist das offizielle Installationsskript für eine Ein-Rechner-Installation. Es installiert Frontend und KVM-Host, richtet eine Bridge mit NAT ein und lädt ein kleines Alpine-Linux aus dem Marketplace. Für Tests und zum Lernen gedacht, nicht für den Betrieb.
- Was miniONE baut:
| Teil | Was |
|---|---|
oned |
der Kern: verwaltet alle Objekte, spricht mit Treibern, hält die Datenbank |
| MariaDB | Datenbank von oned |
| Sunstone (FireEdge) | Weboberfläche auf Port 80 |
| OneFlow, OneGate | Dienste für Mehr-VM-Services (Tag 9) und für Rückmeldungen aus VMs (Tag 11) |
Host localhost |
der KVM-Hypervisor, auf dem die VMs laufen |
Bridge minionebr |
privates Netz 192.168.150.0/24 mit NAT ins Internet |
- Der Verwalter heißt
oneadmin. Unter diesem Namen läuft OpenNebula, und er ist der erste Benutzer mit allen Rechten.
Drill 1: Installation
cd ~/one-lab
curl -fsSLO https://github.com/OpenNebula/minione/releases/download/v7.4.2/minione
sudo bash minione --yes --password lab-one-pass-123 \
--ssh-pubkey ~/.ssh/id_ed25519.pub \
--vnet-address 192.168.150.0 --vnet-gateway 192.168.150.1 \
--vnet-ar-ip-start 192.168.150.2 --vnet-ar-ip-count 50| Option | Wofür |
|---|---|
--yes |
nicht nachfragen |
--password |
Passwort für oneadmin, ein reiner Lab-Wert |
--ssh-pubkey |
dieser Schlüssel landet in jeder VM |
--vnet-* |
das private Netz der VMs. Der Standard 172.16.100.0/24 stößt in vielen Heimnetzen mit vorhandenen 172.16er-Netzen zusammen, 192.168.150.0/24 ist seltener belegt. |
Das dauert fünf bis zehn Minuten. Erwartet (gekürzt):
### Checks & detection
Checking augeas is installed SKIP will try to install
...
### Main deployment steps:
Install OpenNebula frontend version 7.4
Install and configure MariaDB (MySQL backend)
Configure bridge minionebr with IP 192.168.150.1/24
Enable NAT over eth0
...
### Installation
...
Installing OpenNebula packages OK
Installing OpenNebula kvm node packages OK
...
### Configuration
...
Creating kvm host OK
Creating virtual network OK
Exporting [Alpine Linux 3.20] from Marketplace to local datastore OK
...
### Report
OpenNebula 7.4 was installed
Database backend: MySQL (MariaDB), database 'opennebula'
Sunstone is running on:
http://<VM-IP>/
Use following to login:
user: oneadmin
password: lab-one-pass-123
Fortschritt speichern? Kostenlos registrieren
Drill 2: Ein Stolperstein bei DNS
Die VMs bekommen ihre Adressen und Namensauflösung von dnsmasq auf der Bridge. Unter Ubuntu 24.04 fehlt dnsmasq nach miniONE aber ein Server, an den es Anfragen weitergibt:
nslookup dl-cdn.alpinelinux.org 192.168.150.1Erwartet (gekürzt):
** server can't find dl-cdn.alpinelinux.org: REFUSED
dnsmasq sucht seine Upstream-Server in einer Datei, die das Paket
resolvconf anlegen würde. Ubuntu nutzt stattdessen
systemd-resolved, also bleibt die Datei leer. Eine Zeile sagt dnsmasq,
dass es die normale /etc/resolv.conf nehmen soll:
echo "IGNORE_RESOLVCONF=yes" | sudo tee -a /etc/default/dnsmasq
sudo systemctl restart dnsmasq
nslookup dl-cdn.alpinelinux.org 192.168.150.1 | tail -3Erwartet (die Adresse weicht ab):
IGNORE_RESOLVCONF=yes
Name: dualstack.j.sni.global.fastly.net
Address: 2a04:4e42:600::644
Ohne diese Korrektur kommen die VMs zwar ins Internet, finden aber
keinen Rechner beim Namen. Paketinstallationen in den VMs scheitern dann
mit temporary error.
Fortschritt speichern? Kostenlos registrieren
Drill 3: Die CLI
Die Befehle der CLI heißen alle one…:
onevm, onetemplate, oneimage und
so weiter. Sie lesen Benutzer und Passwort aus
~/.one/one_auth:
mkdir -p ~/.one
echo "oneadmin:lab-one-pass-123" > ~/.one/one_auth
chmod 600 ~/.one/one_auth
onehost listErwartet:
ID NAME CLUSTER TVM ALLOCATED_CPU ALLOCATED_MEM STAT
0 localhost default 0 0 / 200 (0%) 0K / 3.8G (0%) on
TVMist die Zahl der laufenden VMs.200steht für zwei CPU-Kerne. OpenNebula rechnet in Hundertsteln eines Kerns.STAT onheißt: Der Host wird überwacht und nimmt VMs an.
Ohne one_auth endet jeder Befehl mit
ONE_AUTH file not present.
onetemplate listErwartet (die Zeit weicht ab):
ID USER GROUP NAME REGTIME
1 oneadmin oneadmin Alpine Linux 3. 11/12 18:45:16
0 oneadmin oneadmin OneKS Appliance 11/12 18:45:13
Zwei Vorlagen. Die erste ist Alpine. Die zweite, „OneKS Appliance“, baut einen ganzen Kubernetes-Cluster und braucht weit mehr als 4 GB. Für dieses Buch lässt du sie liegen.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die erste VM
onetemplate instantiate 1 --name ersteErwartet:
VM ID: 3
Deine ID kann abweichen. Ab jetzt sprichst du die VM mit ihrem Namen an:
onevm listErwartet (erst boot, nach ein paar Sekunden
runn):
ID USER GROUP NAME STAT CPU MEM HOST TIME
3 oneadmin oneadmin erste runn 1 256M localhost 0d 00h00
onevm show erste | grep -E '^STATE|^LCM_STATE|ETH0_IP='Erwartet (die IP weicht ab):
STATE : ACTIVE
LCM_STATE : RUNNING
ETH0_IP="192.168.150.5",
OpenNebula hat zwei Zustände: STATE ist der grobe
Zustand (PENDING, ACTIVE,
POWEROFF …), LCM_STATE der Schritt im
Lebenszyklus, solange die VM ACTIVE ist.
Und jetzt hinein, mit deinem Schlüssel aus Tag 0. Vorher eine
Erleichterung fürs Lab: VMs kommen und gehen, und eine IP gehört morgen
einer anderen VM mit anderem Host-Schlüssel. SSH würde dann jedes Mal
Alarm schlagen. Für die Lab-Netze schaltest du die Prüfung ab und setzt
root als Benutzer:
cat >> ~/.ssh/config <<'EOF'
Host 192.168.150.* 10.10.10.*
User root
StrictHostKeyChecking no
UserKnownHostsFile /dev/null
LogLevel ERROR
EOF
chmod 600 ~/.ssh/configDas gilt nur für diese beiden Adressbereiche. Außerhalb des Labs prüfst du Host-Schlüssel immer.
ssh [email protected] cat /etc/alpine-releaseErwartet:
3.20.10
Fortschritt speichern? Kostenlos registrieren
Drill 5: Sunstone
Öffne im Browser http://<VM-IP>/. Die Adresse
leitet auf /fireedge/sunstone weiter. Melde dich als
oneadmin mit lab-one-pass-123 an.
- Links im Menü Instances → VMs: Dort steht
erste, mit Zustand und IP. - Ein Klick auf die VM und dann auf das Bildschirm-Symbol öffnet die VNC-Konsole. Das ist der Weg in eine VM, wenn SSH nicht geht.
- Infrastructure → Hosts zeigt
localhostmit Auslastung.
Alles, was Sunstone zeigt und tut, geht auch mit der CLI. Dieses Buch nutzt meist die CLI, weil sich Befehle besser abtippen und prüfen lassen als Klicks.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
onehost listErwartet: localhost mit STAT
on.
onevm listErwartet: die VM erste mit STAT
runn.
ssh root@$(onevm show erste | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2) hostnameErwartet: eine Ausgabe ohne Fehler. Der grep holt die IP
aus onevm show, du musst sie also nicht abtippen.
Challenge
Durch welche Zustände ist erste gegangen, bevor sie
lief? Finde es heraus, ohne Sunstone.
Hinweis: Jede VM hat eine Logdatei unter
/var/log/one/, benannt nach ihrer ID.
Lösung
sudo grep 'New .*state' /var/log/one/3.logErwartet (Zeiten weichen ab, gekürzt):
… [Z0][VM][I]: New state is ACTIVE
… [Z0][VM][I]: New LCM state is PROLOG
… [Z0][VM][I]: New LCM state is BOOT
… [Z0][VM][I]: New LCM state is RUNNING
| Zustand | Was passiert |
|---|---|
PENDING (vor ACTIVE) |
Der Scheduler sucht einen Host. |
PROLOG |
Die Platten werden in den System-Datastore kopiert (Tag 3). |
BOOT |
libvirt startet die VM. |
RUNNING |
Die VM läuft. |
Die VM brauchst du nicht mehr:
onevm terminate ersteFortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Installation im Betrieb: Statt miniONE installiert
man die Pakete aus dem OpenNebula-Repository oder nutzt die
Ansible-Rollen
one-deploy. Die richten auch mehrere Hosts, geteilten Speicher und ein hochverfügbares Frontend ein. - Zugangsdaten:
one_authmit Klartext-Passwort ist bequem fürs Lab. Im Betrieb nutzen Admins Login-Tokens (oneuser token-create) mit Ablaufzeit, und Sunstone hängt an LDAP oder SAML. - Community und Enterprise: Die Community Edition ist
frei. Die Enterprise Edition bringt Wartungs-Releases und Support.
miniONE kann beide installieren (
--enterprise).