리전
프로젝트의 스토리지와 컴퓨트가 위치하는 곳.
리전은 프로젝트의 스토리지와 컴퓨트가 실행되는 물리적 위치입니다. 프로젝트를 생성할 때 한 번 고르며, 그 프로젝트 아래의 모든 브랜치와 엔드포인트가 이를 상속합니다. 리전은 프로젝트의 속성이며, 나중에 변경하는 것이 아닙니다.
리전 카탈로그
GET /v1/regions는 프로젝트를 생성할 수 있는 리전을 반환합니다. 이것은
인증됩니다 — 프로젝트를 나열하는 동일한 bearer가 카탈로그를 나열합니다.
응답은 단일 객체입니다:
{
"regions": [
{
"region_id": "home-proxmox",
"name": "Kisenon Home (Proxmox)",
"default": true,
"geo_lat": 0,
"geo_long": 0
}
]
}각 리전은 다음을 지닙니다:
region_id— 프로젝트를 생성할 때 전달하는 안정적인 식별자.name— 콘솔 드롭다운에 표시되는 사람용 레이블.default— 리전을 지정하지 않을 때 사용되는 리전인지 여부.geo_lat/geo_long— 거리 기반 선택을 위한 좌표. 이들은 홈 클러스터의 경우0이며, 이는 공개 클라우드 리전이 아니라 베어 메탈이기 때문입니다.
생성 시 리전 선택
웹 콘솔에서 새 프로젝트에는 리전 드롭다운이 있습니다. **자동(가장 가까운 곳)**으로 기본 설정되며, 이는 선택을 컨트롤 플레인에 맡깁니다 — 오늘날 그것은 항상 단일 홈 리전으로 해석됩니다. 특정 리전을 고정하려면 목록에서 선택하세요.
API를 통해서는 POST /v1/projects에 선택적 region 필드를 전달하세요:
{ "name": "my-app", "region": "home-proxmox" }콘솔 기본값과 동일한 "자동" 동작을 원하면 region을 생략하세요(또는
null을 보내세요): 컨트롤 플레인이 기본 리전을 할당합니다.
알파는 단일 리전을 실행합니다
알파 기간 동안 Kisenon은 하나의 리전을 실행합니다: home-proxmox("Kisenon
Home (Proxmox)"), 미국 베어 메탈 클러스터. 이것이 기본값이므로, region을
설정하든 안 하든 모든 프로젝트가 거기에 안착합니다. 다중 리전은
로드맵입니다. 카탈로그와 region 필드는 이미 자리 잡고 있으므로 더 많은
리전이 온라인이 되어도 클라이언트에서 바뀌는 것이 없습니다.