5.6. Helm ベースの Operator

手順

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

   1. プロジェクトディレクトリーを作成します。

      $ mkdir nginx-operator

      Copy to Clipboard Toggle word wrap

   2. プロジェクトディレクトリーに移動します。

      $ cd nginx-operator

      Copy to Clipboard Toggle word wrap

   3. helm プラグインを指定して operator-sdk init コマンドを実行し、プロジェクトを初期化します。

      $ operator-sdk init \
          --plugins=helm

      Copy to Clipboard Toggle word wrap

2. API を作成します。

   単純な Nginx API を作成します。

   $ operator-sdk create api \
       --group demo \
       --version v1 \
       --kind Nginx

   Copy to Clipboard Toggle word wrap

   この API は、helm create コマンドでビルトインの Helm チャートボイラープレートを使用します。

3. Operator イメージをビルドし、プッシュします。

   デフォルトの Makefile ターゲットを使用して Operator をビルドし、プッシュします。プッシュ先となるレジストリーを使用するイメージのプル仕様を使用して IMG を設定します。

   $ make docker-build docker-push IMG=<registry>/<user>/<image_name>:<tag>

   Copy to Clipboard Toggle word wrap

4. Operator を実行します。

   1. CRD をインストールします。

      $ make install

      Copy to Clipboard Toggle word wrap

   2. プロジェクトをクラスターにデプロイします。IMG をプッシュしたイメージに設定します。

      $ make deploy IMG=<registry>/<user>/<image_name>:<tag>

      Copy to Clipboard Toggle word wrap

5. SCC(Security Context Constraints) を追加します。

   Nginx サービスアカウントには、OpenShift Container Platform で実行する特権アクセスが必要です。以下の SCC を nginx-sample Pod のサービスアカウントに追加します。

   $ oc adm policy add-scc-to-user \
       anyuid system:serviceaccount:nginx-operator-system:nginx-sample

   Copy to Clipboard Toggle word wrap

6. サンプルカスタムリソース (CR) を作成します。

   1. サンプル CR を作成します。

      $ oc apply -f config/samples/demo_v1_nginx.yaml \
          -n nginx-operator-system

      Copy to Clipboard Toggle word wrap

   2. Operator を調整する CR を確認します。

      $ oc logs deployment.apps/nginx-operator-controller-manager \
          -c manager \
          -n nginx-operator-system

      Copy to Clipboard Toggle word wrap

7. CR を削除する

   次のコマンドを実行して CR を削除します。

   $ oc delete -f config/samples/cache_v1_memcached.yaml -n memcached-operator-system

   Copy to Clipboard Toggle word wrap

8. クリーンアップします。

   以下のコマンドを実行して、この手順の一部として作成されたリソースをクリーンアップします。

   $ make undeploy

   Copy to Clipboard Toggle word wrap

手順

1. プロジェクトのディレクトリーを作成します。

   $ mkdir -p $HOME/projects/nginx-operator

   Copy to Clipboard Toggle word wrap

2. ディレクトリーに切り替えます。

   $ cd $HOME/projects/nginx-operator

   Copy to Clipboard Toggle word wrap

3. helm プラグインを指定して operator-sdk init コマンドを実行し、プロジェクトを初期化します。

   $ operator-sdk init \
       --plugins=helm \
       --domain=example.com \
       --group=demo \
       --version=v1 \
       --kind=Nginx

   Copy to Clipboard Toggle word wrap
   注記

   デフォルトで、helm プラグインは、ボイラープレート Helm チャートを使用してプロジェクトを初期化します。--helm-chart フラグなどの追加のフラグを使用すると、既存の Helm チャートを使用してプロジェクトを初期化できます。

   init コマンドは、API バージョン example.com/v1 および Kind Nginx でのリソースの監視に特化した nginx-operator プロジェクトを作成します。

