Microservices Engine (MSE) を使用すると、コンソールを通じてご利用の Nacos インスタンスに登録されているサービスを管理できます。サービスを作成および削除したり、アプリケーションインスタンス (プロバイダー) を追加したり、インスタンスをオンラインまたはオフラインにしたり、サブスクライバーとプッシュ追跡をモニターしたりできます。
前提条件
開始する前に、次のことを確認してください。
バージョン 2.0.3.0 以降を実行している Nacos エンジンを作成していること。エンジンが以前のバージョンを実行している場合は、まずアップグレードしてください。
サービスページへの移動
すべてのサービス管理操作は、同じページから開始します。まずこれらの手順を完了し、次に各セクションのタスク固有の指示に従ってください。
MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、マイクロサービスレジストリ ＞ インスタンス を選択します。
[インスタンス] ページで、インスタンスの名前をクリックします。
左側のナビゲーションウィンドウで、[サービス管理] > [サービス] を選択します。[名前空間] ドロップダウンリストから名前空間を選択します。
サービスの作成
プロバイダーが登録する前に、サービスを定義またはテストするために Empty サービスを作成します。Empty サービスにはプロバイダーがありません。サービス リストに Empty サービスを表示するには、[Empty サービスを表示] をオンにします。
サービスページに移動した後、次の手順を実行します。
「[サービスの作成]」をクリックします。
[サービスの作成] パネルで次のパラメーターを設定し、[OK] をクリックします。
Nacos 2.1.2.1 以降のパラメーター
| パラメーター | 必須 | タイプ | デフォルト | 説明 |
|---|---|---|---|---|
| Service Name | はい | String | -- | サービスの名前です。 |
| Group Name | はい | String | -- | サービスが属するグループです。 |
| Instance Source | はい | Enum | -- | インスタンスのソースです。有効な値：Console、SDK。 |
| Protection Threshold | はい | Float | -- | システムの機能停止を防ぐための正常なインスタンスの最小比率です。有効な値：0 ～ 1。詳細については、「Protection threshold guidelines」をご参照ください。 |
Nacos 2.0.3.0 から 2.1.2.0 までのパラメーター
| パラメーター | 必須 | タイプ | デフォルト | 説明 |
|---|---|---|---|---|
| Service Name | Yes | String | -- | サービスの名前。 |
| Group Name | Yes | String | -- | サービスが属するグループ。 |
| Persistence | Yes | Boolean | -- | サービスとそのインスタンスが永続化されるかどうか。 |
| Protection Threshold | Yes | Float | 0 | 保護メカニズムがアクティブになる正常なインスタンスの比率。有効な値: 0～1。詳細については、「MSE Microservices Registry の高可用性機能の実装」をご参照ください。 |
保護しきい値のガイドライン
保護しきい値は、最大トラフィックを処理できる最小ノード数の割合に設定します。たとえば、10 個のインスタンスノードが利用可能で、最小 6 個のノードが最大トラフィックを処理できる場合、この値を 0.6 に設定します。
サービスの削除
削除できるのは、プロバイダーが存在しない永続的なサービスのみです。サービスにまだプロバイダーが存在する場合（[プロバイダー数] が 0 でない場合）、[削除] ボタンは選択不可になります。
永続的なサービスは一時的なサービスではありません。サービスが 1 分以上空のままである場合、Nacos インスタンスはサービスを自動的に削除します。
サービスページに移動した後、次の手順を実行します。
対象サービスを検索し、[その他] を [操作] 列でクリックし、[削除] を選択します。
確認ダイアログボックスで、[OK] をクリックします。
サービス詳細の表示
サービスリストには、各サービスの次の列が表示されます。
| 列 | 説明 |
|---|---|
| Service Name | サービスの名前。 |
| Group Name | サービスが属するグループ。 |
| Number of providers | サービスを提供するアプリケーションインスタンスの数。 |
| Number of Clusters | 論理クラスターの数。 |
サービスページに移動した後、サービス名をクリックして詳細ページを開きます。上部セクションには、サービス名、サービスグループ、永続化ステータス、およびクラスター数が表示されます。
[Provider] タブ
このサービスを提供するすべてのアプリケーションインスタンスを、論理クラスターごとに整理してリストします。デフォルトでは、最初の論理クラスターが表示されます。
左側の [すべてのクラスター] セクションで、クラスター名をクリックすると、そのクラスター内のインスタンスが表示されます。
各インスタンスの[操作]列で、重みを編集したり、インスタンスを起動またはシャットダウンしたり、インスタンスを削除したり、そのメタデータを表示したりできます。
[Subscriber] タブ
サービスをサブスクライブするすべてのクライアントを、その IP アドレスとクライアントバージョンを含めてリストします。
[Push track] タブ
サービスのプッシュ追跡の詳細を表示します。
| フィールド | 説明 |
|---|---|
| プッシュ時間 | プッシュが発生した時間。 |
| プッシュクライアント IP アドレス | プッシュを受信したクライアントの IP アドレス。 |
| プッシュサービス名 | プッシュされたサービスの名前。 |
| プッシュサービスグループ | プッシュされたサービスのサービスグループ。 |
| インスタンス数 | プッシュに含まれるインスタンスの数。 |
| ノード名 | プッシュを開始したノードの名前。 |
アプリケーションインスタンスの追加
サービス用のアプリケーションインスタンス (プロバイダー) を MSE コンソールから追加し、稼働開始する前にインスタンスを定義またはテストします。
サービスページに移動した後：
サービス名をクリックして詳細ページを開きます。
[プロバイダー] タブをクリックし、[インスタンスの作成] をクリックします。
[インスタンスの作成] ダイアログボックスで、次のパラメーターを設定し、[OK] をクリックします。
| パラメーター | 必須 | 型 | デフォルト値 | 説明 |
|---|---|---|---|---|
| IP | はい | String | -- | アプリケーションインスタンスの IP アドレスです。 |
| ポート番号 | はい | Integer | -- | アプリケーションインスタンスのポート番号です。 |
| クラスター名 | いいえ | String | DEFAULT | このインスタンスが属する Nacos インスタンス上の論理クラスターです。 |
| 回線のアップ/ダウン ステータス | いいえ | Boolean | はい (オンライン) | インスタンスの初期のオンライン/オフラインステータスです。 |
| 重み | いいえ | -- | 1 | インスタンスのトラフィックの重みです。 有効な値の範囲は 0～10,000 です。 重みが大きいほど、より多くのトラフィックがインスタンスにルーティングされます。 重みの変更が有効にならない場合は、「MSE Nacos インスタンスでアプリケーションインスタンスの重みを変更しても有効にならない場合の対処方法 |
アプリケーションインスタンスの開始またはシャットダウン
ご利用の Nacos インスタンスに登録されているアプリケーションインスタンスをオンラインにするか、オフラインにします。
サービスページに移動した後、次の手順を実行します。
サービス名をクリックして詳細ページを開きます。
[プロバイダー] タブをクリックします。ターゲットインスタンスを見つけて、[操作] 列の [オンライン] または [オフライン] をクリックします。
確認ダイアログボックスで、[OK] をクリックします。