Tag 9: OneFlow
Ziel: notes-api und Postgres als einen Service mit zwei Rollen beschreiben, in der richtigen Reihenfolge starten, die API skalieren und einen Service retten, der beim Skalieren hängen bleibt. · Dauer: ca. 75 min · Voraussetzung: Tag 8
Briefing
- OneFlow fasst mehrere VMs zu einem Service zusammen. Ein Service-Template (JSON) beschreibt Rollen: Welches VM-Template, wie viele VMs (cardinality), wer vor wem startet (parents).
"deployment": "straight"heißt: Eine Rolle startet erst, wenn alle ihre Eltern laufen. Ohne diese Angabe starten alle Rollen gleichzeitig, wie in Tag 6.- Ein Service hat eigene Zustände:
DEPLOYING,RUNNING,SCALING,COOLDOWN(Pause nach dem Skalieren),FAILED_….
Service notes-service (straight)
Rolle db (notes-db, 1 VM, fest: min 1 / max 1)
└─► Rolle api (notes, 1..n VMs, parents: db)
Die einzelnen VMs aus Tag 6 müssen weg, denn die Datenplatte
notes-daten kann nur eine VM gleichzeitig nutzen:
onevm terminate notes
onevm terminate dbDrill 1: Das Service-Template
Rollen zeigen per ID auf VM-Templates. Die IDs weichen bei dir ab,
also setzt du sie per awk ein:
mkdir -p ~/one-lab/tag09
cd ~/one-lab/tag09
cat > notes-service.json <<'EOF'
{
"name": "notes-service",
"deployment": "straight",
"roles": [
{
"name": "db",
"type": "vm",
"template_id": DB_ID,
"cardinality": 1,
"user_inputs_values": {
"DB_PASSWORD": "lab-db-pass-123"
}
},
{
"name": "api",
"type": "vm",
"template_id": API_ID,
"cardinality": 1,
"parents": [ "db" ],
"user_inputs_values": {
"DB_PASSWORD": "lab-db-pass-123",
"API_KEY": "lab-api-key-123",
"NOTES_VERSION": "0.7.1"
}
}
]
}
EOF
sed -i "s/DB_ID/$(onetemplate show notes-db | awk '/^ID/ {print $3}')/" notes-service.json
sed -i "s/API_ID/$(onetemplate show notes | awk '/^ID/ {print $3}')/" notes-service.json
grep template_id notes-service.jsonErwartet (deine IDs):
"template_id": 4,
"template_id": 5,
user_inputs_values füllt die USER_INPUTS der
VM-Templates aus Tag 6. Ohne sie würde OneFlow nicht starten, denn die
Passwörter sind Pflicht.
oneflow-template create notes-service.jsonErwartet:
ID: 1
Fortschritt speichern? Kostenlos registrieren
Drill 2: Starten
oneflow-template instantiate notes-serviceErwartet:
ID: 2
Beobachten, alle 15 Sekunden:
oneflow list
onevm listErwartet: Erst entsteht nur db_0_(service_2). Die API-VM
kommt erst, wenn die Datenbank läuft. Nach gut einer Minute:
ID USER GROUP NAME STARTTIME STAT
2 oneadmin oneadmin notes-service 11/12 19:55:10 RUNNING
ID USER GROUP NAME STAT CPU MEM HOST TIME
27 oneadmin oneadmin api_0_(service_ runn 0.5 384M localhost 0d 00h01
26 oneadmin oneadmin db_0_(service_2 runn 0.5 512M localhost 0d 00h02
oneflow show notes-service | sed -n '/ROLE api/,$p'Erwartet (gekürzt):
ROLE api
ROLE STATE : RUNNING
PARENTS : db
CARDINALITY : 1
...
LOG MESSAGES
11/12/26 19:55 [I] New state: DEPLOYING_NETS
11/12/26 19:55 [I] New state: DEPLOYING
11/12/26 19:56 [I] New state: RUNNING
Und die Notiz von gestern? Die Datenplatte ist dieselbe:
V=$(onevm list --no-header | grep api_0 | awk '{print $1}')
IP=$(onevm show $V | grep -o 'ETH0_IP="[0-9.]*' | cut -d'"' -f2)
curl -s $IP:8080/notes; echoErwartet:
[{"id":"602722bb-05ab-4559-ac6e-47609ba9ab2b","text":"Hallo OpenNebula"}]
Fortschritt speichern? Kostenlos registrieren
Drill 3: Skalieren
Zwei API-VMs statt einer:
oneflow scale notes-service api 2Nach zwei Minuten:
oneflow show notes-service | sed -n '/ROLE api/,/LOG MESSAGES/p'Erwartet (gekürzt):
ROLE api
ROLE STATE : COOLDOWN
PARENTS : db
CARDINALITY : 2
...
27 api_0_(service_2) oneadmin oneadmin
28 api_1_(service_2) oneadmin oneadmin
Die zweite API-VM spricht mit derselben Datenbank und liefert
dieselbe Notiz. Danach folgt COOLDOWN: fünf Minuten Pause,
in denen der Service nicht weiter skaliert. Das schützt vor Pendeln,
wenn eine automatische Regel (Tag 11) zu schnell reagiert.
Fortschritt speichern? Kostenlos registrieren
Drill 4: Die Rolle, die nicht skalieren darf
Nach dem Cooldown probierst du dasselbe mit der Datenbank:
oneflow scale notes-service db 2Kurz darauf:
oneflow list
oneflow show notes-service | sed -n '/LOG MESSAGES/,$p' | tail -3Erwartet (gekürzt):
2 oneadmin oneadmin notes-service 11/12 19:55:10 FAILED_SCALING
11/12/26 20:03 [I] Role db scaling up from 1 to 2 nodes
11/12/26 20:03 [E] Role db : Instantiate failed for template 4; [one.template.instantiate] Error allocating a new virtual machine template. Cannot get IP/MAC lease from virtual network 1.
11/12/26 20:03 [I] New state: FAILED_SCALING
Die zweite Datenbank-VM bekommt die feste IP 10.10.10.20 nicht, die erste hat sie. Hätte es die IP gegeben, wäre spätestens die persistente Platte gescheitert. Und jetzt?
oneflow scale notes-service db 1
oneflow update notes-serviceBeides endet mit
Service cannot be … in state: FAILED_SCALING.
oneflow recover notes-service versucht es nur noch einmal,
mit demselben Fehler. Der Ausweg aus dem Lab: den Service löschen. Die
Daten liegen auf der persistenten Platte und überleben das.
oneflow recover --delete notes-serviceEine halbe Minute später:
oneflow list
onevm listErwartet (gekürzt):
ID USER GROUP NAME STARTTIME STAT
ID USER GROUP NAME STAT CPU MEM HOST TIME
26 oneadmin oneadmin db_0_(service_2 runn 0.5 512M localhost 0d 00h12
Ausprobiert: Der Service ist weg, die API-VMs auch, aber die Datenbank-VM läuft weiter, als Waise ohne Service. Sie hält die Datenplatte und die IP fest. Nach einem
recover --deleteprüfst du immeronevm listund räumst Reste von Hand ab.
onevm terminate 26Die ID ist deine aus onevm list.
Fortschritt speichern? Kostenlos registrieren
Drill 5: Vorbeugen
Eine Rolle mit Zustand soll gar nicht skalieren können.
min_vms und max_vms legen die Grenzen
fest:
jq '(.roles[] | select(.name=="db")) += {"min_vms": 1, "max_vms": 1}' notes-service.json \
> neu.json && mv neu.json notes-service.json
oneflow-template update notes-service notes-service.json
oneflow-template instantiate notes-serviceErwartet:
ID: 3
Wenn der Service RUNNING meldet:
oneflow scale notes-service db 2Erwartet:
Can't scale service 3: Maximum cardinality is 1
Abgelehnt, bevor etwas passiert.
Fortschritt speichern? Kostenlos registrieren
Kontrollpunkt
oneflow listErwartet: notes-service mit RUNNING.
onevm listErwartet: genau db_0_(service_3) und
api_0_(service_3), keine Waisen.
diff ~/one-lab/tag09/notes-service.json ~/one-lab/code/loesung/tag09/notes-service.jsonErwartet: keine Ausgabe, wenn deine Template-IDs 4 und 5 sind. Sonst unterscheiden sich nur diese beiden Zeilen.
Challenge
Die API-Rolle soll ebenfalls Grenzen bekommen: mindestens 1,
höchstens 3 VMs. Ändere den laufenden Service, ohne ihn neu anzulegen,
und prüf, dass scale … api 4 abgelehnt wird.
Hinweis: oneflow update nimmt eine
Datei mit dem ganzen Service-Dokument. Das aktuelle Dokument steht in
oneflow show … --json.
Lösung
oneflow show notes-service --json | jq '.DOCUMENT.TEMPLATE.BODY' > body.json
jq '(.roles[] | select(.name=="api")) += {"min_vms": 1, "max_vms": 3}' body.json > body2.json
oneflow update notes-service body2.json
oneflow scale notes-service api 4Erwartet (gekürzt):
Can't scale service 3: Maximum cardinality is 3
Das Service-Template bleibt davon unberührt. Willst du die Grenze
auch für künftige Services, gehört sie zusätzlich in
notes-service.json.
Fortschritt speichern? Kostenlos registrieren
Enterprise-Notiz
- Elastizität: Rollen können Regeln haben, etwa „eine
VM mehr, wenn die CPU-Last im Schnitt über 80 Prozent liegt“
(
elasticity_policies). Die Werte melden die VMs per OneGate (Tag 11). - Readiness: Mit
"ready_status_gate": truewartetstraightnicht nur aufRUNNING, sondern bis die VM per OneGateREADY=YESmeldet. Dann startet die API wirklich erst, wenn Postgres Verbindungen annimmt. - Zustand gehört nicht in skalierende Rollen:
Datenbanken gehören in eigene Rollen mit
max_vms: 1oder ganz außerhalb des Service. Skaliert wird nur, was keinen Zustand hat.