3.6. 同じクラスターからのパイプライン、タスク、またはステップアクションの指定
クラスターリゾルバーを使用して、Red Hat OpenShift Pipelines が実行されている OpenShift Container Platform クラスターの namespace で定義されるパイプライン、タスク、または StepAction
定義を指定できます。
特に、クラスターリゾルバーを使用して、OpenShift Pipelines がインストール namespace (通常は openshift-pipelines
namespace) で提供するタスクにアクセスできます。
3.6.1. クラスターリゾルバーの設定
クラスターリゾルバーのデフォルトの種類と namespace を変更したり、クラスターリゾルバーが使用できる namespace を制限したりできます。
手順
TektonConfig
カスタムリソースを編集するには、次のコマンドを入力します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc edit TektonConfig config
$ oc edit TektonConfig config
TektonConfig
カスタムリソースで、pipeline.cluster-resolver-config
仕様を編集します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow apiVersion: operator.tekton.dev/v1alpha1 kind: TektonConfig metadata: name: config spec: pipeline: cluster-resolver-config: default-kind: pipeline default-namespace: namespace1 allowed-namespaces: namespace1, namespace2 blocked-namespaces: namespace3, namespace4
apiVersion: operator.tekton.dev/v1alpha1 kind: TektonConfig metadata: name: config spec: pipeline: cluster-resolver-config: default-kind: pipeline
1 default-namespace: namespace1
2 allowed-namespaces: namespace1, namespace2
3 blocked-namespaces: namespace3, namespace4
4
3.6.2. クラスターリゾルバーを使用した同じクラスターからのパイプライン、タスク、またはステップアクションの指定
パイプライン実行を作成するときに、同じクラスター上に存在するパイプラインを指定できます。パイプラインまたはタスク実行を作成するときに、同じクラスター上に存在するタスクを指定できます。タスク内でステップを作成する場合は、同じクラスターに存在する StepAction
定義を指定できます。
手順
同じクラスターからパイプライン、タスク、または
StepAction
定義を指定するには、pipelineRef
、taskRef
、またはstep.ref
仕様で以下の参照形式を使用します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow ... ...
# ... resolver: cluster params: - name: name value: <name> - name: namespace value: <namespace> - name: kind value: [pipeline|task|stepaction] # ...
表3.7 クラスターリゾルバーでサポートされているパラメーター パラメーター 説明 値の例 name
取得するリソースの名前。
some-pipeline
namespace
リソースを含むクラスター内の namespace。
other-namespace
kind
取得するリソースの種類。
pipeline
パイプラインまたはタスクに追加のパラメーターが必要な場合は、これらのパラメーターを
params
に指定します。
例
次のパイプライン実行の例は、同じクラスターからのパイプラインを参照します。
apiVersion: tekton.dev/v1 kind: PipelineRun metadata: name: cluster-pipeline-reference-demo spec: pipelineRef: resolver: cluster params: - name: name value: some-pipeline - name: namespace value: test-namespace - name: kind value: pipeline params: - name: sample-pipeline-parameter value: test
apiVersion: tekton.dev/v1
kind: PipelineRun
metadata:
name: cluster-pipeline-reference-demo
spec:
pipelineRef:
resolver: cluster
params:
- name: name
value: some-pipeline
- name: namespace
value: test-namespace
- name: kind
value: pipeline
params:
- name: sample-pipeline-parameter
value: test
次のパイプラインの例は、同じクラスターのタスクを参照します。
apiVersion: tekton.dev/v1 kind: Pipeline metadata: name: pipeline-with-cluster-task-reference-demo spec: tasks: - name: "cluster-task-reference-demo" taskRef: resolver: cluster params: - name: name value: some-task - name: namespace value: test-namespace - name: kind value: task params: - name: sample-task-parameter value: test
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: pipeline-with-cluster-task-reference-demo
spec:
tasks:
- name: "cluster-task-reference-demo"
taskRef:
resolver: cluster
params:
- name: name
value: some-task
- name: namespace
value: test-namespace
- name: kind
value: task
params:
- name: sample-task-parameter
value: test
次のタスク実行例では、同じクラスターのタスクを参照しています。
apiVersion: tekton.dev/v1 kind: TaskRun metadata: name: cluster-task-reference-demo spec: taskRef: resolver: cluster params: - name: name value: some-task - name: namespace value: test-namespace - name: kind value: task params: - name: sample-task-parameter value: test
apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
name: cluster-task-reference-demo
spec:
taskRef:
resolver: cluster
params:
- name: name
value: some-task
- name: namespace
value: test-namespace
- name: kind
value: task
params:
- name: sample-task-parameter
value: test
次のタスクの例には、同じクラスターから StepAction
定義を参照するステップが含まれています。
apiVersion: tekton.dev/v1 kind: Task metadata: name: cluster-stepaction-reference-demo spec: steps: - name: example-step ref: resolver: cluster params: - name: name value: some-step - name: namespace value: test-namespace - name: kind value: stepaction params: - name: sample-stepaction-parameter value: test
apiVersion: tekton.dev/v1
kind: Task
metadata:
name: cluster-stepaction-reference-demo
spec:
steps:
- name: example-step
ref:
resolver: cluster
params:
- name: name
value: some-step
- name: namespace
value: test-namespace
- name: kind
value: stepaction
params:
- name: sample-stepaction-parameter
value: test