Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

6.3. OpenShift Pipelines tkn リファレンス

このセクションでは、基本的な tkn CLI コマンドのリストを紹介します。

6.3.1. 基本的な構文
リンクのコピー

tkn [command or options] [arguments…​]

6.3.2. グローバルオプション
リンクのコピー

--help, -h

6.3.3. ユーティリティーコマンド
リンクのコピー

6.3.3.1. tkn
リンクのコピー

tkn CLI の親コマンド。

例: すべてのオプションを表示する

$ tkn
Copy to Clipboard Toggle word wrap

6.3.3.2. completion [shell]
リンクのコピー

インタラクティブな補完を提供するために評価する必要があるシェル補完コードを出力します。サポートされるシェルは bash および zsh です。

例: bash シェルの補完コード

$ tkn completion bash
Copy to Clipboard Toggle word wrap

6.3.3.3. version
リンクのコピー

tkn CLI のバージョン情報を出力します。

例: tkn バージョンを確認する

$ tkn version
Copy to Clipboard Toggle word wrap

6.3.4. Pipelines 管理コマンド
リンクのコピー

6.3.4.1. パイプライン
リンクのコピー

Pipeline を管理します。

例: ヘルプを表示する

$ tkn pipeline --help
Copy to Clipboard Toggle word wrap

6.3.4.2. pipeline delete
リンクのコピー

Pipeline を削除します。

例: namespace から mypipeline Pipeline を削除します。

$ tkn pipeline delete mypipeline -n myspace
Copy to Clipboard Toggle word wrap

6.3.4.3. pipeline describe
リンクのコピー

Pipeline を記述します。

例: mypipeline Pipeline を記述します。

$ tkn pipeline describe mypipeline
Copy to Clipboard Toggle word wrap

6.3.4.4. pipeline list
リンクのコピー

Pipeline のリストを表示します。

例: Pipeline のリストを表示する

$ tkn pipeline list
Copy to Clipboard Toggle word wrap

6.3.4.5. pipeline logs
リンクのコピー

特定の Pipeline のログを表示します。

例: mypipeline Pipeline のライブログのストリーミング

$ tkn pipeline logs -f mypipeline
Copy to Clipboard Toggle word wrap

6.3.4.6. pipeline start
リンクのコピー

Pipeline を起動します。

例: mypipeline Pipeline を起動します。

$ tkn pipeline start mypipeline
Copy to Clipboard Toggle word wrap

6.3.5. Pipeline 実行コマンド
リンクのコピー

6.3.5.1. pipelinerun
リンクのコピー

Pipeline 実行を管理します。

例: ヘルプを表示する

$ tkn pipelinerun -h
Copy to Clipboard Toggle word wrap

6.3.5.2. pipelinerun cancel
リンクのコピー

Pipeline 実行をキャンセルします。

例: namespace からの mypipelinerun Pipeline 実行を取り消します。

$ tkn pipelinerun cancel mypipelinerun -n myspace
Copy to Clipboard Toggle word wrap

6.3.5.3. pipelinerun delete
リンクのコピー

Pipeline 実行を削除します。

例: namespace からの Pipeline 実行を削除する

$ tkn pipelinerun delete mypipelinerun1 mypipelinerun2 -n myspace
Copy to Clipboard Toggle word wrap

例: 最近実行された 5 つの Pipeline 実行を除き、namespace からすべての Pipeline 実行を削除する

$ tkn pipelinerun delete -n myspace --keep 5
1
Copy to Clipboard Toggle word wrap

1
5 を、保持する最近実行された Pipeline 実行の数に置き換えます。

例: すべての Pipeline を削除する

$ tkn pipelinerun delete --all
Copy to Clipboard Toggle word wrap

注記

Red Hat OpenShift Pipelines 1.6 以降では、tkn pipelinerun delete --all コマンドは、running 状態のリソースを削除しません。

6.3.5.4. pipelinerun describe
リンクのコピー

Pipeline 実行を記述します。

例: namespace での mypipelinerun Pipeline 実行を記述します。

$ tkn pipelinerun describe mypipelinerun -n myspace
Copy to Clipboard Toggle word wrap

6.3.5.5. pipelinerun list
リンクのコピー

Pipeline 実行をリストします。

例: namespace での Pipeline 実行のリストを表示する

$ tkn pipelinerun list -n myspace
Copy to Clipboard Toggle word wrap

6.3.5.6. pipelinerun logs
リンクのコピー

