3.5. HTTP リゾルバーを使用したリモートパイプライン、タスク、またはステップアクションの指定
HTTP リゾルバーを使用して、HTTP または HTTPS URL からリモートパイプライン、タスク、または StepAction 定義を指定できます。URL は、パイプライン、タスク、またはステップアクションを定義する YAML ファイルを参照する必要があります。
3.5.1. HTTP リゾルバーの設定
HTTP リゾルバーを使用して、HTTP または HTTPS URL からパイプラインまたはタスクを取得できます。TektonConfig カスタムリソース (CR) を編集して、HTTP リゾルバーのデフォルト値を設定できます。
手順
次のコマンドを入力して、
TektonConfigCR を編集します。$ oc edit TektonConfig config
TektonConfigCR で、pipeline.http-resolver-config仕様を編集します。apiVersion: operator.tekton.dev/v1alpha1 kind: TektonConfig metadata: name: config spec: pipeline: http-resolver-config: fetch-timeout: "1m" 1- 1
- HTTP リゾルバーがサーバーからの応答を待機する最大時間。
3.5.2. HTTP Resolver でのリモートパイプライン、タスク、またはステップアクションの指定
パイプライン実行を作成するときに、HTTP または HTTPS URL からリモートパイプラインを指定できます。パイプラインまたはタスク実行を作成するときに、HTTP または HTTPS URL からリモートタスクを指定できます。タスク内でステップを作成する場合、HTTP または HTTPS URL からリモート StepAction 定義を参照できます。
手順
pipelineRef、taskRef、またはstep.ref仕様で次の形式を使用して、HTTP または HTTPS URL からリモートパイプライン、タスク、またはStepAction定義を指定します。# ... resolver: http params: - name: url value: <fully_qualified_http_url> # ...表3.6 HTTP リゾルバーでサポートされているパラメーター パラメーター 説明 値の例 url取得する Tekton リソースを指す HTTP URL。
https://raw.githubusercontent.com/openshift-pipelines/tektoncd-catalog/p/tasks/task-git-clone/0.4.1/task-git-clone.yaml
例
次のパイプライン実行の例は、同じクラスターからのリモートパイプラインを参照します。
apiVersion: tekton.dev/v1beta1
kind: PipelineRun
metadata:
name: http-pipeline-reference-demo
spec:
pipelineRef:
resolver: http
params:
- name: url
value: https://raw.githubusercontent.com/tektoncd/catalog/main/pipeline/build-push-gke-deploy/0.1/build-push-gke-deploy.yaml
params:
- name: sample-pipeline-parameter
value: test
- name: username
value: "pipelines"次のパイプラインの例では、HTTPS URL からリモートタスクを参照するタスクを定義します。
apiVersion: tekton.dev/v1beta1
kind: Pipeline
metadata:
name: pipeline-with-http-task-reference-demo
spec:
tasks:
- name: "http-task-demo"
taskRef:
resolver: http
params:
- name: url
value: https://raw.githubusercontent.com/openshift-pipelines/tektoncd-catalog/p/tasks/task-git-clone/0.4.1/task-git-clone.yaml
params:
- name: sample-task-parameter
value: test次のタスク実行例では、HTTPS URL からリモートタスクを参照します。
apiVersion: tekton.dev/v1beta1
kind: TaskRun
metadata:
name: http-task-reference-demo
spec:
taskRef:
resolver: http
params:
- name: url
value: https://raw.githubusercontent.com/openshift-pipelines/tektoncd-catalog/p/tasks/task-git-clone/0.4.1/task-git-clone.yaml
params:
- name: sample-task-parameter
value: test
次のタスクの例には、HTTPS URL から StepAction 定義を参照するステップが含まれています。
apiVersion: tekton.dev/v1
kind: Task
metadata:
name: http-stepaction-reference-demo
spec:
steps:
- name: example-step
ref:
resolver: http
params:
- name: url
value: https://raw.githubusercontent.com/openshift-pipelines/tektoncd-catalog/p/stepactions/stepaction-git-clone/0.4.1/stepaction-git-clone.yaml
params:
- name: sample-stepaction-parameter
value: test