5.3. 新しい Operator SDK バージョンのプロジェクトのアップグレード

手順

1. config/default/manager_auth_proxy_patch.yaml と config/rbac/auth_proxy_service.yaml ファイルに protocol フィールドを追加します。

   ...
    ports:
    - containerPort: 8443
   +  protocol: TCP
      name: https

2. config/manager/manager.yaml ファイルに以下の変更を加えます。

   1. CPU とメモリーのリソース制限を増やします。

      resources:
        limits:
      -     cpu: 100m
      -     memory: 30Mi
      +     cpu: 200m
      +     memory: 100Mi

   2. デフォルトのコンテナーマネージャーを指定するアノテーションを追加します。

      ...
      template:
        metadata:
          annotations:
            kubectl.kubernetes.io/default-container: manager
      ...

3. Makefileファイル内のすべてのターゲットにPHONYターゲットを追加します。

4. Go ベースの Operator プロジェクトの場合には、次の変更を加えます。

   1. setup-envtestバイナリーをインストールします。

   2. go.modファイルを変更して、依存関係を更新します。

      k8s.io/api v0.22.1
      k8s.io/apimachinery v0.22.1
      k8s.io/client-go v0.22.1
      sigs.k8s.io/controller-runtime v0.10.0

   3. go mod tidyコマンドを実行して、依存関係をダウンロードします。

      $ go mod tidy

   4. Makefile に以下の変更を加えます。

      ...
      
      + ENVTEST_K8S_VERSION = 1.22
      
        test: manifests generate fmt vet envtest ## Run tests.
      -   go test ./... -coverprofile cover.out
      +   KUBEBUILDER_ASSETS="$(shell $(ENVTEST) use $(ENVTEST_K8S_VERSION) -p path)" go test ./... -coverprofile cover.out
      ...
      
      - $(CONTROLLER_GEN) $(CRD_OPTIONS) rbac:roleName=manager-role webhook paths="./..." output:crd:artifacts:config=config/crd/bases
      + $(CONTROLLER_GEN) rbac:roleName=manager-role crd webhook paths="./..." output:crd:artifacts:config=config/crd/bases
      ...
      
      # Produce CRDs that work back to Kubernetes 1.11 (no version conversion)
      - CRD_OPTIONS ?= "crd:trivialVersions=true,preserveUnknownFields=false"
      ...
      - admissionReviewVersions={v1,v1beta1}
      + admissionReviewVersions=v1
      ...
      
      + ifndef ignore-not-found
      +   ignore-not-found = false
      + endif
      
      ##@ Deployment
      ...
      - sh kubectl delete -f -
      + sh kubectl delete --ignore-not-found=$(ignore-not-found) -f -

   5. make manifestコマンドを実行して Kubernetes の更新バージョンでマニフェストを生成します。

      $ make manifest

5. Ansible ベースの Operator プロジェクトの場合には、次の変更を加えます。

   1. 以下を含めるようにrequirements.ymlファイルを変更します。

      1. community.kubernetesコレクションは、kubernetes.coreコレクションに置き換えます。

         ...
         - name: kubernetes.core
           version: "2.2.0"
         ...

      2. operator_sdk.utilユーティリティーをバージョン0.2.0から0.3.1に更新します。

         ...
         - name: operator_sdk.util
           version: "0.3.1"

   2. config/manager/manager.yaml ファイルでデフォルトのリソース制限を確認します。

      ...
       # TODO(user): Configure the resources accordingly based on the project requirements.
       # More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
      
      resources:
        limits:
          cpu: 500m
          memory: 768Mi
        requests:
          cpu: 10m
          memory: 256Mi

      重要

      Operator SDK は、これらの値を妥当なデフォルト設定としてスキャフォールディングします。Operator の作成者は、プロジェクトの要件に基づいてリソース制限を設定および最適化する必要があります。

   3. オプション: make runコマンドを使用して Ansible ベースの Operator をローカルで実行する場合は、次の変更を加えます。

      1. Makefileファイルで実行ターゲットを変更します。

         ANSIBLE_ROLES_PATH="$(ANSIBLE_ROLES_PATH):$(shell pwd)/roles" $(ANSIBLE_OPERATOR) run

      2. ansible-runnerのローカルバージョンを 2.0.2 以降に更新します。

         重要

         バージョン 2.0 の時点で、ansible-runner ツールには、以前のバージョンと互換性のないコマンド署名の変更が含まれています。