1
0
mirror of https://github.com/go-task/task.git synced 2024-12-14 10:52:43 +02:00
task/docs/installation.md
sheldonhull 75727c3d68
fix: improve curl command install
- works on macOS
- works in Linux (tested in docker container)
2020-10-16 18:12:26 -05:00

3.4 KiB

Installation

Task offers many installation methods. Check out the available methods below.

Package Managers

Homebrew

If you're on macOS or Linux and have Homebrew installed, getting Task is as simple as running:

brew install go-task/tap/go-task

Snap

Task is available in Snapcraft, but keep in mind that your Linux distribution should allow classic confinement for Snaps to Task work right:

sudo snap install task --classic

Scoop

If you're on Windows and have Scoop installed, use extras bucket to install Task like:

scoop bucket add extras
scoop install task

This installation method is community owned. After a new release of Task, it may take some time until it's available on Scoop.

AUR

If you're on Arch Linux you can install Task from AUR using your favorite package manager such as yay, pacaur or yaourt:

yay -S taskfile-git

This installation method is community owned, but since it's -git version of the package, it's always latest available version based on the Git repository.

Get The Binary

Binary

You can download the binary from the releases page on GitHub and add to your $PATH.

DEB and RPM packages are also available.

The task_checksums.txt file contains the SHA-256 checksum for each file.

Install Script

We also have a install script, which is very useful on scenarios like CIs. Many thanks to GoDownloader for allowing easily generating this script.

# For Default Installion to ./bin with debug logging
sh -c "$(curl -ssL https://taskfile.dev/install.sh)" -- -d

# For Installation To /usr/local/bin for userwide access with debug logging
# May require sudo sh
sh -c "$(curl -ssL https://taskfile.dev/install.sh)" -- -d -b /usr/local/bin

This method will download the binary on the local ./bin directory by default.

GitHub Actions

If you want to install Task in GitHub Actions you can try using this action by the Arduino team:

- name: Install Task
  uses: Arduino/actions/setup-taskfile@master

This installation method is community owned.

Build From Source

Go Modules

First, make sure you have Go properly installed and setup.

Task requires Go Modules and doesn't officially support installing via go get anymore.

Installing in another directory:

git clone https://github.com/go-task/task
cd task

# Compiling binary to $GOPATH/bin
go install -v ./cmd/task

# Compiling it to another location.
# Use -o ./task.exe on Windows.
go build -v -o ./task ./cmd/task

For CI environments we recommend using the Install Script instead, which is faster and more stable, since it'll just download the latest released binary, instead of compiling the edge (master branch) version.