インストールおよび設定

手順

1. Web コンソールの Administrator パースペクティブで、Operators → OperatorHub に移動します。
2. Filter by keyword ボックスを使用して、カタログで Red Hat OpenShift Pipelines Operator を検索します。Red Hat OpenShift Pipelines Operator タイルをクリックします。
3. Red Hat OpenShift Pipelines Operator ページで Operator についての簡単な説明を参照してください。Install をクリックします。

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

   1. Installation Mode で All namespaces on the cluster (default) を選択します。このモードは、デフォルトの openshift-operators namespace に Operator をインストールします。これにより、Operator はクラスター内のすべての namespace を監視し、これらの namespace に対して利用可能になります。
   2. Approval Strategy で Automatic を選択します。これにより、Operator への今後のアップグレードは Operator Lifecycle Manager (OLM) によって自動的に処理されます。Manual 承認ストラテジーを選択すると、OLM は更新要求を作成します。クラスター管理者は、Operator を新規バージョンに更新できるように OLM 更新要求を手動で承認する必要があります。

   3. Update Channel を選択します。

      • pipelines-<version> チャネルは、Red Hat OpenShift Pipelines Operator をインストールするためのデフォルトのチャネルです。たとえば、Red Hat OpenShift Pipelines Operator バージョン 1.7 をインストールするためのデフォルトのチャネルは pipelines-1.7 です。

      • latest チャネルにより、Red Hat OpenShift Pipelines Operator の最新の stable バージョンがインストール可能になります。

        注記

        OpenShift Container Platform 4.11 以降、Red Hat OpenShift Pipelines Operator をインストールおよびアップグレードするための preview および stable チャネルは利用できません。ただし、OpenShift Container Platform 4.10 以前のバージョンでは、preview および stable チャンネルを使用して Operator をインストールおよびアップグレードできます。

5. Install をクリックします。Operator が Installed Operators ページにリスト表示されます。

   注記

   Operator は openshift-operators namespace に自動的にインストールされます。

6. Status が Succeeded Up to date に設定され、Red Hat OpenShift Pipelines Operator のインストールが正常に行われたことを確認します。

   警告

   他のコンポーネントのインストールが進行中の場合でも、成功ステータスが Succeeded Up to date として表示される場合があります。したがって、ターミナルで手動でインストールを確認することが重要です。

7. Red Hat OpenShift Pipelines Operator のすべてのコンポーネントが正常にインストールされたことを確認します。ターミナルでクラスターにログインし、次のコマンドを実行します。

   $ oc get tektonconfig config

   Copy to Clipboard Toggle word wrap

   出力例

   NAME     VERSION   READY   REASON
   config   1.9.2     True

   Copy to Clipboard Toggle word wrap

   READY 条件が True の場合、Operator とそのコンポーネントは正常にインストールされています。

   さらに、次のコマンドを実行して、コンポーネントのバージョンを確認します。

   $ oc get tektonpipeline,tektontrigger,tektonaddon,pac

   Copy to Clipboard Toggle word wrap

   出力例

   NAME                                          VERSION   READY   REASON
   tektonpipeline.operator.tekton.dev/pipeline   v0.41.1   True
   NAME                                        VERSION   READY   REASON
   tektontrigger.operator.tekton.dev/trigger   v0.22.2   True
   NAME                                    VERSION   READY   REASON
   tektonaddon.operator.tekton.dev/addon   1.9.2     True
   NAME                                                             VERSION   READY   REASON
   openshiftpipelinesascode.operator.tekton.dev/pipelines-as-code   v0.15.5   True

   Copy to Clipboard Toggle word wrap

手順

1. Subscription オブジェクトの YAML ファイルを作成し、namespace を Red Hat OpenShift Pipelines Operator にサブスクライブします (例: sub.yaml)。

   Subscription の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: openshift-pipelines-operator
     namespace: openshift-operators
   spec:
     channel:  <channel name> 

   1

   
     name: openshift-pipelines-operator-rh 

   2

   
     source: redhat-operators 

   3

   
     sourceNamespace: openshift-marketplace 

   4

   Copy to Clipboard Toggle word wrap

   1

   Operator のチャネル名。デフォルトチャネルは pipelines-<version> です。たとえば、Red Hat OpenShift Pipelines Operator バージョン 1.7 のデフォルトチャネルは pipelines-1.7 です。latest チャネルにより、Red Hat OpenShift Pipelines Operator の最新の stable バージョンがインストール可能になります。

   2

   サブスクライブする Operator の名前。

   3

   Operator を提供する CatalogSource の名前。

   4

   CatalogSource の namespace。デフォルトの OperatorHub CatalogSource には openshift-marketplace を使用します。

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

   $ oc apply -f sub.yaml

   Copy to Clipboard Toggle word wrap

   サブスクリプションは、Red Hat OpenShift Pipelines Operator を openshift-operators namespace にインストールします。Operator は OpenShift Pipelines をデフォルトの openshift-pipelines ターゲット namespace に自動的にインストールします。

手順

1. Web コンソールの Administrator パースペクティブで、Administration → Custom Resource Definition に移動します。
2. Filter by name ボックスに config.operator.tekton.dev を入力し、 Red Hat OpenShift Pipelines Operator CR を検索します。
3. CRD Config をクリックし、Custom Resource Definition Details ページを表示します。

4. Actions ドロップダウンメニューをクリックし、Delete Custom Resource Definition を選択します。

   注記

   CR を削除すると、Red Hat OpenShift Pipelines コンポーネントが削除され、クラスター上のすべてのタスクとパイプラインが失われます。

5. Delete をクリックし、CR の削除を確認します。

手順

1. Operators → OperatorHub ページから、Filter by keyword ボックスを使用して Red Hat OpenShift Pipelines Operator を検索します。
2. Red Hat OpenShift Pipelines Operator タイルをクリックします。Operator タイルは、Operator がインストールされていることを示します。
3. Red Hat OpenShift Pipelines Operator の説明ページで、Uninstall をクリックします。

手順

1. Web コンソールの Administrator パースペクティブで、Administration → CustomResourceDefinitions に移動します。
2. Search by name ボックスを使用して、tektonconfigs.operator.tekton.dev カスタムリソース定義 (CRD) を検索します。TektonConfig をクリックし、CRD の詳細ページを表示します。
3. Instances タブをクリックします。
4. config インスタンスをクリックして、TektonConfig CR の詳細を表示します。
5. YAML タブをクリックします。

6. 要件に応じて TektonConfig YAML ファイルを編集します。

   デフォルト値が適用された TektonConfig CR の例

   apiVersion: operator.tekton.dev/v1alpha1
   kind: TektonConfig
   metadata:
     name: config
   spec:
     pipeline:
       running-in-environment-with-injected-sidecars: true
       metrics.taskrun.duration-type: histogram
       metrics.pipelinerun.duration-type: histogram
       await-sidecar-readiness: true
       params:
         - name: enableMetrics
           value: 'true'
       default-service-account: pipeline
       require-git-ssh-secret-known-hosts: false
       enable-tekton-oci-bundles: false
       metrics.taskrun.level: task
       metrics.pipelinerun.level: pipeline
       embedded-status: both
       enable-api-fields: stable
       enable-provenance-in-status: false
       enable-custom-tasks: true
       disable-creds-init: false
       disable-affinity-assistant: true

   Copy to Clipboard Toggle word wrap