9.3. cert-manager Operator for Red Hat OpenShift のインストール

手順

1. OpenShift Container Platform Web コンソールにログインします。
2. Operators OperatorHub に移動します。
3. フィルターボックスに cert-manager Operator for Red Hat OpenShift と入力します。
4. cert-manager Operator for Red Hat OpenShift を選択します。

5. Version ドロップダウンリストから cert-manager Operator for Red Hat OpenShift バージョンを選択し、Install をクリックします。

   注記

   サポートされる cert-manager Operator for Red Hat OpenShift バージョンについては、以下の「関連情報」セクションを参照してください。

6. Install Operator ページで以下を行います。

   1. 必要に応じて、Update channel を更新します。チャネルはデフォルトで stable-v1 に設定されます。これに設定すると、cert-manager Operator for Red Hat OpenShift の最新の安定版リリースがインストールされます。

   2. Operator の Installed Namespace を選択します。デフォルトの Operator namespace は cert-manager-operator です。

      cert-manager-operator namespace は、存在しない場合、作成されます。

      注記

      インストール中に、OpenShift Container Platform Web コンソールを使用して、AllNamespaces および SingleNamespace インストールモードのいずれかを選択できます。cert-manager Operator for Red Hat OpenShift version 1.15.0 以降を使用したインストールでは、AllNamespaces インストールモードを選択することが推奨されます。それより前のバージョンでは SingleNamespace および OwnNamespace のサポートが維持されますが、今後のバージョンでは非推奨になります。

   3. Update approval ストラテジーを選択します。

      • Automatic ストラテジーを使用すると、新しいバージョンが利用可能になったときに、Operator Lifecycle Manager (OLM) によって Operator を自動的に更新できます。
      • Manual ストラテジーには、Operator の更新を承認するための適切な認証情報を持つユーザーが必要です。
   4. Install をクリックします。

検証

1. Operators Installed Operators に移動します。
2. cert-manager Operator for Red Hat OpenShift が、cert-manager-operator namespace に ステータス Succeeded でリストされていることを確認します。

3. 次のコマンドを入力して、cert-manager Pod が動作していることを確認します。

   $ oc get pods -n cert-manager

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                       READY   STATUS    RESTARTS   AGE
   cert-manager-bd7fbb9fc-wvbbt               1/1     Running   0          3m39s
   cert-manager-cainjector-56cc5f9868-7g9z7   1/1     Running   0          4m5s
   cert-manager-webhook-d4f79d7f7-9dg9w       1/1     Running   0          4m9s

   Copy to Clipboard Toggle word wrap

   cert-manager Operator for Red Hat OpenShift は、cert-manager Pod が起動して実行された後でなければ使用できません。

手順

1. 次のコマンドを実行して、cert-manager-operator という名前の新規プロジェクトを作成します。

   $ oc new-project cert-manager-operator

   Copy to Clipboard Toggle word wrap

2. OperatorGroup オブジェクトを作成します。

   1. 以下の内容で YAML ファイル (例: operatorGroup.yaml) を作成します。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-cert-manager-operator
        namespace: cert-manager-operator
      spec:
        targetNamespaces:
        - "cert-manager-operator"

      Copy to Clipboard Toggle word wrap

   2. cert-manager Operator for Red Hat OpenShift v1.15.0 以降の場合、次の内容の YAML ファイルを作成します。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-cert-manager-operator
        namespace: cert-manager-operator
      spec:
        targetNamespaces: []
        spec: {}

      Copy to Clipboard Toggle word wrap
      注記

      cert-manager Operator for Red Hat OpenShift バージョン 1.15.0 以降では、AllNamespaces OLM installMode を使用して Operator をインストールすることが推奨されます。古いバージョンでは、引き続き SingleNamespace または OwnNamespace の OLM installMode を使用できます。SingleNamespace および OwnNamespace のサポートは、今後のバージョンで非推奨になります。

   3. 以下のコマンドを実行して OperatorGroup オブジェクトを作成します。

      $ oc create -f operatorGroup.yaml

      Copy to Clipboard Toggle word wrap

3. Subscription オブジェクトを作成します。

   1. Subscription オブジェクトを定義する YAML ファイル (例: subscription.yaml) を作成します。

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: openshift-cert-manager-operator
        namespace: cert-manager-operator
      spec:
        channel: stable-v1
        name: openshift-cert-manager-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace
        installPlanApproval: Automatic

      Copy to Clipboard Toggle word wrap

   2. 以下のコマンドを実行して Subscription オブジェクトを作成します。

      $ oc create -f subscription.yaml

      Copy to Clipboard Toggle word wrap

検証

1. 次のコマンドを実行して、OLM サブスクリプションが作成されていることを確認します。

   $ oc get subscription -n cert-manager-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                              PACKAGE                           SOURCE             CHANNEL
   openshift-cert-manager-operator   openshift-cert-manager-operator   redhat-operators   stable-v1

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、Operator が正常にインストールされているか確認します。

   $ oc get csv -n cert-manager-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                            DISPLAY                                       VERSION   REPLACES                        PHASE
   cert-manager-operator.v1.13.0   cert-manager Operator for Red Hat OpenShift   1.13.0    cert-manager-operator.v1.12.1   Succeeded

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、cert-manager Operator for Red Hat OpenShift のステータスが Running であることを確認します。

   $ oc get pods -n cert-manager-operator

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                                        READY   STATUS    RESTARTS   AGE
   cert-manager-operator-controller-manager-695b4d46cb-r4hld   2/2     Running   0          7m4s

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、cert-manager Pod のステータスが Running であることを確認します。

   $ oc get pods -n cert-manager

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                       READY   STATUS    RESTARTS   AGE
   cert-manager-58b7f649c4-dp6l4              1/1     Running   0          7m1s
   cert-manager-cainjector-5565b8f897-gx25h   1/1     Running   0          7m37s
   cert-manager-webhook-9bc98cbdd-f972x       1/1     Running   0          7m40s

   Copy to Clipboard Toggle word wrap