Pular para o conteúdo principal

Instalação

Há muitas maneiras possíveis de se instalar o Task. Confira os métodos disponíveis abaixo.

Gerenciador de Pacotes​

Homebrew​

Se você estiver no macOS ou Linux e tiver o Homebrew instalado, instalar o Task é tão simples quanto rodar:

brew install go-task/tap/go-task

A fórmula acima é mantida por nós mesmos.

Recentemente, o Task também foi disponibilizado no repositório oficial do Homebrew, então você também tem essa opção, se preferir:

brew install go-task

Snap​

O Task está disponível no Snapcraft, mas tenha em mente que a sua distribuição Linux deve suportar confinamento clássico (classic confinement) para Snaps para o Task funcionar corretamente:

sudo snap install task --classic

Chocolatey​

Se você estiver no Windows e tiver o Chocolatey instalado, instalar o Task é tão simples quanto rodar:

choco install go-task

Este método de instalação é mantido pela comunidade.

Scoop​

Se você está no Windows e tem o Scoop instalado, instalar o Task é tão simples quanto rodar:

scoop install task

Este método de instalação é mantido pela comunidade. Após o lançamento de uma nova versão do Task, pode levar algum tempo até que esteja disponível no Scoop.

AUR​

Se você estiver no Arch Linux, você pode instalar o Task a partir do AUR usando o seu gerenciador de pacotes favorito, como yay, pacauro ou yaourt:

yay -S go-task-bin

Alternativamente, há este pacote que instala do código fonte ao invés de baixar o binário do GitHub:

yay -S go-task

Este método de instalação é mantido pela comunidade.

Fedora​

Se você estiver no Fedora Linux, você pode instalar o Task do repositório oficial do Fedora usando dnf:

sudo dnf install go-task

Este método de instalação é mantido pela comunidade. Após o lançamento de uma nova versão do Task, pode levar algum tempo até que ela esteja disponível no Fedora.

Nix​

Se você estiver no NixOS ou tiver o Nix instalado, você pode instalar o Task a partir do nixpkgs:

nix-env -iA nixpkgs.go-task

Este método de instalação é mantido pela comunidade. Após o lançamento de uma nova versão do Task, pode levar algum tempo até que ela esteja disponível em nixpkgs.

npm​

Você também pode usar o Node e o npm para instalar o Task instalando este pacote.

npm install -g @go-task/cli

Winget​

Se você estiver usando o Windows e instalando a ferramenta de gerenciamento de pacotes winget, você pode instalar o Task a partir de winget-pkgs.

winget install Task.Task

Baixe o Binário​

Binário​

Você pode baixar o binário da página de versões no GitHub e adicionar a sua variável de ambiente $PATH.

Os pacotes DEB e RPM também estão disponíveis.

O arquivo task_checksums.txt contém a checksum SHA-256 para cada arquivo.

Script de instalação​

Também temos um script de instalação que é muito útil em cenários, como CI. Muito obrigado ao GoDownloader por permitir a geração fácil deste script.

Por padrão, o binário será baixado no diretório ./bin em relação ao diretório atual:

sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d

É possível substituir o diretório de instalação com o parâmetro -b. No Linux, escolhas comuns são ~/.local/bin e ~/bin para instalar para o usuário ou /usr/local/bin para instalar para todos os usuários:

sh -c "$(curl --location https://taskfile.dev/install.sh)" -- -d -b ~/.local/bin
cuidado

No macOS e Windows, ~/.local/bin e ~/bin não são adicionados ao $PATH por padrão.

GitHub Actions​

Se você quiser instalar o Task no GitHub Actions você pode tentar usar esta action pela equipe do Arduino:

- name: Install Task
  uses: arduino/setup-task@v1
  with:
    version: 3.x
    repo-token: ${{ secrets.GITHUB_TOKEN }}

Este método de instalação é mantido pela comunidade.

Compilar do código-fonte​

Go Modules​

Certifique-se de que você tem uma versão suportada do Go corretamente instalado e configurado. Você pode encontrar a versão mínima necessária do Go no arquivo go.mod.

Você pode então instalar a última versão globalmente ao rodar:

go install github.com/go-task/task/v3/cmd/task@latest

Ou você pode instalar em outro diretório rodando:

env GOBIN=/bin go install github.com/go-task/task/v3/cmd/task@latest
dica

Para ambientes com CI, recomendamos usar o script de instalação, que é mais rápido e mais estável, já que ele apenas baixará o último binário lançado.

Configurar auto-complete de terminal​

Baixe o arquivo de auto-completion correspondente ao seu terminal.

Todos os scripts de completion estão disponíveis no repositório do Task.

Bash​

Primeiro, certifique-se de que você instalou o bash-completion usando seu gerenciador de pacotes.

Torne o arquivo de completion executável:

chmod +x path/to/task.bash

Depois, adicione isto ao seu ~/.bash_profile:

source path/to/task.bash

ZSH​

Coloque o arquivo _task em algum lugar no seu $FPATH:

mv path/to/_task /usr/local/share/zsh/site-functions/_task

Certifique-se de que o seguinte esteja presente em seu ~/.zshrc:

autoload -U compinit
compinit -i

Recomenda-se ZSH versão 5.7 ou posterior.

Fish​

Mova o script de completion task.fish:

mv path/to/task.fish ~/.config/fish/completions/task.fish

PowerShell​

Abra seu profile script rodando:

mkdir -Path (Split-Path -Parent $profile) -ErrorAction SilentlyContinue
notepad $profile

Adicione a seguinte linha e salve o arquivo:

Invoke-Expression -Command path/to/task.ps1