手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブから、 Operators → OperatorHub ページに移動します。
2. Filter by keyword ボックスを使用して、カタログで Windows Machine Config Operator を検索します。Windows Machine Config Operator タイルをクリックします。
3. Operator についての情報を確認してから、Install をクリックします。

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

   1. Update Channel として stable チャネルを選択します。stable チャネルを使用すると、WMCO の最新の安定したリリースをインストールできます。
   2. WMCO は単一の namespace でのみ利用できるようにする必要があるため、インストールモード は事前に設定されます。
   3. WMCO の Installed Namespace を選択します。デフォルトの Operator の推奨される namespace は openshift-windows-machine-config-operator です。

   4. Approval Strategy を選択します。

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

1. Install をクリックします。WMCO が Installed Operators ページに一覧表示されます。

   注記

   WMCO は、openshift-windows-machine-config-operator などのように、定義した namespace に自動的にインストールされます。

2. Status に Succeeded が表示されていることを検証し、WMCO のインストールが正常に行われたことを確認します。

手順

1. WMCO の namespace を作成します。

   1. WMCO の Namespace オブジェクト YAML ファイルを作成します。例: wmco-namespace.yaml

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-windows-machine-config-operator 1

      1

      WMCO を openshift-windows-machine-config-operator namespace にデプロイすることが推奨されます。

   2. namespace を作成します。

      $ oc create -f <file-name>.yaml

      以下に例を示します。

      $ oc create -f wmco-namespace.yaml

2. WMCO の Operator グループを作成します。

   1. OperatorGroup オブジェクト YAML ファイルを作成します。例: wmco-og.yaml

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: windows-machine-config-operator
        namespace: openshift-windows-machine-config-operator
      spec:
        targetNamespaces:
        - openshift-windows-machine-config-operator

   2. Operator グループを作成します。

      $ oc create -f <file-name>.yaml

      以下に例を示します。

      $ oc create -f wmco-og.yaml

3. namespace を WMCO にサブスクライブします。

   1. Subscription オブジェクト YAML ファイルを作成します。例: wmco-sub.yaml

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: windows-machine-config-operator
        namespace: openshift-windows-machine-config-operator
      spec:
        channel: "stable" 1
        installPlanApproval: "Automatic" 2
        name: "windows-machine-config-operator"
        source: "redhat-operators" 3
        sourceNamespace: "openshift-marketplace" 4

      1

      stable をチャネルとして指定します。

      2

      承認ストラテジーを設定します。Automatic または Manual を設定できます。

      3

      windows-machine-config-operator パッケージマニフェストが含まれる、redhat-operators カタログソースを指定します。OpenShift Container Platform が、非接続クラスターとも呼ばれる制限されたネットワークにインストールされている場合、Operator LifeCycle Manager (OLM) の設定時に作成した CatalogSource オブジェクトの名前を指定します。

      4

      カタログソースの namespace。デフォルトの OperatorHub カタログソースには openshift-marketplace を使用します。

   2. サブスクリプションを作成します。

      $ oc create -f <file-name>.yaml

      以下に例を示します。

      $ oc create -f wmco-sub.yaml

      WMCO が openshift-windows-machine-config-operator にインストールされるようになりました。

4. WMCO インストールを確認します。

   $ oc get csv -n openshift-windows-machine-config-operator

   出力例

   NAME                                    DISPLAY                           VERSION   REPLACES   PHASE
   windows-machine-config-operator.1.0.0   Windows Machine Config Operator   1.0.0                Succeeded

手順

