Fencing

Fencing#

CloudNativePG™クラスターのEDB Postgres® AIのフェンシングは、PostgreSQLクラスターの1つ以上、またはすべてのインスタンスに障害があると思われる場合に、データを保護する究極のプロセスです。インスタンスがフェンスされると、PostgreSQLサーバープロセスpostmaster はシャットダウンが保証されますが、ポッドは実行されたままです。これにより、フェンスが解除されるまで、ポッド上のデータがPostgreSQLによって変更されず、デバッグとトラブルシューティングの目的でファイルシステムを調査できることが保証されます。

インスタンスをフェンスする方法#

CloudNativePG™クラスターのEDB Postgres® AIでは、次のことをフェンスできます。

  • 特定のインスタンス

  • インスタンスのリスト

  • Postgres全体 Cluster

フェンシングは、k8s.enterprisedb.io/fencedInstances アノテーションの内容を介して制御されます。これは、JSON形式のインスタンス名のリストを想定しています。アノテーションが'["*"]' 、ワイルドカードを使用したシングルトンリストに設定されている場合、クラスター全体がフェンスされます。アノテーションが空のJSONリストに設定されている場合、オペレーターは、アノテーションが設定されていないかのように動作します。

例

  • k8s.enterprisedb.io/fencedInstances: '["cluster-example-1"]' はcluster-example-1 インスタンスのみをフェンスします

  • k8s.enterprisedb.io/fencedInstances: '["cluster-example-1","cluster-example-2"]' は、 cluster-example-1 およびcluster-example-2 インスタンスをフェンスします

  • k8s.enterprisedb.io/fencedInstances: '["*"]' は、クラスター内のすべてのインスタンスをフェンスします。

アノテーションは、kubectl annotate コマンドを介して、またはkubectl cnp fencing on サブコマンドを使用して透過的な方法で、Kubernetesオブジェクトに手動で設定できます。

#  to fence only one instance

kubectl cnp fencing on cluster-example 1

#  to fence all the instances in a Cluster

kubectl cnp fencing on cluster-example "*"

次に、以前にフェンスされたインスタンスを使用したCluster の例を示します。

apiVersion: postgresql.k8s.enterprisedb.io/v1
kind: Cluster
metadata:
    annotations:
      k8s.enterprisedb.io/fencedInstances: ["cluster-example-1"]
[...]

フェンシングのリフティング方法#

フェンシングは、注釈をクリアするか、別の値に設定することにより解除できます。

フェンシングに関しては、これはkubectl annotate を使用して手動で行うか、次のようにkubectl cnp fencing サブコマンドを使用して実行できます。

#  to lift the fencing only for one instance

#  N.B.: at the moment this wont work if the whole cluster was fenced previously,

#        in that case you will have to manually set the annotation as explained above

kubectl cnp fencing off cluster-example 1

#  to lift the fencing for all the instances in a Cluster

kubectl cnp fencing off cluster-example "*"

フェンシングの仕組み#

インスタンスがフェンシング用に設定されると、スイッチオーバーの場合と同様に、postmaster プロセスをシャットダウンする手順が開始されます。これは、タイムアウトを.spec.switchoverDelay に設定した最初の高速シャットダウンと、それに続く即時シャットダウンで構成されます。次に

  • ポッドは生きたままになります

  • ポッドは 準備完了 としてマークされません

  • Postgresインスタンスを起動する必要がないすべての変更がリコンサイルされます。

    • 構成ファイル

    • 証明書およびすべての暗号化マテリアル

  • 1に設定されるcnp_collector_fencing_on を除き、メトリックは収集されません

警告

**プライマリインスタンス**がフェンスされている場合、そのポストマスタープロセスはシャットダウンされますが、フェイルオーバーは実行されず、アプリケーションの操作性が中断されます。フェンスが解除されると、プライマリインスタンスはフェイルオーバーを実行せずに再度起動されます。

そのため、厳密に必要な場合にのみプライマリインスタンスをフェンスすることをお勧めします。

目次