OpenShift 向けのサンドボックスコンテナーのサポート

手順

1. Web コンソールの Administrator パースペクティブで、Operators → OperatorHub に移動します。
2. Filter by keyword フィールドに OpenShift sandboxed containers と入力します。
3. OpenShift sandboxed containers タイルを選択します。
4. Operator についての情報を確認してから、Install をクリックします。

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

   1. 利用可能な Update Channel オプションから preview-1.1 を選択します。

   2. Installed Namespace で Operator recommend Namespace が選択されていることを確認します。これにより、Operator が必須の openshift-sandboxed-containers-operator namespace にインストールされます。この namespace がまだ存在しない場合は、自動的に作成されます。

      注記

      OpenShift サンドボックスコンテナー Operator を openshift-sandboxed-containers-operator 以外の namespace にインストールしようとすると、インストールが失敗します。

   3. Approval Strategy で Automatic が選択されていることを確認します。Automatic がデフォルト値であり、新しい z-stream リリースが利用可能になると、OpenShift サンドボックスコンテナーへの自動更新が有効になります。
6. Install をクリックします。

検証

1. Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動します。
2. OpenShift サンドボックスコンテナー Operator が in オペレーターリストにリストされていることを確認します。

手順

1. Web コンソールの Administrator パースペクティブで、Operators → Installed Operators に移動します。
2. オペレーターのリストから OpenShift サンドボックスコンテナーオペレーターを選択します。
3. KataConfig タブで、Create KataConfig をクリックします。
4. Create KataConfig ページで、YAML view 経由で KataConfig CR を設定することを選択します。

5. 次のマニフェストをコピーして YAML view に貼り付けます。

   apiVersion: kataconfiguration.openshift.io/v1
   kind: KataConfig
   metadata:
     name: cluster-kataconfig

   選択したノードにのみ kata を RuntimeClass としてインストールする場合は、マニフェストにラベルを含めます。

    apiVersion: kataconfiguration.openshift.io/v1
    kind: KataConfig
    metadata:
      name: cluster-kataconfig
    spec:
      kataConfigPoolSelector:
        matchLabels:
         <label_key>: '<label_value>' 

   1

   1

   kataConfigPoolSelector のラベルは単一値のみをサポートします。nodeSelector 構文はサポートされていません。

6. Create をクリックします。

検証

1. KataConfig タブで、新しい KataConfig CR を選択します。
2. KataConfig ページで、YAML タブを選択します。

3. ステータスの installationStatus フィールドをモニターします。

   更新があるたびにメッセージが表示されます。リロード をクリックして、更新された KataConfig CR を表示します。

   Completed nodes の値がワーカーまたはラベル付けされたノードの数と等しくなると、インストールは完了です。ステータスには、インストールが完了したノードの一覧も含まれます。

手順

1. Web コンソールの Administrator パースペクティブから、Workloads をデプロイメントし、作成するワークロードのタイプを選択します。
2. ワークロードページで、をクリックしてワークロードを作成します。

3. ワークロードの YAML ファイルで、コンテナーがリストされている spec フィールドに、runtimeClassName: kata を追加します。

   Pod の例

       apiVersion: v1
       kind: Pod
       metadata:
         name: example
         labels:
           app: httpd
         namespace: openshift-sandboxed-containers-operator
       spec:
         runtimeClassName: kata
         containers:
           - name: httpd
             image: 'image-registry.openshift-image-registry.svc:5000/openshift/httpd:latest'
             ports:
               - containerPort: 8080

   デプロイメントの例

       apiVersion: apps/v1
       kind: Deployment
       metadata:
         name: example
         namespace: openshift-sandboxed-containers-operator
       spec:
         selector:
           matchLabels:
             app: httpd
         replicas: 3
         template:
           metadata:
             labels:
               app: httpd
           spec:
             runtimeClassName: kata
             containers:
               - name: httpd
                 image: >-
                   image-registry.openshift-image-registry.svc:5000/openshift/httpd:latest
                 ports:
                   - containerPort: 8080

