Red Hat Summit3.8. OpenShift Pipelines namespace で提供されるコミュニティータスク
デフォルトでは、OpenShift Pipelines のインストールには、パイプラインで使用できる一連のコミュニティータスクが含まれています。これらのタスクは、OpenShift Pipelines インストール namespace (通常は openshift-pipelines namespace) にあります。
argocd-task-sync-and-wait
argocd-task-sync-and-wait コミュニティータスクは、Argo CD アプリケーションをデプロイし、正常になるまで待機します。
これを行うには、以下の設定が必要です。* argocd-env-configmap config map で設定された Argo CD サーバーのアドレス。* argocd-env-secret シークレットに設定された認証情報。
アドレス情報を含む config map の例
apiVersion: v1 kind: ConfigMap metadata: name: argocd-env-configmap data: ARGOCD_SERVER: https://argocd.example.com # ...
apiVersion: v1
kind: ConfigMap
metadata:
name: argocd-env-configmap
data:
ARGOCD_SERVER: https://argocd.example.com
# ...認証情報を含むシークレットの例
apiVersion: v1 kind: Secret metadata: name: argocd-env-secret data: # Option 1 ARGOCD_USERNAME: example_username ARGOCD_PASSWORD: example_password # Option 2 ARGOCD_AUTH_TOKEN: exmaple_token
apiVersion: v1
kind: Secret
metadata:
name: argocd-env-secret
data:
# Option 1
ARGOCD_USERNAME: example_username
ARGOCD_PASSWORD: example_password
# Option 2
ARGOCD_AUTH_TOKEN: exmaple_token- 1
- ユーザー名とパスワード、または認証トークンのいずれかを設定します。
argocd-task-sync-and-wait コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: argocd-task-sync-and-wait
spec:
tasks:
- name: argocd-task-sync-and-wait
params:
- name: application-name
value: example_app_name
- name: revision
value: HEAD
- name: flags
value: '--'
- name: argocd-version
value: v2.2.2
taskRef:
kind: Task
name: argocd-task-sync-and-wait
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: argocd-task-sync-and-wait
spec:
tasks:
- name: argocd-task-sync-and-wait
params:
- name: application-name
value: example_app_name
- name: revision
value: HEAD
- name: flags
value: '--'
- name: argocd-version
value: v2.2.2
taskRef:
kind: Task
name: argocd-task-sync-and-wait| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| デプロイするアプリケーションの名前。 | |
|
| デプロイするリビジョン。 |
|
|
|
| |
|
| Argo CD のバージョン。 |
|
helm-upgrade-from-repo
helm -upgrade-from-repo コミュニティータスクは、指定された Helm リポジトリーとチャートに基づいて、OpenShift Container Platform クラスターに Helm チャートをインストールまたはアップグレードします。
Helm-upgrade-from-repo コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: helm-upgrade-from-repo
spec:
tasks:
- name: helm-upgrade-from-repo
params:
- name: helm_repo
value: example_helm_repository
- name: chart_name
value: example_chart_name
- name: release_version
value: v1.0.0
- name: release_name
value: helm-release
- name: release_namespace
value: ''
- name: overwrite_values
value: ''
- name: helm_image
value: 'docker.io/lachlanevenson/k8s-helm@sha256:5c792f29950b388de24e7448d378881f68b3df73a7b30769a6aa861061fd08ae'
taskRef:
kind: Task
name: helm-upgrade-from-repo
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: helm-upgrade-from-repo
spec:
tasks:
- name: helm-upgrade-from-repo
params:
- name: helm_repo
value: example_helm_repository
- name: chart_name
value: example_chart_name
- name: release_version
value: v1.0.0
- name: release_name
value: helm-release
- name: release_namespace
value: ''
- name: overwrite_values
value: ''
- name: helm_image
value: 'docker.io/lachlanevenson/k8s-helm@sha256:5c792f29950b388de24e7448d378881f68b3df73a7b30769a6aa861061fd08ae'
taskRef:
kind: Task
name: helm-upgrade-from-repo| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| Helm リポジトリー。 | |
|
| デプロイする Helm チャート名。 | |
|
| セマンティックバージョン管理形式の Helm リリースバージョン。 |
|
|
| Helm リリース名。 |
|
|
| Helm リリースの namespace。 |
|
|
|
上書きする設定パラメーター (コンマ区切り)。例: |
|
|
| 使用する Helm イメージ。 |
|
helm-upgrade-from-source
Helm-upgrade-from-source コミュニティータスクは、指定されたチャートとソースワークスペースに基づいて、OpenShift Container Platform クラスターに Helm チャートをインストールおよびアップグレードします。
Helm-upgrade-from-source コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: helm-upgrade-from-source
spec:
tasks:
- name: helm-upgrade-from-source
params:
- name: charts_dir
value: example_directory_path
- name: release_version
value: v1.0.0
- name: release_name
value: helm-release
- name: release_namespace
value: ''
- name: overwrite_values
value: ''
- name: values_file
value: values.yaml
- name: helm_image
value: 'docker.io/lachlanevenson/k8s-helm@sha256:5c792f29950b388de24e7448d378881f68b3df73a7b30769a6aa861061fd08ae'
- name: upgrade_extra_params
value: ''
taskRef:
kind: Task
name: helm-upgrade-from-source
workspaces:
- name: source
workspace: shared-workspace
#...
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: helm-upgrade-from-source
spec:
tasks:
- name: helm-upgrade-from-source
params:
- name: charts_dir
value: example_directory_path
- name: release_version
value: v1.0.0
- name: release_name
value: helm-release
- name: release_namespace
value: ''
- name: overwrite_values
value: ''
- name: values_file
value: values.yaml
- name: helm_image
value: 'docker.io/lachlanevenson/k8s-helm@sha256:5c792f29950b388de24e7448d378881f68b3df73a7b30769a6aa861061fd08ae'
- name: upgrade_extra_params
value: ''
taskRef:
kind: Task
name: helm-upgrade-from-source
workspaces:
- name: source
workspace: shared-workspace
#...| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| Helm チャートを含むソースワークスペース内のディレクトリー。 | |
|
| セマンティックバージョン管理形式の Helm リリースバージョン。 |
|
|
| Helm リリース名。 |
|
|
| Helm リリースの namespace。 |
|
|
|
上書きする設定パラメーター (コンマ区切り)。例: |
|
|
| Helm の設定パラメーターを含むファイル。 |
|
|
| 使用する Helm イメージ。 |
|
|
| Helm アップグレードコマンドに渡される追加のパラメーター。 |
|
| ワークスペース | 説明 |
|---|---|
|
| Helm チャートを含むワークスペース。 |
jib-maven
jib-maven コミュニティータスクは、Maven プロジェクト用の Jib ツールを使用して、Java、Kotlin、Groovy、および Scala ソースをコンテナーイメージにビルドします。
jib-maven コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: jib-maven
spec:
tasks:
- name: jib-maven
params:
- name: IMAGE
value: example_image
- name: MAVEN_IMAGE
value: 'registry.redhat.io/ubi9/openjdk-17@sha256:78613bdf887530100efb6ddf92d2a17f6176542740ed83e509cdc19ee7c072d6'
- name: DIRECTORY
value: .
- name: CACHE
value: empty-dir-volume
- name: INSECUREREGISTRY
value: 'false'
- name: CACERTFILE
value: service-ca.crt
taskRef:
kind: Task
name: jib-maven
workspaces:
- name: source
workspace: shared-workspace
#...
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: jib-maven
spec:
tasks:
- name: jib-maven
params:
- name: IMAGE
value: example_image
- name: MAVEN_IMAGE
value: 'registry.redhat.io/ubi9/openjdk-17@sha256:78613bdf887530100efb6ddf92d2a17f6176542740ed83e509cdc19ee7c072d6'
- name: DIRECTORY
value: .
- name: CACHE
value: empty-dir-volume
- name: INSECUREREGISTRY
value: 'false'
- name: CACERTFILE
value: service-ca.crt
taskRef:
kind: Task
name: jib-maven
workspaces:
- name: source
workspace: shared-workspace
#...| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| ビルドするイメージの名前。 | |
|
| Maven ベースイメージ。 |
|
|
| ソースリポジトリーのルートを基準とした、アプリケーションを含むディレクトリー。 |
|
|
| Maven アーティファクトとベースイメージレイヤーをキャッシュするためのボリュームの名前。 |
|
|
| 安全でないレジストリーを許可します。 |
|
|
| 安全でないレジストリーサービスの認証局 (CA) バンドルファイル名。 |
|
| ワークスペース | 説明 |
|---|---|
|
| Maven プロジェクトが含まれるワークスペース。 |
|
| SSL 証明書が含まれるオプションのワークスペース。 |
| 結果 | 型 | 説明 |
|---|---|---|
|
|
| ビルドされたイメージのダイジェスト。 |
jib-maven コミュニティークラスタータスクからの変更
-
IMAGEおよびMAVEN_IMAGEパラメーターのデフォルト値が変更されました。
kubeconfig-creator
kubeconfig-creator コミュニティータスクは、パイプライン内の他のタスクがさまざまなクラスターにアクセスするために使用できる kubeconfig ファイルを作成します。
kubeconfig-creator コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: kubeconfig-creator
spec:
tasks:
- name: kubeconfig-creator
params:
- name: name
value: example_cluster
- name: url
value: https://cluster.example.com
- name: username
value: example_username
- name: password
value: example_password
- name: cadata
value: ''
- name: clientKeyData
value: ''
- name: clientCertificateData
value: ''
- name: namespace
value: ''
- name: token
value: ''
- name: insecure
value: 'false'
taskRef:
kind: Task
name: kubeconfig-creator
workspaces:
- name: output
workspace: shared-workspace
#...
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: kubeconfig-creator
spec:
tasks:
- name: kubeconfig-creator
params:
- name: name
value: example_cluster
- name: url
value: https://cluster.example.com
- name: username
value: example_username
- name: password
value: example_password
- name: cadata
value: ''
- name: clientKeyData
value: ''
- name: clientCertificateData
value: ''
- name: namespace
value: ''
- name: token
value: ''
- name: insecure
value: 'false'
taskRef:
kind: Task
name: kubeconfig-creator
workspaces:
- name: output
workspace: shared-workspace
#...| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| アクセスするクラスターの名前。 | |
|
| アクセスするクラスターのアドレス。 | |
|
| クラスターへの Basic 認証用のユーザー名。 | |
|
| クラスターへの Basic 認証用のパスワード。 |
|
|
| PEM でエンコードされた認証局 (CA) 証明書。 |
|
|
| TLS のクライアントキーファイルからの PEM エンコードされたデータ。 |
|
|
| TLS のクライアント証明書ファイルからの PEM エンコードされたデータ。 |
|
|
| 未指定のリクエストで使用するデフォルトの namespace。 |
|
|
| クラスターへの認証用のベアラートークン。 |
|
|
| TLS 証明書を検証せずにサーバーにアクセスするかどうかを示します。 |
|
| ワークスペース | 説明 |
|---|---|
|
|
|
pull-request
pull-request コミュニティータスクを使用すると、抽象化されたインターフェイスを通じてソースコントロール管理 (SCM) システムと対話できます。
このコミュニティータスクは、パブリック SCM インスタンスと、self-hosted またはエンタープライズ GitHub または GitLab インスタンスの両方で機能します。
ダウンロードモードでは、このタスクは、.MANIFEST ファイルを含む既存のプルリクエストの状態を pr ワークスペースに入力します。
アップロードモードでは、このタスクは .MANIFEST ファイルを含む pr ワークスペースの内容をプルリクエストの内容と比較し、内容が異なる場合は、pr ワークスペースと一致するようにプルリクエストを更新します。
pull-request コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: pull-request
spec:
spec:
tasks:
- name: pull-request
params:
- name: mode
value: upload
- name: url
value: https://github.com/example/pull/xxxxx
- name: provider
value: github
- name: secret-key-ref
value: example_secret
- name: insecure-skip-tls-verify
value: 'false'
taskRef:
kind: Task
name: pull-request
workspaces:
- name: pr
workspace: shared-workspace
#...
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: pull-request
spec:
spec:
tasks:
- name: pull-request
params:
- name: mode
value: upload
- name: url
value: https://github.com/example/pull/xxxxx
- name: provider
value: github
- name: secret-key-ref
value: example_secret
- name: insecure-skip-tls-verify
value: 'false'
taskRef:
kind: Task
name: pull-request
workspaces:
- name: pr
workspace: shared-workspace
#...| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
|
| |
|
| プルリクエストの URL。 | |
|
|
SCM システムのタイプ。サポートされる値は | |
|
|
base64 でエンコードされた SCM トークンを含む | |
|
|
|
|
| ワークスペース | 説明 |
|---|---|
|
| プルリクエストの状態が含まれるワークスペース。 |
trigger-jenkins-job
curl リクエストを使用して Jenkins ジョブをトリガーするには、trigger-jenkins-job コミュニティータスクを使用できます。
trigger-jenkins-job コミュニティータスクの使用例
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: trigger-jenkins-job
spec:
tasks:
- name: trigger-jenkins-job
params:
- name: JENKINS_HOST_URL
value: example_host_URL
- name: JOB_NAME
value: example_job_name
- name: JENKINS_SECRETS
value: jenkins-credentials
- name: JOB_PARAMS
value:
- example_param
taskRef:
kind: Task
name: trigger-jenkins-job
workspaces:
- name: source
workspace: shared-workspace
# ...
apiVersion: tekton.dev/v1
kind: Pipeline
metadata:
name: trigger-jenkins-job
spec:
tasks:
- name: trigger-jenkins-job
params:
- name: JENKINS_HOST_URL
value: example_host_URL
- name: JOB_NAME
value: example_job_name
- name: JENKINS_SECRETS
value: jenkins-credentials
- name: JOB_PARAMS
value:
- example_param
taskRef:
kind: Task
name: trigger-jenkins-job
workspaces:
- name: source
workspace: shared-workspace
# ...| パラメーター | 説明 | デフォルト値 |
|---|---|---|
|
| Jenkins が実行されているサーバー URL。 | |
|
| トリガーする必要がある Jenkins ジョブ。 | |
|
| 認証情報を含む Jenkins シークレット。 |
|
|
|
|
|
| ワークスペース | 説明 |
|---|---|
|
|
|
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}