Install eb-pipeline#
Install the eb-pipeline command for the account that runs the builds, from a release or from source.
These pages describe the code on the main branch.
Release 0.3.0 is older: it has no targets command, no {target} in [filesystems] paths, no rebuild.lock_timeout and no rotation locks, and it prints the same version, eb-pipeline 0.3.0.
Until the next release, install from source to have them.
Before you start#
For a release, a Linux host on x86_64 or aarch64. Its binary is linked statically against musl, so it needs no other library.
For a build from source, Rust 1.90 or newer with Cargo, and a checkout of the repository:
git clone https://github.com/stackhands/eb-pipeline.git cd eb-pipeline
~/.local/binon thePATHof the build account, or another directory there in its place below.
Install a release#
Download the archive of release 0.3.0 and its checksum, and check the archive:
curl -fsSLO https://github.com/stackhands/eb-pipeline/releases/download/v0.3.0/eb-pipeline-x86_64-unknown-linux-musl.tar.xz curl -fsSLO https://github.com/stackhands/eb-pipeline/releases/download/v0.3.0/eb-pipeline-x86_64-unknown-linux-musl.tar.xz.sha256 sha256sum -c eb-pipeline-x86_64-unknown-linux-musl.tar.xz.sha256
eb-pipeline-x86_64-unknown-linux-musl.tar.xz: OKOn aarch64, write
aarch64forx86_64in the three names.Unpack the archive:
tar -xJf eb-pipeline-x86_64-unknown-linux-musl.tar.xz ls eb-pipeline-x86_64-unknown-linux-musl
CHANGELOG.md LICENSE README.md eb-pipeline
Install the binary:
install -D -m 755 eb-pipeline-x86_64-unknown-linux-musl/eb-pipeline ~/.local/bin/eb-pipeline
Install from source#
In the checkout, build and install the binary into ~/.local/bin, with the versions of the dependencies that Cargo.lock names:
cargo install --locked --path . --root ~/.local
To install another commit, check it out first; to replace an eb-pipeline that is installed there, add --force.
Check that it worked#
command -v eb-pipeline
eb-pipeline --version
$HOME/.local/bin/eb-pipeline
eb-pipeline 0.3.0
A build from source also has the targets command:
eb-pipeline targets --help | head -n 1
Print the target names in file order, for a CI matrix or a shell loop
If it fails#
Message |
Cause |
What to do |
|---|---|---|
|
The archive is not the one the checksum names, as after a broken download. |
Download both files again, and check again. |
|
An eb-pipeline is installed there, such as a release. |
Add |
|
Cargo is older than 1.85, which cannot read the manifests of some dependencies. |
Install with Rust 1.90 or newer. |
|
The eb-pipeline on |
Install from source. |
The shell does not find |
|
Add it to |
The commands and their output on this page come from docs/examples/install.sh.