3.2.21. Dynamic Configuration Manager の使用

手順

1. 新しいプロジェクトを作成します。

   $ oc new-project namespace_name

2. 新規ルートを作成します。この方法では既存サービスを公開します。

   $ oc create route edge edge_route_name --key=/path/to/key.pem \
         --cert=/path/to/cert.pem --service=<service> --port=8443

3. ルートにラベルを付けます。

   $ oc label route edge_route_name type=route_label_1

4. ルートオブジェクト定義から 3 つの異なるルートを作成します。すべてにラベル type=route_label_1 が付けられます。

   $ oc create -f reencrypt-blueprint.yaml
   $ oc create -f annotated-edge-blueprint.yaml
   $ oc create -f annotated-unsecured-blueprint.json

   また、ブループリントルートとしての使用を防ぐラベルをルートから削除することもできます。たとえば、annotated-unsecured-blueprint をブループリントルートとして使用されることを防ぐには、以下を実行します。

   $ oc label route annotated-unsecured-blueprint type-

5. ブループリントプールに用される新規のルーターを作成します。

   $ oc adm router

6. 新規ルーターの環境変数を設定します。

   $ oc set env dc/router ROUTER_HAPROXY_CONFIG_MANAGER=true      \
                          ROUTER_BLUEPRINT_ROUTE_NAMESPACE=namespace_name  \
                          ROUTER_BLUEPRINT_ROUTE_LABELS="type=route_label_1"

   ラベル type=route_label_1 が設定された namespace またはプロジェクト namespace_name のすべてのルートはカスタムブループリントとして処理でき、使用できます。

   ブループリントは、namespace namespace_name で通常実行するようにルートを管理することによって、追加し、更新し、削除できることに注意してください。Dynamic Configuration Manager は、ルーターが routes および services の有無を監視するのと同様の方法で namespace namespace_name のルートへの変更の有無を監視します。

7. 事前に割り当てられたルートおよびバックエンドサーバーのプールサイズは、ROUTER_BLUEPRINT_ROUTE_POOL_SIZE (デフォルトは 10)、および ROUTER_MAX_DYNAMIC_SERVERS (デフォルトは 5) 環境変数で制御できます。また、Dynamic Configuration Manager が加える変更をディスクにコミットする頻度、つまり HAProxy 設定が再作成され、HAProxy プロセスがリロードされるタイミングを制御することもできます。デフォルトは 1 時間 (3600 秒) または Dynamic Configuration Manager のプールスペースが不足するタイミングになります。COMMIT_INTERVAL 環境変数がこの設定を制御します。

   $ oc set env dc/router -c router ROUTER_BLUEPRINT_ROUTE_POOL_SIZE=20  \
         ROUTER_MAX_DYNAMIC_SERVERS=3 COMMIT_INTERVAL=6h

   この例では、各ブループリントルートのプールサイズを 20 に増やし、動的サーバーの数を 3 に減らし、またコミット期間を 6 時間に増やしています。