開発ツールをインストールするためのGitHubアクション(主にGitHubリリースから)。
名前 | 必須 | 説明 | タイプ | デフォルト |
---|---|---|---|---|
道具 | 真実 | インストールするためのツール(コンマ分離リスト) | 弦 | |
チェックサム | 間違い | チェックサムを有効にするかどうか | ブール | true |
最新バージョンをインストールするには:
- uses : taiki-e/install-action@v2
with :
tool : cargo-hack
速記を使用できます(このアクションのバージョンとインストールされたツールを固定する必要がない場合):
- uses : taiki-e/install-action@cargo-hack
特定のバージョンをインストールするには、 @version
syntaxを使用します。
- uses : taiki-e/install-action@v2
with :
tool : [email protected]
パッチバージョンを省略することもできます。 (メジャーバージョンが1つ以上の場合、マイナーバージョンを省略することもできます。)
- uses : taiki-e/install-action@v2
with :
tool : [email protected]
複数のツールをインストールするには:
- uses : taiki-e/install-action@v2
with :
tool : cargo-hack,cargo-minimal-versions
または:
- uses : taiki-e/install-action@cargo-hack
- uses : taiki-e/install-action@cargo-minimal-versions
このアクションで管理されているマニフェストからインストールされているツールのリストについては、tools.mdを参照してください。
上記のリストに含まれていないツールが指定されている場合、このアクションはカーゴビンストールをフォールバックとして使用します。
フォールバックが使用されないことを確認したい場合は、 fallback: none
。
- uses : taiki-e/install-action@v2
with :
tool : cargo-hack
# Possible values:
# - none: disable all fallback
# - cargo-binstall (default): cargo-binstall (includes quickinstall)
fallback : none
新しいツールのサポートを追加する方法については、開発ガイドを参照してください。
GitHubリリースからツールをインストールすると、このアクションは、TLSV1.2+を使用してHTTPSを使用してGitHubリリースからツールまたはそのインストーラーをダウンロードします。これは基本的に、Rustupの推奨インストールと同じレベルのセキュリティであると考えられています。
さらに、このアクションでは、GitHubリリースからインストールされたすべてのツールでダウンロードされたファイルについてSHA256チェックサムを確認します。これはデフォルトで有効になり、 checksum
入力オプションをfalse
に設定することで無効にすることができます。
さらに、ツールが署名されたアーカイブを配布する場合、署名も確認します。署名検証はチェックサムを取得する段階で行われるため、チェックサムを無効にすると、署名検証も無効になります。
SNAPまたはCargo-Binstallを使用してインストールされた場合、セキュリティに関する情報については、リンクされたドキュメントを参照してください。
フォールバックが使用されないことを確認する方法については、サポートされているツールセクションを参照してください。
このアクションは、GitHubホストのランナー(Ubuntu、Macos、Windows)およびコンテナ(Ubuntu、Debian、Fedora、Centos、Alma、Opensuse、Arch、Alpine)についてテストされています。
Linuxでは、必要なツールが欠落している場合、このアクションはディストリビューションのパッケージマネージャーからそれらをインストールしようとするため、通常は事前に設定する必要はありません(CentosまたはDebian 9(または古い)、または以下で説明する非常に古いディストリビューションを除き、すでにEOLであり、Vault/Archive Reposを使用する必要があります。セットアップの場合は、CI構成の「要件のインストール」を参照してください)。
他のプラットフォームでは、少なくとも次のツールが必要です。
上記のバージョンの要件の影響を受ける既知の環境は、Curl 7.19を使用してCentos 6(2020 - 11のEOL)と、Curl 7.22を使用してUbuntu 12.04(2017-04のEOL)です(ワークアラウンドのCI構成の「要件のインストール」を参照) 。
cargo install
用のGithubアクション。オプションでApacheライセンス、バージョン2.0、またはMITライセンスのいずれかに基づいてライセンスされています。
このアクションによってインストールされている各ツールには、異なるライセンスがあります。詳細については、サポートされているツールセクションを参照してください。
明示的に特に述べない限り、Apache-2.0ライセンスで定義されているように、お客様による仕事に含めるために意図的に提出された貢献は、追加の条件なしで、上記のように二重ライセンスを取得するものとします。