Regionen

Eine Region ist der physische Ort, an dem der Speicher und das Compute Ihres Projekts laufen. Sie wählen sie einmal, wenn Sie das Projekt erstellen; jeder Branch und Endpoint unter diesem Projekt erbt sie. Die Region ist eine Eigenschaft des Projekts, nichts, das Sie später ändern.

Der Regionskatalog

GET /v1/regions gibt die Regionen zurück, in denen Sie Projekte erstellen können. Er ist authentifiziert — derselbe Bearer, der Ihre Projekte auflistet, listet den Katalog. Die Antwort ist ein einzelnes Objekt:

{
  "regions": [
    {
      "region_id": "home-proxmox",
      "name": "Kisenon Home (Proxmox)",
      "default": true,
      "geo_lat": 0,
      "geo_long": 0
    }
  ]
}

Jede Region trägt:

• region_id — der stabile Bezeichner, den Sie beim Erstellen eines Projekts übergeben.
• name — das menschliche Label, das im Konsolen-Dropdown angezeigt wird.
• default — ob dies die Region ist, die verwendet wird, wenn Sie keine angeben.
• geo_lat / geo_long — Koordinaten für distanzbasierte Auswahl. Sie sind 0 für den Home-Cluster, der Bare Metal statt einer Public-Cloud-Region ist.

Eine Region zur Erstellungszeit wählen

In der Web-Konsole hat New project ein Region-Dropdown. Es ist standardmäßig auf Auto (nearest) gesetzt, was die Wahl der Control Plane überlässt — heute löst das immer zur einzigen Home-Region auf. Um eine bestimmte Region festzulegen, wählen Sie sie aus der Liste.

Über die API übergeben Sie das optionale region-Feld bei POST /v1/projects:

{ "name": "my-app", "region": "home-proxmox" }

Lassen Sie region weg (oder senden Sie null) für dasselbe „Auto"-Verhalten wie der Konsolenstandard: Die Control Plane weist die Standardregion zu.

Die Alpha läuft mit einer einzigen Region

Während der Alpha läuft Kisenon mit einer Region: home-proxmox („Kisenon Home (Proxmox)"), einem US-Bare-Metal-Cluster. Sie ist der Standard, sodass jedes Projekt dort landet, ob Sie region setzen oder nicht. Multi-Region ist Roadmap; der Katalog und das region-Feld sind bereits vorhanden, sodass sich nichts beim Client ändert, wenn weitere Regionen online gehen.

Verwandtes

• Projekte — der Container, für den eine Region gewählt wird.
• Branches — erben die Region ihres Projekts.