Regiones

Una región es la ubicación física en la que se ejecutan el almacenamiento y el cómputo de su proyecto. La elige una vez, cuando crea el proyecto; cada rama y endpoint bajo ese proyecto la hereda. La región es una propiedad del proyecto, no algo que cambie más tarde.

El catálogo de regiones

GET /v1/regions devuelve las regiones en las que puede crear proyectos. Está autenticado — el mismo bearer que lista sus proyectos lista el catálogo. La respuesta es un único objeto:

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

Cada región lleva:

• region_id — el identificador estable que pasa al crear un proyecto.
• name — la etiqueta legible mostrada en el desplegable de la consola.
• default — si esta es la región usada cuando no especifica una.
• geo_lat / geo_long — coordenadas para la selección basada en distancia. Son 0 para el clúster doméstico, que es bare metal en vez de una región de nube pública.

Elegir una región en el momento de crear

En la consola web, New project tiene un desplegable Region. Usa por defecto Auto (nearest), que deja la elección al plano de control — hoy eso siempre se resuelve a la única región doméstica. Para fijar una región específica, selecciónela de la lista.

Por la API, pase el campo opcional region en POST /v1/projects:

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

Omita region (o envíe null) para el mismo comportamiento "auto" que el predeterminado de la consola: el plano de control asigna la región predeterminada.

La alpha funciona con una única región

Durante la alpha, Kisenon funciona con una región: home-proxmox ("Kisenon Home (Proxmox)"), un clúster bare metal de EE. UU. Es la predeterminada, así que cada proyecto aterriza allí establezca o no region. El multirregión está en la hoja de ruta; el catálogo y el campo region ya están en su sitio, así que nada cambia en el cliente cuando más regiones entren en línea.

Relacionado

• Proyectos — el contenedor para el que se elige una región.
• Ramas — heredan la región de su proyecto.