3.8. OpenShift Pipelines で提供されるステップアクション


OpenShift Pipelines は、タスクで使用できる標準の StepAction 定義を提供します。クラスターリゾルバーを使用してこの定義を参照します。

git-clone

git-clone ステップアクションは Git を使用してワークスペースでリモートリポジトリーを初期化し、クローンします。このステップアクションを使用して、このソースコードをビルドまたは処理するパイプラインの開始時にリポジトリーのクローンを作成するタスクを定義できます。

タスクでの git-clone ステップアクションの使用例

apiVersion: tekton.dev/v1
kind: Task
metadata:
  name: clone-repo-anon
spec:
# ...
  steps:
  - name: clone-repo-step
    ref:
      resolver: cluster
      params:
      - name: name
        value: git-clone
      - name: namespace
        value: openshift-pipelines
      - name: kind
        value: stepaction
    params:
    - name: URL
      value: $(params.url)
    - name: OUTPUT_PATH
      value: $(workspaces.output.path)

表3.52 git-clone ステップアクションでサポートされているパラメーター
パラメーター説明デフォルト値

OUTPUT_PATH

フェッチされた Git リポジトリーのディレクトリー。クローンされたリポジトリーデータは、ディレクトリーのルートまたは SUBDIRECTORY パラメーターで定義された相対パスに配置されます。

string

 

SSH_DIRECTORY_PATH

必要に応じて、秘密鍵、known_hostsconfig などのファイルを含む .ssh ディレクトリー。このディレクトリーを指定すると、タスクは Git リポジトリーへの認証にそれを使用します。認証情報を安全に保存するために、このディレクトリーを提供するワークスペースを Secret リソースにバインドします。

string

 

BASIC_AUTH_PATH

.gitconfig および .git-credentials ファイルを含むディレクトリー。このディレクトリーを指定すると、タスクはそのリポジトリーを Git リポジトリーへの認証に使用します。可能な場合は、認証に BASIC_AUTH_PATH ではなく SSH_DIRECTORY_PATH ディレクトリーを使用します。認証情報を安全に保存するために、このディレクトリーを提供するワークスペースを Secret リソースにバインドします。

string

 

SSL_CA_DIRECTORY_PATH

CA 証明書を含むワークスペース。このワークスペースを指定すると、Git は HTTPS を使用してリモートリポジトリーとやり取りする場合に、これらの証明書を使用してピアを検証します。

string

 

CRT_FILENAME

ssl-ca-directory ワークスペース内の認証局 (CA) のバンドルファイル名。

string

ca-bundle.crt

HTTP_PROXY

HTTP プロキシーサーバー (TLS 以外のリクエスト)。

string

 

HTTPS_PROXY

HTTPS プロキシーサーバー (TLS リクエスト)。

string

 

NO_PROXY

HTTP/HTTPS リクエストのプロキシーをオプトアウトします。

string

 

SUBDIRECTORY

タスクが Git リポジトリーを配置する output ワークスペース内の相対パス。

string

 

USER_HOME

Pod 内の Git ユーザーのホームディレクトリーへの絶対パス。

string

/home/git

DELETE_EXISTING

Git 操作を実行する前に、デフォルトのワークスペースにコンテンツが存在する場合は削除します。

string

true

VERBOSE

実行したコマンドをログに記録します。

string

false

SSL_VERIFY

グローバル http.sslVerify 値。リモートリポジトリーを信頼していない限り、このパラメーターを false に設定しないでください。

string

true

URL

Git リポジトリー URL

string

 

リビジョン

チェックアウトするリビジョン (ブランチやタグなど)。

string

main

REFSPEC

リビジョンをチェックアウトする前にタスクが取得するリポジトリーの refspec 文字列。

string

 

SUBMODULES

Git サブモジュールを初期化して取得します。

string

true

DEPTH

取得するコミットの数。"シャロークローン" は単一のコミットです。

string

1

SPARSE_CHECKOUT_DIRECTORIES

"スパースチェックアウト" を実行するための、コンマで区切られたディレクトリーパターンのリスト。

string

 
表3.53 git-clone ステップのアクションが返す結果
結果説明

COMMIT

string

クローンされた Git リポジトリー内の現在のブランチの HEAD にあるコミットの SHA ダイジェスト。

URL

string

クローンされたリポジトリーの URL。

COMMITTER_DATE

string

クローンされた Git リポジトリー内の現在のブランチの HEAD にあるコミットのエポックタイムスタンプ。

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

© 2024 Red Hat, Inc.