Regiões

Uma região é a localização física onde o storage e o compute do seu projeto rodam. Você a escolhe uma vez, quando cria o projeto; todo branch e endpoint sob esse projeto a herda. Região é uma propriedade do projeto, não algo que você muda depois.

O catálogo de regiões

GET /v1/regions retorna as regiões nas quais você pode criar projetos. Ele é autenticado — o mesmo bearer que lista os seus projetos lista o catálogo. A resposta é um único objeto:

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

Cada região carrega:

• region_id — o identificador estável que você passa ao criar um projeto.
• name — o rótulo legível mostrado no dropdown do console.
• default — se esta é a região usada quando você não especifica uma.
• geo_lat / geo_long — coordenadas para seleção baseada em distância. Elas são 0 para o home cluster, que é bare metal em vez de uma região de nuvem pública.

Escolhendo uma região no momento da criação

No console web, New project tem um dropdown Region. Ele tem como padrão Auto (nearest), que deixa a escolha para o control plane — hoje isso sempre resolve para a única região home. Para fixar uma região específica, selecione-a na lista.

Pela API, passe o campo opcional region em POST /v1/projects:

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

Omita region (ou envie null) para o mesmo comportamento "auto" do padrão do console: o control plane atribui a região padrão.

O alpha roda uma única região

Durante o alpha, a Kisenon roda uma região: home-proxmox ("Kisenon Home (Proxmox)"), um cluster bare-metal nos EUA. Ela é o padrão, então todo projeto aterrissa ali quer você defina region ou não. Multi-região está no roadmap; o catálogo e o campo region já estão no lugar, então nada muda no cliente quando mais regiões entrarem em operação.

Relacionado

• Projetos — o contêiner para o qual uma região é escolhida.
• Branches — herdam a região do seu projeto.