テナントの拡張

obshellでは、以下の2つの方法でテナントを拡張できます：

• APIを呼び出して拡張する

• obshellコマンドを使用して拡張する

本記事では、3レプリカのOceanBaseクラスタを例に、obshellを使用してテナントを拡張する方法（3レプリカから5レプリカへの拡張）を説明します。

前提条件

• OceanBaseクラスタがobshellによって運用管理されていること。詳細な判断方法および接続操作については、非obshellデプロイメントのクラスタの接続を参照してください。

• OceanBaseクラスタのすべてのOBServerノードとobshellが正常に動作していること。

デプロイメントモード

本記事で使用する3台のマシンの構成は以下のとおりです（obshellはデフォルトポート2886を使用します）：

APIによる拡張

ステップ1：クラスタの拡張

OceanBaseクラスタの拡張を参照して、10.10.10.4と10.10.10.5をそれぞれzone4およびzone5に拡張します。

ステップ2：テナントレプリカの追加

任意のobshellでPOST /api/v1/tenant/:name/replicasエンドポイントを呼び出し、テナントtenant1を拡張します。

[admin@test001 ~]$ curl -H "Content-Type: application/json" -H 'X-OCS-Header:${request_headers}' -X POST -d '${request_body}' http://10.10.10.1:2886/api/v1/tenant/tenant1/replicas

{
    "zone_list": [
        {
            "name": "zone4",
            "unit_config_name": "unit_1",
            "unit_num": 1
        }，
        {
            "name": "zone5",
            "unit_config_name": "unit_1",
            "unit_num": 1
        }
    ]
}

...
client = ClientSet("10.10.10.1", 2886, PasswordAuth("****"))
client.v1.add_tenant_replica_sync("tenant1", [ZoneParam("zone4", 'unit_1', 1),
                                          ZoneParam("zone5", 'unit_1', 1))
...

...
req := client.V1().NewScaleOutReplicasRequest("tenant1", []v1.ZoneParam{
        {
            Name:           "zone4",
            ReplicaType:    "FULL",
            UnitConfigName: "unit_1",
            UnitNum:        1,
        },
    {
            Name:           "zone5",
            ReplicaType:    "FULL",
            UnitConfigName: "unit_1",
            UnitNum:        1,
        },
    })
    if _, err = client.V1().ScaleOutReplicasSyncWithRequest(req); err != nil {
        fmt.Print(err)
    }
...

ステップ3：テナント情報を確認する

任意のobshellでGET /api/v1/tenant/:nameインターフェースを呼び出すと、拡張後のテナント情報を確認できます。

[admin@test001 ~]$ curl -H "Content-Type: application/json" -H 'X-OCS-Header:${request_headers}' -X GET http://10.10.10.1:2886/api/v1/tenant/tenant1

...
client = ClientSet("10.10.11", 2886, PasswordAuth("****"))
tenant_info = client.v1.get_tenant_info("tenant1")
...

...
client, err := services.NewClientWithPassword("10.10.10.1", 2886, "****")
tenant, err := client.V1().GetTenantInfo("tenant1")
...

obshellコマンドによるスケールアウト

ステップ1：クラスタのスケールアウト

OceanBaseクラスタのスケールアウトを参照し、10.10.10.4と10.10.10.5をそれぞれzone4とzone5にスケールアウトします。

ステップ2：新規テナントレプリカの追加

任意のノードで以下のコマンドを実行することで、テナントtenant1のzone4およびzone5へのレプリカを追加できます。コマンドの詳細は、obshell テナントコマンドグループのobshell tenant replica addのセクションを参照してください。

[admin@test001 ~]$ /home/admin/oceanbase/bin/obshell tenant replica add tenant1 -z zone4,zone5 -u unit_1

例におけるunit_1はテナントtenant1が使用するリソース構成であり、実際の状況に応じて設定する必要があります。新しいリソースユニットを作成したい場合は、ドキュメントテナントの作成のステップ1：リソース構成の作成を参照してください。

ステップ3：テナント情報の確認

任意のノードで以下のコマンドを実行することで、指定されたテナントの情報を確認できます。コマンドの詳細は、obshell テナントコマンドグループのobshell tenant showのセクションを参照してください。

[admin@test001 ~]$ /home/admin/oceanbase/bin/obshell tenant show tenant1