Régions

Une région est l'emplacement physique où tournent le stockage et le calcul de votre projet. Vous la choisissez une fois, à la création du projet ; chaque branche et endpoint sous ce projet en hérite. La région est une propriété du projet, pas quelque chose que vous changez plus tard.

Le catalogue de régions

GET /v1/regions renvoie les régions dans lesquelles vous pouvez créer des projets. Il est authentifié — le même bearer qui liste vos projets liste le catalogue. La réponse est un objet unique :

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

Chaque région porte :

• region_id — l'identifiant stable que vous passez à la création d'un projet.
• name — le libellé humain affiché dans la liste déroulante de la console.
• default — indique s'il s'agit de la région utilisée quand vous n'en spécifiez pas.
• geo_lat / geo_long — coordonnées pour la sélection basée sur la distance. Elles valent 0 pour le home cluster, qui est du bare metal plutôt qu'une région de cloud public.

Choisir une région à la création

Dans la console web, New project a une liste déroulante Region. Elle a pour défaut Auto (nearest), qui laisse le choix au plan de contrôle — aujourd'hui cela se résout toujours à l'unique région home. Pour épingler une région spécifique, sélectionnez-la dans la liste.

Via l'API, passez le champ optionnel region sur POST /v1/projects :

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

Omettez region (ou envoyez null) pour le même comportement « auto » que le défaut de la console : le plan de contrôle assigne la région par défaut.

L'alpha tourne sur une seule région

Pendant l'alpha, Kisenon tourne sur une région : home-proxmox (« Kisenon Home (Proxmox) »), un cluster bare-metal US. C'est le défaut, donc chaque projet y atterrit que vous définissiez region ou non. Le multi-région est sur la feuille de route ; le catalogue et le champ region sont déjà en place, donc rien ne change côté client quand d'autres régions sont mises en ligne.

Liens connexes

• Projets — le conteneur pour lequel une région est choisie.
• Branches — héritent de la région de leur projet.