> 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)

マスターデータが表示されたら反映は完了です。

マスターデータの登録が必要なマイクロサービスは全てこの方法でマスターデータを登録・更新できます。