1. 説明されているようにマシンセット カスタムリソース (CR) サンプルを含む新規 YAML ファイルを作成し、そのファイルに <file_name>.yaml という名前を付けます。

   <clusterID> および <role> パラメーターの値を設定していることを確認します。

   1. 特定のフィールドに設定する値が不明な場合は、クラスターから既存のマシンセットを確認できます。

      $ oc get machinesets -n openshift-machine-api

      出力例

      NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
      agl030519-vplxk-worker-us-east-1a   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1b   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1c   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1d   0         0                             55m
      agl030519-vplxk-worker-us-east-1e   0         0                             55m
      agl030519-vplxk-worker-us-east-1f   0         0                             55m

   2. 特定のマシンセットの値を確認します。

      $ oc get machineset <machineset_name> -n \
           openshift-machine-api -o yaml

      出力例

      ...
      template:
          metadata:
            labels:
              machine.openshift.io/cluster-api-cluster: agl030519-vplxk 1
              machine.openshift.io/cluster-api-machine-role: worker 2
              machine.openshift.io/cluster-api-machine-type: worker
              machine.openshift.io/cluster-api-machineset: agl030519-vplxk-worker-us-east-1a

      1

      クラスター ID。

      2

      デフォルトのノードラベル。

2. 新規 MachineSet CR を作成します。

   $ oc create -f <file_name>.yaml

3. マシンセットの一覧を表示します。

   $ oc get machineset -n openshift-machine-api

   出力例

   NAME                                      DESIRED   CURRENT   READY   AVAILABLE   AGE
   agl030519-vplxk-windows-worker-us-east-1a    1         1         1       1        11m
   agl030519-vplxk-worker-us-east-1a            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1b            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1c            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1d            0         0                          55m
   agl030519-vplxk-worker-us-east-1e            0         0                          55m
   agl030519-vplxk-worker-us-east-1f            0         0                          55m

   新規のマシンセットが利用可能な場合、 DESIRED および CURRENT の値は一致します。マシンセットが利用可能でない場合、数分待機してからコマンドを再度実行します。

手順

1. 説明されているようにマシンセット カスタムリソース (CR) サンプルを含む新規 YAML ファイルを作成し、そのファイルに <file_name>.yaml という名前を付けます。

   <clusterID> および <role> パラメーターの値を設定していることを確認します。

   1. 特定のフィールドに設定する値が不明な場合は、クラスターから既存のマシンセットを確認できます。

      $ oc get machinesets -n openshift-machine-api

      出力例

      NAME                                DESIRED   CURRENT   READY   AVAILABLE   AGE
      agl030519-vplxk-worker-us-east-1a   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1b   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1c   1         1         1       1           55m
      agl030519-vplxk-worker-us-east-1d   0         0                             55m
      agl030519-vplxk-worker-us-east-1e   0         0                             55m
      agl030519-vplxk-worker-us-east-1f   0         0                             55m

   2. 特定のマシンセットの値を確認します。

      $ oc get machineset <machineset_name> -n \
           openshift-machine-api -o yaml

      出力例

      ...
      template:
          metadata:
            labels:
              machine.openshift.io/cluster-api-cluster: agl030519-vplxk 1
              machine.openshift.io/cluster-api-machine-role: worker 2
              machine.openshift.io/cluster-api-machine-type: worker
              machine.openshift.io/cluster-api-machineset: agl030519-vplxk-worker-us-east-1a

      1

      クラスター ID。

      2

      デフォルトのノードラベル。

2. 新規 MachineSet CR を作成します。

   $ oc create -f <file_name>.yaml

3. マシンセットの一覧を表示します。

   $ oc get machineset -n openshift-machine-api

   出力例

   NAME                                      DESIRED   CURRENT   READY   AVAILABLE   AGE
   agl030519-vplxk-windows-worker-us-east-1a    1         1         1       1        11m
   agl030519-vplxk-worker-us-east-1a            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1b            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1c            1         1         1       1        55m
   agl030519-vplxk-worker-us-east-1d            0         0                          55m
   agl030519-vplxk-worker-us-east-1e            0         0                          55m
   agl030519-vplxk-worker-us-east-1f            0         0                          55m

   新規のマシンセットが利用可能な場合、 DESIRED および CURRENT の値は一致します。マシンセットが利用可能でない場合、数分待機してからコマンドを再度実行します。