の多くの使用例を見ました:
jobs:
myjob:
steps:
- name: checkout
uses: "actions/checkout@something"
- ...
しかし、この行の目的が何なのかわかりません。
uses : "actions/checkout@something"
これに似ていますか?
run: git checkout something
ベストアンサー1
この行ではuses : "actions/checkout@something"
、actions/checkout
githubアクション(ソースここ) を ref で置き換えますsomething
。この ref は github アクションのバージョンのみを参照します (リポジトリとは関係ありません)
このuses
ステートメントは、このステップで使用されているgithubアクションを参照しています。github ドキュメントのためにjobs.<job_id>.steps[*].uses
:
ジョブのステップの一部として実行するアクションを選択します。アクションは再利用可能なコード単位です。ワークフローと同じリポジトリ、パブリック リポジトリ、または公開された Docker コンテナ イメージで定義されたアクションを使用できます。
このアクションは、$GITHUB_WORKSPACE の下のリポジトリをチェックアウトし、ワークフローがアクセスできるようにします。
デフォルトでは、1 つのコミットのみをチェックアウトします。私の理解では、次のような処理が行われているようです。
git fetch --depth 1 origin $GITHUB_REF
このアクションはgit configに認証トークンも保持します。これにより、ワークフローは認証されたgitコマンドを実行できます。
デフォルトでは、現在のリポジトリ ( {{ github.repository }}
) を複製しますが、このアクションを使用して別のリポジトリを複製し、 、 などの追加パラメータを指定することもtoken
できbranch
ますpath
。
追加の入力パラメータを使用した例:fetch-depth
に設定してすべてのgit履歴をチェックアウトします0
(デフォルトは1
)。使用方法ドキュメント:
- uses: actions/checkout@v2
with:
fetch-depth: 0