4. Helm ベースのプロジェクトの場合、init コマンドは、チャートのデフォルトマニフェストによってデプロイされるリソースに基づいて config/rbac/role.yaml ファイルに RBAC ルールを生成します。このファイルで生成されるルールが Operator のパーミッション要件を満たしていることを確認します。

手順

1. Operator がインストールされている namespace へ変更します。たとえば、make deploy コマンドを使用して Operator をデプロイした場合は、以下のようになります。

   $ oc project nginx-operator-system

   Copy to Clipboard Toggle word wrap

2. config/samples/demo_v1_nginx.yaml で Nginx CR マニフェストのサンプルを編集し、以下の仕様が含まれるようにします。

   apiVersion: demo.example.com/v1
   kind: Nginx
   metadata:
     name: nginx-sample
   ...
   spec:
   ...
     replicaCount: 3

   Copy to Clipboard Toggle word wrap

3. Nginx サービスアカウントには、OpenShift Container Platform で実行する特権アクセスが必要です。以下の SCC(Security Context Constraints) を nginx-sample Pod のサービスアカウントに追加します。

   $ oc adm policy add-scc-to-user \
       anyuid system:serviceaccount:nginx-operator-system:nginx-sample

   Copy to Clipboard Toggle word wrap

4. CR を作成します。

   $ oc apply -f config/samples/demo_v1_nginx.yaml

   Copy to Clipboard Toggle word wrap

5. Nginx Operator が、正しいサイズで CR サンプルのデプロイメントを作成することを確認します。

   $ oc get deployments

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
   nginx-operator-controller-manager       1/1     1            1           8m
   nginx-sample                            3/3     3            3           1m

   Copy to Clipboard Toggle word wrap

6. ステータスが Nginx Pod 名で更新されていることを確認するために、Pod および CR ステータスを確認します。

   1. Pod を確認します。

      $ oc get pods

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                                  READY     STATUS    RESTARTS   AGE
      nginx-sample-6fd7c98d8-7dqdr          1/1       Running   0          1m
      nginx-sample-6fd7c98d8-g5k7v          1/1       Running   0          1m
      nginx-sample-6fd7c98d8-m7vn7          1/1       Running   0          1m

      Copy to Clipboard Toggle word wrap

   2. CR ステータスを確認します。

      $ oc get nginx/nginx-sample -o yaml

      Copy to Clipboard Toggle word wrap

      出力例

      apiVersion: demo.example.com/v1
      kind: Nginx
      metadata:
      ...
        name: nginx-sample
      ...
      spec:
        replicaCount: 3
      status:
        nodes:
        - nginx-sample-6fd7c98d8-7dqdr
        - nginx-sample-6fd7c98d8-g5k7v
        - nginx-sample-6fd7c98d8-m7vn7

      Copy to Clipboard Toggle word wrap

7. デプロイメントサイズを更新します。

   1. config/samples/demo_v1_nginx.yaml ファイルを更新して、Nginx CR の spec.size フィールドを 3 から 5 に変更します。

      $ oc patch nginx nginx-sample \
          -p '{"spec":{"replicaCount": 5}}' \
          --type=merge

      Copy to Clipboard Toggle word wrap

   2. Operator がデプロイメントサイズを変更することを確認します。

      $ oc get deployments

      Copy to Clipboard Toggle word wrap

      出力例

      NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
      nginx-operator-controller-manager       1/1     1            1           10m
      nginx-sample                            5/5     5            5           3m

      Copy to Clipboard Toggle word wrap

8. このチュートリアルの一環として作成したリソースをクリーンアップします。

   • Operator のテストに make deploy コマンドを使用した場合は、以下のコマンドを実行します。

     $ make undeploy

     Copy to Clipboard Toggle word wrap

   • Operator のテストに operator-sdk run bundle コマンドを使用した場合は、以下のコマンドを実行します。

     $ operator-sdk cleanup <project_name>

     Copy to Clipboard Toggle word wrap