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 ファイルの例

apiVersion: operator.openshift.io/v1alpha1
kind: CertManager
metadata:
  name: cluster
spec:
  controllerConfig:
    overrideArgs:
      - "--dns01-recursive-nameservers=8.8.8.8:53,1.1.1.1:53"
    overrideEnv:
      - name: HTTP_PROXY
        value: http://proxy.example.com:8080
    overrideResources:
      limits:
        cpu: "200m"
        memory: "512Mi"
      requests:
        cpu: "100m"
        memory: "256Mi"
    overrideScheduling:
      nodeSelector:
        custom: "label"
      tolerations:
        - key: "key1"
          operator: "Equal"
          value: "value1"
          effect: "NoSchedule"
    overrideReplicas: 2
#...

  webhookConfig:
    overrideArgs:
#...
    overrideResources:
#...
    overrideScheduling:
#...
    overrideReplicas:
#...

  cainjectorConfig:
    overrideArgs:
#...
    overrideResources:
#...
    overrideScheduling:
#...
    overrideReplicas:
#...

警告

サポートされていない引数をオーバーライドするには、CertManager リソースに spec.unsupportedConfigOverrides セクションを追加しますが、spec.unsupportedConfigOverrides の使用はサポートされていません。

9.5.1. CertManager カスタムリソースのフィールドの説明

Cert-manager Operator for Red Hat OpenShift のコアコンポーネントを設定するには、CertManager カスタムリソース (CR) を使用します。spec.controllerConfig フィールドなど、cert-manager コントローラーの設定を定義することで、デプロイメントをカスタマイズできます。

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.controllerConfigspec.webhookConfig、および spec.cainjectorConfig セクションで設定できる共通フィールドを示しています。

Expand
表9.1 cert-manager コンポーネントの CertManager CR における共通の設定可能フィールド
フィールド説明

overrideArgs

string

cert-manager コンポーネントでサポートされている引数をオーバーライドできます。

overrideEnv

dict

cert-manager コントローラーでサポートされている環境変数をオーバーライドできます。このフィールドは、cert-manager コントローラーコンポーネントでのみサポートされます。

overrideReplicas

int

cert-manager コンポーネントのレプリカ数を設定できます。デフォルト値は 1 です。実稼働環境では、次のレプリカ数が推奨されます。

  • controller: 2
  • cainjector: 2
  • webhook: 3 以上

詳細は、High Availability を参照してください。

overrideResources

object

cert-manager コンポーネントの CPU およびメモリーの制限を設定できます。

overrideScheduling

object

cert-manager コンポーネントの Pod スケジューリング制約を設定できます。

9.5.1.2. cert-manager コンポーネントのオーバーライド可能な引数

CertManager CR の spec.controllerConfigspec.webhookConfig、および spec.cainjectorConfig セクションで、cert-manager コンポーネントのオーバーライド可能な引数を設定できます。

次の表は、cert-manager コンポーネントのオーバーライド可能な引数について説明しています。

Expand
表9.2 cert-manager コンポーネントのオーバーライド可能な引数
引数コンポーネント説明

--dns01-recursive-nameservers=<server_address>

Controller

