Nacos の構成により、アプリケーション設定 (機能フラグ、接続プール、ログレベルなど) を外部化し、コードを再デプロイすることなくランタイムで更新できます。各構成は、[Data ID]、[Group]、および [Namespace] の一意の組み合わせによって識別されます。
前提条件
開始する前に、以下をご確認ください。
有効化された Microservices Engine (MSE) サブスクリプション (MSE の有効化)
Nacos 1.2.1 以降を実行している MSE Nacos インスタンス (Nacos エンジンの作成)
コンソールでの構成の作成
MSE コンソールにログインし、上部のナビゲーションバーでリージョンを選択します。
左側のナビゲーションウィンドウで、[マイクロサービスレジストリ] > [インスタンス] を選択します。
[インスタンス] ページで、インスタンス名をクリックします。
左側のナビゲーションウィンドウで、[設定管理] > [構成] を選択します。
[構成] ページで、左上の [Namespace] ドロップダウンリストから名前空間を選択し、[構成の追加] をクリックします。
Add Configuration パネルで、次のパラメーターを設定し、Release をクリックします。
パラメーター 必須 説明 Region -- 現在の Nacos インスタンスから自動的に入力されます。変更はできません。 Namespace -- ステップ 5 で選択した名前空間から自動的に入力されます。変更はできません。 [Data ID] はい グループ内での構成の一意の識別子です。 package.classのような命名規則を使用します (例:com.foo.bar.log.level)。グループ はい 関連する構成の論理的なグループです。 order-serviceやpayment-moduleのようなプロダクト名またはモジュール名を使用します。一意である必要があります。Data Encryption いいえ データベース認証情報などの機密性の高い値を保護するために、構成内容を暗号化します。有効にすると、データ ID には自動的にプレフィックス cipher-が付きます。詳細については、「暗号化の設定」をご参照ください。Configuration Format はい データ形式:Properties、JSON、YAML、XML、またはプレーンテキスト。 Description いいえ この構成の目的を説明する簡単なメモです。 More Settings > Application いいえ この構成を使用するアプリケーションです。 More Settings > Configuration Tag いいえ 構成のフィルタリングと整理のためのタグです。キーワードを入力し、ドロップダウンリストから選択します。 Configuration Content はい 右側のパネルに入力する構成データです。例: threadPoolSize=5およびlogLevel=WARN。
Release をクリックすると、構成が Configurations ページに表示されます。
構成内容の例
アプリケーション設定 (Properties 形式)
# データベース接続プール
db.pool.maxActive=20
db.pool.minIdle=5
db.pool.maxWait=60000
# ログ記録
log.level=WARN
log.path=/var/log/app機能フラグ (JSON 形式)
{
"features": {
"new_checkout_flow": {
"enabled": true,
"rollout_percentage": 25
},
"dark_mode": {
"enabled": false
}
}
}サービスエンドポイント構成 (YAML 形式)
upstream:
payment-service:
url: https://pay.example.com/api/v2
timeout: 3000
retries: 3
inventory-service:
url: https://inv.example.com/api/v1
timeout: 5000
retries: 2制限事項
| 構成タイプ | 最大サイズ |
|---|---|
| 非暗号化 | 100 KB |
| 暗号化 | 50 KB |
構成がこれらの制限を超える場合は、複数の小さな構成に分割してください。より大きなクォータをリクエストするには、クォータセンターに移動してください。
コンテンツサイズの制限を変更すると、Nacos の安定性に影響を与える可能性があります。クォータの調整をリクエストする前に、その影響を評価してください。