Zum Inhalt springen
Trainingslager IT-Trainingslager

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 db

Drill 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.json

Erwartet (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.json

Erwartet:

ID: 1

Fortschritt speichern? Kostenlos registrieren

Drill 2: Starten

oneflow-template instantiate notes-service

Erwartet:

ID: 2

Beobachten, alle 15 Sekunden:

oneflow list
onevm list

Erwartet: 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; echo

Erwartet:

[{"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 2

Nach 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 2

Kurz darauf:

oneflow list
oneflow show notes-service | sed -n '/LOG MESSAGES/,$p' | tail -3

Erwartet (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-service

Beides 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-service

Eine halbe Minute später:

oneflow list
onevm list

Erwartet (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 --delete prüfst du immer onevm list und räumst Reste von Hand ab.

onevm terminate 26

Die 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-service

Erwartet:

ID: 3

Wenn der Service RUNNING meldet:

oneflow scale notes-service db 2

Erwartet:

Can't scale service 3: Maximum cardinality is 1

Abgelehnt, bevor etwas passiert.

Fortschritt speichern? Kostenlos registrieren

Kontrollpunkt

oneflow list

Erwartet: notes-service mit RUNNING.

onevm list

Erwartet: 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.json

Erwartet: 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 4

Erwartet (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": true wartet straight nicht nur auf RUNNING, sondern bis die VM per OneGate READY=YES meldet. 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: 1 oder ganz außerhalb des Service. Skaliert wird nur, was keinen Zustand hat.