DNS-01 セルフチェックをクエリーするネームサーバーのコンマ区切りリストを指定します。ネームサーバーは、<host>:<port> (例: 1.1.1.1:53) で指定することも、DNS over HTTPS (DoH) (例: https://1.1.1.1/dns-query) を使用することもできます。

注記

DNS over HTTPS (DoH) は、cert-manager Operator for Red Hat OpenShift バージョン 1.13.0 以降でのみサポートされます。

--dns01-recursive-nameservers-only

Controller

そのドメインに関連付けられた権限のあるネームサーバーをチェックする代わりに、再帰的なネームサーバーのみを使用するように指定します。

--acme-http01-solver-nameservers=<host>:<port>

Controller

Automated Certificate Management Environment (ACME) HTTP01 セルフチェックをクエリーするための <host>:<port> ネームサーバーをコンマ区切りのリストで指定します。たとえば --acme-http01-solver-nameservers=1.1.1.1:53 です。

--metrics-listen-address=<host>:<port>

Controller

メトリクスエンドポイントのホストとポートを指定します。デフォルト値は --metrics-listen-address=0.0.0.0:9402 です。

--issuer-ambient-credentials

Controller

この引数を使用すると、アンビエント認証情報を使用して DNS-01 チャレンジを解決するように ACME Issuer を設定できます。

--enable-certificate-owner-ref

Controller

この引数は、証明書リソースを、TLS 証明書が保存されているシークレットの所有者として設定します。詳細は、「証明書の削除時に TLS シークレットを自動的に削除する」を参照してください。

--acme-http01-solver-resource-limits-cpu

Controller

ACME HTTP-01 ソルバー Pod の最大 CPU 制限を定義します。デフォルト値は 100m です。

--acme-http01-solver-resource-limits-memory

Controller

ACME HTTP-01 ソルバー Pod の最大メモリー制限を定義します。デフォルト値は 64Mi です。

--acme-http01-solver-resource-request-cpu

Controller

ACME HTTP-01 ソルバー Pod の最小 CPU 要求を定義します。デフォルト値は 10m です。

--acme-http01-solver-resource-request-memory

Controller

ACME HTTP-01 ソルバー Pod の最小メモリー要求を定義します。デフォルト値は 64Mi です。

-- 証明書要求の最小バックオフ期間

Controller

証明書要求の最小バックオフ期間を指定してください。デフォルト値は 1h0m0s です。

--v=<verbosity_level>

コントローラー、Webhook、CA インジェクター

ログメッセージの冗長性を決定するために、ログレベルの詳細度を指定します。

9.5.1.3. cert-manager コントローラーのオーバーライド可能な環境変数

CertManager CR の spec.controllerConfig.overrideEnv フィールドで、cert-manager コントローラーのオーバーライド可能な環境変数を設定できます。

次の表は、cert-manager コントローラーのオーバーライド可能な環境変数について説明しています。

Expand
表9.3 cert-manager コントローラーのオーバーライド可能な環境変数
環境変数説明

HTTP_PROXY

送信 HTTP 要求のプロキシーサーバー。

HTTPS_PROXY

送信 HTTPS 要求のプロキシーサーバー。

NO_PROXY

プロキシーをバイパスするホストのコンマ区切りリスト。

9.5.1.4. cert-manager コンポーネントのオーバーライド可能なリソースパラメーター

CertManager CR の spec.controllerConfigspec.webhookConfig、および spec.cainjectorConfig セクションで、cert-manager コンポーネントの CPU およびメモリー制限を設定できます。

次の表は、cert-manager コンポーネントのオーバーライド可能なリソースパラメーターについて説明しています。

Expand
表9.4 cert-manager コンポーネントのオーバーライド可能なリソースパラメーター
フィールド説明

overrideResources.limits.cpu

コンポーネント Pod が使用できる CPU の最大量を定義します。

overrideResources.limits.memory

コンポーネント Pod が使用できるメモリーの最大量を定義します。

overrideResources.requests.cpu

コンポーネント Pod のスケジューラーによって要求される CPU の最小量を定義します。

overrideResources.requests.memory

コンポーネント Pod のスケジューラーによって要求されるメモリーの最小量を定義します。

9.5.1.5. cert-manager コンポーネントのオーバーライド可能なスケジューリングパラメーター

CertManager CR の spec.controllerConfigspec.webhookConfig フィールド、および spec.cainjectorConfig セクションで、cert-manager コンポーネントの Pod スケジューリング制約を設定できます。

次の表は、cert-manager コンポーネントの Pod スケジューリングパラメーターについて説明しています。

Expand
表9.5 cert-manager コンポーネントのオーバーライド可能なスケジューリングパラメーター
フィールド説明

overrideScheduling.nodeSelector

Pod を特定のノードに制限するためのキーと値のペア。

overrideScheduling.tolerations

taint されたノードで Pod をスケジュールするための toleration リスト。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2026 Red Hat
トップに戻る