Installation

Because Cranko is delivered as a single standalone executable, it is easy to install. This is very intentional!

There are several installation options:

  • On a Unix-like operating system (Linux or macOS), the following command will place the latest release of the cranko executable into the current directory:
    curl --proto '=https' --tlsv1.2 -sSf https://pkgw.github.io/cranko/fetch-latest.sh | sh
    
    If your CI/CD environment doesn't make Cranko available in a more standardized way, this is the recommended installation command.
  • On Windows, the following PowerShell commands will do the same:
    [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager::SecurityProtocol -bor 3072
    iex ((New-Object System.Net.WebClient).DownloadString('https://pkgw.github.io/cranko/fetch-latest.ps1'))
    
  • You can manually download precompiled binaries from the Cranko GitHub release archive.
  • If you have a Rust toolchain installed, you can compile and install your own version with cargo install cranko.
  • Finally, to develop Cranko itself, you can check out the source code and build using the standard Rust framework: cargo build.

Note that, to fully implement the just-in-time versioning workflow, the cranko command will need to be available both on your development machine and on the nodes powering your CI/CD pipeline. The curl and PowerShell commands given above should make installation easy on just about any CI/CD system. The code for these installers is almost directly ripped off from Rustup and Chocolatey, respectively (thanks!), and will honor some of the environment variables used by those installers.