Pipeline 実行のログを表示します。

例: namespace のすべてのタスクおよび手順を含む mypipelinerun Pipeline 実行のログを表示します。

$ tkn pipelinerun logs mypipelinerun -a -n myspace
Copy to Clipboard Toggle word wrap

6.3.6. タスク管理コマンド
リンクのコピー

6.3.6.1. task
リンクのコピー

タスクを管理します。

例: ヘルプを表示する

$ tkn task -h
Copy to Clipboard Toggle word wrap

6.3.6.2. task delete
リンクのコピー

タスクを削除します。

例: namespace からの mytask1 および mytask2 タスクを削除します。

$ tkn task delete mytask1 mytask2 -n myspace
Copy to Clipboard Toggle word wrap

6.3.6.3. task describe
リンクのコピー

タスクを記述します。

例: namespace の mytask タスクを記述します。

$ tkn task describe mytask -n myspace
Copy to Clipboard Toggle word wrap

6.3.6.4. task list
リンクのコピー

タスクをリストします。

例: namespace のすべてのタスクをリスト表示します。

$ tkn task list -n myspace
Copy to Clipboard Toggle word wrap

6.3.6.5. task logs
リンクのコピー

タスクログを表示します。

例: mytask タスクの mytaskrun タスク実行のログを表示します。

$ tkn task logs mytask mytaskrun -n myspace
Copy to Clipboard Toggle word wrap

6.3.6.6. task start
リンクのコピー

タスクを開始します。

例: namespace の mytask タスクを開始します。

$ tkn task start mytask -s <ServiceAccountName> -n myspace
Copy to Clipboard Toggle word wrap

6.3.7. タスク実行コマンド
リンクのコピー

6.3.7.1. taskrun
リンクのコピー

タスク実行を管理します。

例: ヘルプを表示する

$ tkn taskrun -h
Copy to Clipboard Toggle word wrap

6.3.7.2. taskrun cancel
リンクのコピー

タスク実行をキャンセルします。

例: namespace からの mytaskrun タスク実行を取り消します。

$ tkn taskrun cancel mytaskrun -n myspace
Copy to Clipboard Toggle word wrap

6.3.7.3. taskrun delete
リンクのコピー

TaskRun を削除します。

例: namespace からの mytaskrun1 および mytaskrun2 タスク実行を削除します。

$ tkn taskrun delete mytaskrun1 mytaskrun2 -n myspace
Copy to Clipboard Toggle word wrap

例: namespace から最近実行された 5 つのタスク以外のすべてのタスクを削除します。

$ tkn taskrun delete -n myspace --keep 5
1
Copy to Clipboard Toggle word wrap

1
5 を、保持する最近実行したタスク実行の数に置き換えます。

6.3.7.4. taskrun describe
リンクのコピー

タスク実行を記述します。

例: namespace での mytaskrun タスク実行を記述します。

$ tkn taskrun describe mytaskrun -n myspace
Copy to Clipboard Toggle word wrap

6.3.7.5. taskrun list
リンクのコピー

タスク実行をリストします。

例: namespace のすべてのタスク実行をリストする

$ tkn taskrun list -n myspace
Copy to Clipboard Toggle word wrap

6.3.7.6. taskrun logs
リンクのコピー

タスク実行ログを表示します。

例: namespace での mytaskrun タスク実行のライブログを表示します。

$ tkn taskrun logs -f mytaskrun -n myspace
Copy to Clipboard Toggle word wrap

6.3.8. 条件管理コマンド
リンクのコピー

6.3.8.1. condition
リンクのコピー

条件を管理します。

例: ヘルプを表示する

$ tkn condition --help
Copy to Clipboard Toggle word wrap

6.3.8.2. condition delete
リンクのコピー

条件を削除します。

例: namespace からの mycondition1 条件の削除

$ tkn condition delete mycondition1 -n myspace
Copy to Clipboard Toggle word wrap

6.3.8.3. condition describe
リンクのコピー

条件を記述します。

例: namespace での mycondition1 条件の記述

$ tkn condition describe mycondition1 -n myspace
Copy to Clipboard Toggle word wrap

6.3.8.4. condition list
リンクのコピー

条件をリスト表示します。

例: namespace での条件のリスト表示

$ tkn condition list -n myspace
Copy to Clipboard Toggle word wrap

6.3.9. Pipeline リソース管理コマンド
リンクのコピー

6.3.9.1. resource
リンクのコピー

Pipeline リソースを管理します。

