> For the complete documentation index, see [llms.txt](/llms.txt)

# 관리 콘솔을 사용한 설정

관리 콘솔을 사용하여 마이크로서비스에 리소스를 생성한다




개발자가 가장 먼저 관리 콘솔에서 해야 할 일은 네임스페이스 생성과 마스터 데이터 등록입니다.
이 작업들은 관리 콘솔에서 생성할 수 있습니다.

## 리전 선택

![select_region.png](select_region.png)

사이드 메뉴 하단에 리전 메뉴가 있습니다.
여기에서 마이크로서비스를 조작할 리전을 선택할 수 있습니다.

## 네임스페이스 생성

관리 콘솔에 로그인하고 마이크로서비스를 선택합니다.

![list_namespaces.png](list_namespaces.png)

네임스페이스 목록이 표시되면 네임스페이스를 새로 생성합니다.

![create_namespace.png](create_namespace.png)

설정 항목에 값을 입력하고 확정하면 네임스페이스 생성이 완료됩니다.

## 마스터 데이터 등록

마이크로서비스에 따라서는 기능을 이용하기 전에 마스터 데이터 등록이 필요한 경우가 있습니다.

마스터 데이터 등록이 필요한 마이크로서비스에는 네임스페이스 상세 페이지에 "마스터 데이터"라는 탭이 있습니다.

![master_data_pane.png](master_data_pane.png)

탭을 선택하면 "Currently available master data could not be found"라는 오류가 표시되며, 아직 마스터 데이터가 등록되지 않았음을 알 수 있습니다.

### 마스터 데이터 에디터 이용

마스터 데이터를 작성하려면 마스터 데이터 에디터를 이용할 수 있습니다.

네임스페이스 상세 페이지에 "마스터 데이터 에디터"라는 탭이 있으니 그것을 선택합니다.

![master_data_editor_pane.png](master_data_editor_pane.png)

이 스크린샷은 GS2-Inventory의 예시입니다.
마스터 데이터 작성에 대해 설명하기 위해, GS2-Inventory가 어떤 마스터 데이터를 필요로 하는지 설명하겠습니다.

```plantuml
class InventoryModel {
  +string 이름
  +int 초기 크기
  +int 최대 크기
}

class ItemModel {
  +string 이름
  +int 스택 가능한 최대 수량
  +bool 스택 가능한 최대 수량을 초과했을 때, 여러 슬롯에 아이템을 보관하는 것을 허용할지 여부
  +int 표시 순서
}

Namespace "1" *-- "many" InventoryModel
InventoryModel "1" *-- "many" ItemModel
```

GS2-Inventory에는 용량 제한이 있는 Inventory와, Inventory에 담을 수 있는 Item의 정의가 필요합니다.
Inventory에는 초기 용량과 최대 용량을, Item에는 1용량당 최대 몇 개의 아이템을 스택할 수 있는지, 아이템 소지 수량이 스택 가능한 최대치에 도달했을 때 2번째 스택을 만들지 여부를 설정합니다.

#### Inventory Model 작성

먼저 마스터 데이터 에디터를 사용하여 Inventory Model을 작성해 봅시다.

![create_inventory_model.png](create_inventory_model.png)

각 항목에 값을 입력하고 작성 버튼을 누릅니다.

![list_inventory_models.png](list_inventory_models.png)

Inventory Model 목록에 추가되면, 작성한 Inventory Model을 선택하여 상세 페이지를 엽니다.

#### Item Model 작성

![detail_of_inventory.png](detail_of_inventory.png)

Inventory Model의 상세 페이지를 열면, 다음으로 Item Model을 작성하는 메뉴가 있습니다.
선택하여 Item Model을 작성합니다.

![create_item_model.png](create_item_model.png)

각 항목에 값을 입력하고 작성 버튼을 누릅니다.

#### 마스터 데이터 내보내기

등록이 끝나면 마스터 데이터를 내보냅니다. 네임스페이스 상세 페이지로 돌아가서 마스터 데이터 에디터 탭을 선택해 주세요.

![export_master_data.png](export_master_data.png)

탭 페인 상단에 있는 내보내기 버튼을 누릅니다.

![master_data_json.png](master_data_json.png)

마스터 데이터의 JSON 파일이 출력됩니다.

마스터 데이터는 이러한 JSON 파일로 관리됩니다.

따라서 반드시 관리 콘솔의 마스터 데이터 에디터를 사용하지 않더라도, 스프레드시트로 관리하고 있는 마스터 데이터를 내보내는 프로그램을 준비해도 문제없습니다.

마스터 데이터의 JSON 포맷은 각 마이크로서비스의 프로그래밍 가이드에 상세히 기재되어 있습니다.

### 마스터 데이터 반영

조금 전 마스터 데이터 등록이 없다는 오류가 발생했던 "마스터 데이터" 탭을 다시 선택합니다.

![import_master_data.png](import_master_data.png)

마스터 데이터를 업로드하기 위한 메뉴를 선택합니다.

![import_master_data2.png](import_master_data2.png)

내보낸 JSON 파일을 선택하여 업로드합니다.

![exists_master_data.png](exists_master_data.png)

마스터 데이터가 표시되면 반영이 완료됩니다.

마스터 데이터 등록이 필요한 마이크로서비스는 모두 이 방법으로 마스터 데이터를 등록·갱신할 수 있습니다.