4. Save をクリックします。

手順

1. OpenShift サンドボックスコンテナー Operator の Namespace オブジェクトを作成します。

   1. 次のマニフェストを含む Namespace オブジェクト YAML ファイルを作成します。

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-sandboxed-containers-operator

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

      $ oc create -f Namespace.yaml

2. OpenShift サンドボックスコンテナー Operator の OperatorGroup オブジェクトを作成します。

   1. 次のマニフェストを含む OperatorGroup オブジェクト YAML ファイルを作成します。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: openshift-sandboxed-containers-operator
        namespace: openshift-sandboxed-containers-operator
      spec:
        targetNamespaces:
        - openshift-sandboxed-containers-operator

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

      $ oc create -f OperatorGroup.yaml

3. Subscription オブジェクトを作成して、Namespace を OpenShift サンドボックスコンテナー Operator にサブスクライブします。

   1. 次のマニフェストを含む Subscription オブジェクト YAML ファイルを作成します。

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: openshift-sandboxed-containers-operator
        namespace: openshift-sandboxed-containers-operator
      spec:
        channel: "preview-1.1"
        installPlanApproval: Automatic
        name: sandboxed-containers-operator
        source: redhat-operators
        sourceNamespace: openshift-marketplace
        startingCSV: sandboxed-containers-operator.v1.1.0

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

      $ oc create -f Subscription.yaml

手順

1. 次のマニフェストで YAML ファイルを作成します。

   apiVersion: kataconfiguration.openshift.io/v1
   kind: KataConfig
   metadata:
     name: cluster-kataconfig

2. (オプション) 選択したノードにのみ kata を RuntimeClass としてインストールする場合は、マニフェストにラベルを含む YAML ファイルを作成します。

   apiVersion: kataconfiguration.openshift.io/v1
   kind: KataConfig
   metadata:
     name: cluster-kataconfig
   spec:
     kataConfigPoolSelector:
       matchLabels:
         <label_key>: '<label_value>' 

   1

   1

   kataConfigPoolSelector のラベルは単一値のみをサポートします。nodeSelector 構文はサポートされていません。

3. KataConfig リソースを作成します。

   $ oc create -f <file name>.yaml

手順

1. kata の値で runtimeClassName を使用するすべての Pod を削除します。
2. OpenShift Container Platform Web コンソールから、Projects 一覧より openshift-sandboxed-containers を選択します。
3. Operators → Installed Operators ページに移動します。
4. OpenShift sandboxed containers をクリックします。
5. OpenShift sandboxed containers Operator タブをクリックします。
6. Operator Details のスクロールダウン一覧をクリックし、Delete KataConfig をクリックします。
7. 確認ウィンドウで Delete をクリックします。

手順

1. Operators → OperatorHub ページに移動します。
2. OpenShift sandboxed containers 検索して、Operator を選択します。
3. Uninstall をクリックします。
4. openshift-sandboxed-containers-operator namespace を削除します。

手順

1. 以下のコマンドを実行して KataConfig カスタムリソースを削除します。

   $ oc delete kataconfig <KataConfig_CR_Name>

2. 以下のコマンドを実行して KataConfig カスタムリソース定義を削除します。

   $ oc delete crd kataconfigs.kataconfiguration.openshift.io

手順

1. 以下のコマンドを実行して、OpenShift サンドボックスコンテナー Operator サブスクリプションを Operator Lifecyle Manager (OLM) から削除します。

   $ oc delete subscription openshift-sandboxed-containers-subscription -n openshift-sandboxed-containers-operator

2. 以下のコマンドを実行して、OpenShift サンドボックスコンテナーのクラスターサービスバージョン (CSV) 名を環境変数として設定します。

   CSV_NAME=$(oc get csv -n openshift-sandboxed-containers-operator -o=custom-columns=:metadata.name)

3. 以下のコマンドを実行して、OpenShift サンドボックスコンテナーの CSV 名を削除します。

   $ oc delete csv ${CSV_NAME} -n openshift-sandboxed-containers-operator