例: ヘルプを表示する

$ tkn resource -h
Copy to Clipboard Toggle word wrap

6.3.9.2. resource create
リンクのコピー

Pipeline リソースを作成します。

例: namespace に Pipeline リソースを作成する

$ tkn resource create -n myspace
Copy to Clipboard Toggle word wrap

これは、リソースの名前、リソースのタイプ、およびリソースのタイプに基づく値の入力を要求するインタラクティブなコマンドです。

6.3.9.3. resource delete
リンクのコピー

Pipeline リソースを削除します。

例: namespace から myresource Pipeline リソースを削除する

$ tkn resource delete myresource -n myspace
Copy to Clipboard Toggle word wrap

6.3.9.4. resource describe
リンクのコピー

Pipeline リソースを記述します。

例: myresource Pipeline リソースを記述する

$ tkn resource describe myresource -n myspace
Copy to Clipboard Toggle word wrap

6.3.9.5. resource list
リンクのコピー

Pipeline リソースをリストします。

例: namespace のすべての Pipeline リソースのリスト表示

$ tkn resource list -n myspace
Copy to Clipboard Toggle word wrap

6.3.10. ClusterTask 管理コマンド
リンクのコピー

重要

Red Hat OpenShift Pipelines 1.10 では、tkn コマンドラインユーティリティーの ClusterTask 機能が非推奨となり、今後のリリースで削除される予定です。

6.3.10.1. clustertask
リンクのコピー

ClusterTask を管理します。

例: ヘルプを表示する

$ tkn clustertask --help
Copy to Clipboard Toggle word wrap

6.3.10.2. clustertask delete
リンクのコピー

クラスターの ClusterTask リソースを削除します。

例: mytask1 および mytask2 ClusterTask の削除

$ tkn clustertask delete mytask1 mytask2
Copy to Clipboard Toggle word wrap

6.3.10.3. clustertask describe
リンクのコピー

ClusterTask を記述します。

例: mytask ClusterTask の記述

$ tkn clustertask describe mytask1
Copy to Clipboard Toggle word wrap

6.3.10.4. clustertask list
リンクのコピー

ClusterTask をリスト表示します。

例: ClusterTask のリスト表示

$ tkn clustertask list
Copy to Clipboard Toggle word wrap

6.3.10.5. clustertask start
リンクのコピー

ClusterTask を開始します。

例: mytask ClusterTask の開始

$ tkn clustertask start mytask
Copy to Clipboard Toggle word wrap

6.3.11. 管理コマンドのトリガー
リンクのコピー

6.3.11.1. eventlistener
リンクのコピー

EventListener を管理します。

例: ヘルプを表示する

$ tkn eventlistener -h
Copy to Clipboard Toggle word wrap

6.3.11.2. eventlistener delete
リンクのコピー

EventListener を削除します。

例: namespace の mylistener1 および mylistener2 EventListener を削除する

$ tkn eventlistener delete mylistener1 mylistener2 -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.3. eventlistener describe
リンクのコピー

EventListener を記述します。

例: namespace の mylistener EventListener を記述する

$ tkn eventlistener describe mylistener -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.4. eventlistener list
リンクのコピー

EventListener をリストします。

例: namespace のすべての EventListener をリストする

$ tkn eventlistener list -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.5. eventlistener ログ
リンクのコピー

EventListener のログを表示します。

例: namespace に mylistener EventListener のログを表示する

$ tkn eventlistener logs mylistener -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.6. triggerbinding
リンクのコピー

TriggerBinding を管理します。

例: TriggerBindings ヘルプを表示する

$ tkn triggerbinding -h
Copy to Clipboard Toggle word wrap

6.3.11.7. triggerbinding delete
リンクのコピー

TriggerBinding を削除します。

例: namespace の mybinding1 および mybinding2 TriggerBinding を削除する

$ tkn triggerbinding delete mybinding1 mybinding2 -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.8. triggerbinding describe
リンクのコピー

TriggerBinding を記述します。

例: namespace の mybinding TriggerBinding を記述する

$ tkn triggerbinding describe mybinding -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.9. triggerbinding list
リンクのコピー

TriggerBinding をリストします。

例: namespace のすべての TriggerBinding をリストする

$ tkn triggerbinding list -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.10. triggertemplate
リンクのコピー

TriggerTemplate を管理します。

例: TriggerTemplate ヘルプを表示する

$ tkn triggertemplate -h
Copy to Clipboard Toggle word wrap

