9.5. CertManager カスタムリソースを使用して cert-manager Operator をカスタマイズする
cert-manager Operator for Red Hat OpenShift をインストールした後、CertManager
カスタムリソース (CR) を設定することで、次のアクションを実行できます。
- cert-manager コントローラー、CA インジェクター、Webhook などの cert-manager コンポーネントの動作を変更するには、引数を設定します。
- コントローラー Pod の環境変数を設定します。
- CPU とメモリーの使用量を管理するために、リソース要求と制限を定義します。
- クラスター内で Pod が実行される場所を制御するためのスケジューリングルールを設定します。
CertManager CR YAML ファイルの例
サポートされていない引数をオーバーライドするには、CertManager
リソースに spec.unsupportedConfigOverrides
セクションを追加しますが、spec.unsupportedConfigOverrides
の使用はサポートされていません。
9.5.1. CertManager カスタムリソースのフィールドの説明 リンクのコピーリンクがクリップボードにコピーされました!
CertManager
カスタムリソース (CR) を使用して、cert-manager Operator for Red Hat OpenShift の次のコアコンポーネントを設定できます。
-
cert-manager コントローラー:
spec.controllerConfig
フィールドを使用して、cert‑manager コントローラー Pod を設定できます。 -
Webhook:
spec.webhookConfig
フィールドを使用して、検証および変更リクエストを処理する Webhook Pod を設定できます。 -
CA インジェクター:
spec.cainjectorConfig
フィールドを使用して、CA インジェクター Pod を設定できます。
9.5.1.1. cert-manager コンポーネントの CertManager CR における共通の設定可能フィールド リンクのコピーリンクがクリップボードにコピーされました!
次の表は、CertManager
CR の spec.controllerConfig
、spec.webhookConfig
、および spec.cainjectorConfig
セクションで設定できる共通フィールドを示しています。
フィールド | 型 | 説明 |
---|---|---|
|
| cert-manager コンポーネントでサポートされている引数をオーバーライドできます。 |
|
| cert-manager コントローラーでサポートされている環境変数をオーバーライドできます。このフィールドは、cert-manager コントローラーコンポーネントでのみサポートされます。 |
|
| cert-manager コンポーネントの CPU およびメモリーの制限を設定できます。 |
|
| cert-manager コンポーネントの Pod スケジューリング制約を設定できます。 |
9.5.1.2. cert-manager コンポーネントのオーバーライド可能な引数 リンクのコピーリンクがクリップボードにコピーされました!
CertManager
CR の spec.controllerConfig
、spec.webhookConfig
、および spec.cainjectorConfig
セクションで、cert-manager コンポーネントのオーバーライド可能な引数を設定できます。
次の表は、cert-manager コンポーネントのオーバーライド可能な引数について説明しています。
引数 | コンポーネント | 説明 |
---|---|---|
| Controller |
DNS-01 セルフチェックをクエリーするネームサーバーのコンマ区切りリストを指定します。ネームサーバーは、 注記 DNS over HTTPS (DoH) は、cert-manager Operator for Red Hat OpenShift バージョン 1.13.0 以降でのみサポートされます。 |
| Controller | そのドメインに関連付けられた権限のあるネームサーバーをチェックする代わりに、再帰的なネームサーバーのみを使用するように指定します。 |
| Controller |
Automated Certificate Management Environment (ACME) HTTP01 セルフチェックをクエリーするための |
| Controller |
メトリクスエンドポイントのホストとポートを指定します。デフォルト値は |
| Controller | この引数を使用すると、アンビエント認証情報を使用して DNS-01 チャレンジを解決するように ACME Issuer を設定できます。 |
| Controller | この引数は、証明書リソースを、TLS 証明書が保存されているシークレットの所有者として設定します。詳細は、「証明書の削除時に TLS シークレットを自動的に削除する」を参照してください。 |
| Controller |
ACME HTTP-01 ソルバー Pod の最大 CPU 制限を定義します。デフォルト値は |
| Controller |
ACME HTTP-01 ソルバー Pod の最大メモリー制限を定義します。デフォルト値は |
| Controller |
ACME HTTP-01 ソルバー Pod の最小 CPU 要求を定義します。デフォルト値は |
| Controller |
ACME HTTP-01 ソルバー Pod の最小メモリー要求を定義します。デフォルト値は |
| コントローラー、Webhook、CA インジェクター | ログメッセージの冗長性を決定するために、ログレベルの詳細度を指定します。 |
9.5.1.3. cert-manager コントローラーのオーバーライド可能な環境変数 リンクのコピーリンクがクリップボードにコピーされました!
CertManager
CR の spec.controllerConfig.overrideEnv
フィールドで、cert-manager コントローラーのオーバーライド可能な環境変数を設定できます。
次の表は、cert-manager コントローラーのオーバーライド可能な環境変数について説明しています。
環境変数 | 説明 |
---|---|
| 送信 HTTP 要求のプロキシーサーバー。 |
| 送信 HTTPS 要求のプロキシーサーバー。 |
| プロキシーをバイパスするホストのコンマ区切りリスト。 |
9.5.1.4. cert-manager コンポーネントのオーバーライド可能なリソースパラメーター リンクのコピーリンクがクリップボードにコピーされました!
CertManager
CR の spec.controllerConfig
、spec.webhookConfig
、および spec.cainjectorConfig
セクションで、cert-manager コンポーネントの CPU およびメモリー制限を設定できます。
次の表は、cert-manager コンポーネントのオーバーライド可能なリソースパラメーターについて説明しています。
フィールド | 説明 |
---|---|
| コンポーネント Pod が使用できる CPU の最大量を定義します。 |
| コンポーネント Pod が使用できるメモリーの最大量を定義します。 |
| コンポーネント Pod のスケジューラーによって要求される CPU の最小量を定義します。 |
| コンポーネント Pod のスケジューラーによって要求されるメモリーの最小量を定義します。 |
9.5.1.5. cert-manager コンポーネントのオーバーライド可能なスケジューリングパラメーター リンクのコピーリンクがクリップボードにコピーされました!
CertManager
CR の spec.controllerConfig
、spec.webhookConfig
フィールド、および spec.cainjectorConfig
セクションで、cert-manager コンポーネントの Pod スケジューリング制約を設定できます。
次の表は、cert-manager コンポーネントの Pod スケジューリングパラメーターについて説明しています。
フィールド | 説明 |
---|---|
| Pod を特定のノードに制限するためのキーと値のペア。 |
| taint されたノードで Pod をスケジュールするための toleration リスト。 |
9.5.2. cert-manager Operator API から環境変数をオーバーライドして cert-manager をカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
CertManager
リソースに spec.controllerConfig
セクションを追加することで、cert-manager Operator for Red Hat OpenShift でサポートされている環境変数をオーバーライドできます。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。
手順
次のコマンドを実行して、
CertManager
リソースを編集します。oc edit certmanager cluster
$ oc edit certmanager cluster
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のオーバーライド引数を指定して、
spec.controllerConfig
セクションを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記オーバーライド可能な環境変数の詳細は、「CertManager カスタムリソースのフィールドの説明」の「cert-manager コンポーネントのオーバーライド可能な環境変数」を参照してください。
- 変更を保存してテキストエディターを終了し、変更を適用します。
検証
次のコマンドを実行して、cert-manager コントローラー Pod が再デプロイされているか確認します。
oc get pods -l app.kubernetes.io/name=cert-manager -n cert-manager
$ oc get pods -l app.kubernetes.io/name=cert-manager -n cert-manager
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME READY STATUS RESTARTS AGE cert-manager-bd7fbb9fc-wvbbt 1/1 Running 0 39s
NAME READY STATUS RESTARTS AGE cert-manager-bd7fbb9fc-wvbbt 1/1 Running 0 39s
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、cert-manager Pod の環境変数が更新されているか確認します。
oc get pod <redeployed_cert-manager_controller_pod> -n cert-manager -o yaml
$ oc get pod <redeployed_cert-manager_controller_pod> -n cert-manager -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.5.3. cert-manager Operator API からの引数をオーバーライドして cert-manager をカスタマイズ リンクのコピーリンクがクリップボードにコピーされました!
CertManager
リソースに spec.controllerConfig
セクションを追加することで、cert-manager Operator for Red Hat OpenShift でサポートされる引数をオーバーライドできます。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。
手順
次のコマンドを実行して、
CertManager
リソースを編集します。oc edit certmanager cluster
$ oc edit certmanager cluster
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のオーバーライド引数を指定して、
spec.controllerConfig
セクションを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- オーバーライド可能な引数の詳細は、「CertManager カスタムリソースのフィールドの説明」の「cert-manager コンポーネントのオーバーライド可能な引数」を参照してください。
- 変更を保存してテキストエディターを終了し、変更を適用します。
検証
次のコマンドを実行して、cert-manager Pod の引数が更新されているか確認します。
oc get pods -n cert-manager -o yaml
$ oc get pods -n cert-manager -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.5.4. 証明書の削除時に TLS シークレットを自動的に削除する リンクのコピーリンクがクリップボードにコピーされました!
CertManager
リソースに spec.controllerConfig
セクションを追加することで、cert-manager Operator for Red Hat OpenShift の --enable-certificate-owner-ref
フラグを有効にできます。--enable-certificate-owner-ref
フラグは、TLS 証明書が保存されているシークレットの所有者として証明書リソースを設定します。
cert-manager Operator for Red Hat OpenShift をアンインストールするか、クラスターから証明書リソースを削除すると、シークレットは自動的に削除されます。証明書 TLS シークレットが使用されている場所によっては、これが原因でネットワーク接続の問題が発生する可能性があります。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。 - cert-manager Operator for Red Hat OpenShift のバージョン 1.12.0 以降がインストールされている。
手順
次のコマンドを実行して、
Certificate
オブジェクトとそのシークレットが利用可能であることを確認します。oc get certificate
$ oc get certificate
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME READY SECRET AGE certificate-from-clusterissuer-route53-ambient True certificate-from-clusterissuer-route53-ambient 8h
NAME READY SECRET AGE certificate-from-clusterissuer-route53-ambient True certificate-from-clusterissuer-route53-ambient 8h
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、
CertManager
リソースを編集します。oc edit certmanager cluster
$ oc edit certmanager cluster
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のオーバーライド引数を指定して、
spec.controllerConfig
セクションを追加します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 変更を保存してテキストエディターを終了し、変更を適用します。
検証
次のコマンドを実行して、cert-manager コントローラー Pod の
--enable-certificate-owner-ref
フラグが更新されていることを確認します。oc get pods -l app.kubernetes.io/name=cert-manager -n cert-manager -o yaml
$ oc get pods -l app.kubernetes.io/name=cert-manager -n cert-manager -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.5.5. cert-manager コンポーネントの CPU およびメモリー制限をオーバーライドする リンクのコピーリンクがクリップボードにコピーされました!
cert-manager Operator for Red Hat OpenShift をインストールした後、cert-manager コントローラー、CA インジェクター、Webhook などの cert-manager コンポーネントの cert-manager Operator for Red Hat OpenShift API から CPU およびメモリーの制限を設定できます。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。 - cert-manager Operator for Red Hat OpenShift のバージョン 1.12.0 以降がインストールされている。
手順
次のコマンドを入力して、cert-manager コントローラー、CA インジェクター、および Webhook のデプロイメントが使用可能であることを確認します。
oc get deployment -n cert-manager
$ oc get deployment -n cert-manager
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME READY UP-TO-DATE AVAILABLE AGE cert-manager 1/1 1 1 53m cert-manager-cainjector 1/1 1 1 53m cert-manager-webhook 1/1 1 1 53m
NAME READY UP-TO-DATE AVAILABLE AGE cert-manager 1/1 1 1 53m cert-manager-cainjector 1/1 1 1 53m cert-manager-webhook 1/1 1 1 53m
Copy to Clipboard Copied! Toggle word wrap Toggle overflow CPU とメモリーの制限を設定する前に、次のコマンドを入力して cert-manager コントローラー、CA インジェクター、および Webhook の既存の設定を確認します。
oc get deployment -n cert-manager -o yaml
$ oc get deployment -n cert-manager -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow cert-manager コントローラー、CA インジェクター、Webhook の CPU およびメモリー制限を設定するには、次のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- オーバーライド可能なリソースパラメーターの詳細は、「CertManager カスタムリソースのフィールドの説明」の「cert-manager コンポーネントのオーバーライド可能なリソースパラメーター」を参照してください。
出力例
certmanager.operator.openshift.io/cluster patched
certmanager.operator.openshift.io/cluster patched
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
検証
cert-manager コンポーネントの CPU とメモリーの制限が更新されていることを確認します。
oc get deployment -n cert-manager -o yaml
$ oc get deployment -n cert-manager -o yaml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
9.5.6. cert-manager コンポーネントのスケジュールオーバーライドを設定する リンクのコピーリンクがクリップボードにコピーされました!
cert-manager コントローラー、CA インジェクター、Webhook などの cert-manager Operator for Red Hat OpenShift コンポーネントの Pod スケジューリングを、cert-manager Operator for Red Hat OpenShift API から設定できます。
前提条件
-
cluster-admin
ロールを持つユーザーとして OpenShift Container Platform クラスターにアクセスできる。 - cert-manager Operator for Red Hat OpenShift のバージョン 1.15.0 以降がインストールされている。
手順
次のコマンドを実行して
certmanager.operator
カスタムリソースを更新し、目的のコンポーネントの Pod スケジューリングオーバーライドを設定します。nodeSelector
およびtolerations
設定を定義するには、controllerConfig
、webhookConfig
、またはcainjectorConfig
セクションのoverrideScheduling
フィールドを使用します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 1
- オーバーライド可能なスケジューリングパラメーターの詳細は、「CertManager カスタムリソースのフィールドの説明」の「cert-manager コンポーネントのオーバーライド可能なスケジューリングパラメーター」を参照してください。
検証
cert-manager
Pod の Pod スケジューリング設定を検証します。次のコマンドを実行して、
cert-manager
namespace のデプロイメントをチェックし、正しいnodeSelector
とtolerations
があることを確認します。oc get pods -n cert-manager -o wide
$ oc get pods -n cert-manager -o wide
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES cert-manager-58d9c69db4-78mzp 1/1 Running 0 10m 10.129.0.36 ip-10-0-1-106.ec2.internal <none> <none> cert-manager-cainjector-85b6987c66-rhzf7 1/1 Running 0 11m 10.128.0.39 ip-10-0-1-136.ec2.internal <none> <none> cert-manager-webhook-7f54b4b858-29bsp 1/1 Running 0 11m 10.129.0.35 ip-10-0-1-106.ec2.internal <none> <none>
NAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE READINESS GATES cert-manager-58d9c69db4-78mzp 1/1 Running 0 10m 10.129.0.36 ip-10-0-1-106.ec2.internal <none> <none> cert-manager-cainjector-85b6987c66-rhzf7 1/1 Running 0 11m 10.128.0.39 ip-10-0-1-136.ec2.internal <none> <none> cert-manager-webhook-7f54b4b858-29bsp 1/1 Running 0 11m 10.129.0.35 ip-10-0-1-106.ec2.internal <none> <none>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 次のコマンドを実行して、デプロイメントに適用されている
nodeSelector
とtolerations
の設定を確認します。oc get deployments -n cert-manager -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{.spec.template.spec.nodeSelector}{"\n"}{.spec.template.spec.tolerations}{"\n\n"}{end}'
$ oc get deployments -n cert-manager -o jsonpath='{range .items[*]}{.metadata.name}{"\n"}{.spec.template.spec.nodeSelector}{"\n"}{.spec.template.spec.tolerations}{"\n\n"}{end}'
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 出力例
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
次のコマンドを実行して、
cert-manager
namespace 内の Pod スケジューリングイベントを検証します。oc get events -n cert-manager --field-selector reason=Scheduled
$ oc get events -n cert-manager --field-selector reason=Scheduled
Copy to Clipboard Copied! Toggle word wrap Toggle overflow