6.3.11.11. triggertemplate delete
リンクのコピー

TriggerTemplate を削除します。

例: namespace の mytemplate1 および mytemplate2 TriggerTemplate を削除する

$ tkn triggertemplate delete mytemplate1 mytemplate2 -n `myspace`
Copy to Clipboard Toggle word wrap

6.3.11.12. triggertemplate describe
リンクのコピー

TriggerTemplate を記述します。

例: namespace の mytemplate TriggerTemplate を記述する

$ tkn triggertemplate describe mytemplate -n `myspace`
Copy to Clipboard Toggle word wrap

6.3.11.13. triggertemplate list
リンクのコピー

TriggerTemplate をリストします。

例: namespace のすべての TriggerTemplate をリストする

$ tkn triggertemplate list -n myspace
Copy to Clipboard Toggle word wrap

6.3.11.14. clustertriggerbinding
リンクのコピー

ClusterTriggerBinding を管理します。

例: ClusterTriggerBinding のヘルプを表示する

$ tkn clustertriggerbinding -h
Copy to Clipboard Toggle word wrap

6.3.11.15. clustertriggerbinding delete
リンクのコピー

ClusterTriggerBinding を削除します。

例: myclusterbinding1 および myclusterbinding2 ClusterTriggerBinding を削除する

$ tkn clustertriggerbinding delete myclusterbinding1 myclusterbinding2
Copy to Clipboard Toggle word wrap

6.3.11.16. clustertriggerbinding describe
リンクのコピー

ClusterTriggerBinding を記述します。

例: myclusterbinding ClusterTriggerBinding を記述する

$ tkn clustertriggerbinding describe myclusterbinding
Copy to Clipboard Toggle word wrap

6.3.11.17. clustertriggerbinding list
リンクのコピー

ClusterTriggerBinding のリストを表示します。

例: すべての ClusterTriggerBinding をリストする

$ tkn clustertriggerbinding list
Copy to Clipboard Toggle word wrap

6.3.12. hub 対話コマンド
リンクのコピー

タスクやパイプラインなど、リソースの Tekton Hub と対話します。

6.3.12.1. hub
リンクのコピー

ハブと対話します。

例: ヘルプを表示する

$ tkn hub -h
Copy to Clipboard Toggle word wrap

例: ハブ API サーバーと対話する

$ tkn hub --api-server https://api.hub.tekton.dev
Copy to Clipboard Toggle word wrap

注記

それぞれの例で、対応するサブコマンドとフラグを取得するには、tkn hub <command> --help を実行します。

6.3.12.2. hub downgrade
リンクのコピー

インストール済みのリソースをダウングレードします。

例: mynamespace namespace の mytask タスクを古いバージョンにダウングレードします。

$ tkn hub downgrade task mytask --to version -n mynamespace
Copy to Clipboard Toggle word wrap

6.3.12.3. hub get
リンクのコピー

名前、種類、カタログ、およびバージョン別に、リソースマニフェストを取得します。

例: tekton カタログからの特定バージョンの myresource Pipeline またはタスクのマニフェストを取得する

$ tkn hub get [pipeline | task] myresource --from tekton --version version
Copy to Clipboard Toggle word wrap

6.3.12.4. hub info
リンクのコピー

名前、種類、カタログ、およびバージョン別に、リソースに関する情報を表示します。

例: tekton カタログからの特定バージョンの mytask タスクに関する情報を表示する

$ tkn hub info task mytask --from tekton --version version
Copy to Clipboard Toggle word wrap

6.3.12.5. hub install
リンクのコピー

種類、名前、バージョンごとにカタログからのリソースをインストールします。

例: mynamespace namespace の tekton カタログから mytask タスクの特定バージョンをインストールする

$ tkn hub install task mytask --from tekton --version version -n mynamespace
Copy to Clipboard Toggle word wrap

6.3.12.6. hub reinstall
リンクのコピー

種類および名前ごとにリソースを再インストールします。

例: mynamespace namespace の tekton カタログから mytask タスクの特定バージョンを再インストールする

$ tkn hub reinstall task mytask --from tekton --version version -n mynamespace
Copy to Clipboard Toggle word wrap

6.3.12.8. hub upgrade
リンクのコピー

インストール済みのリソースをアップグレードします。

例: mynamespace namespace のインストールされた mytask タスクを新しいバージョンにアップグレードする

$ tkn hub upgrade task mytask --to version -n mynamespace
Copy to Clipboard Toggle word wrap

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat