Instalação e atualização da CLI

O servidor do Jiraya distribui a CLI jiraya em api.jiraya.io, sem pedir token. É a única origem do binário: os instaladores e as atualizações sempre baixam dali e conferem o SHA-256 antes de instalar. Veja as origens do download.

InstalarCopiar link da seção

No macOS ou no Linux, em processadores x86-64 ou ARM64:

$curl -fsSL https://api.jiraya.io/install.sh | bash

No Windows, pelo PowerShell:

>irm https://api.jiraya.io/install.ps1 | iex

No Windows, use o PowerShell: o install.sh recusa rodar no Git Bash, MSYS ou Cygwin e indica o comando acima.

Confira:

$jiraya version

A saída começa com jiraya e a versão instalada, seguida do commit e da data do build.

Rodar o instalador de novo é seguro: se a versão instalada já é a mais recente, ele avisa e não muda nada; se não, atualiza.

Onde a CLI ficaCopiar link da seção

macOS e Linux. O binário fica em ~/.jiraya/bin/jiraya, numa pasta do seu usuário. O instalador cria um atalho em /usr/local/bin/jiraya para que o comando esteja no PATH. Criar esse atalho é o único passo que pode pedir sudo, e só durante a instalação.

Se não houver permissão de escrita em /usr/local/bin nem sudo, o instalador pula o atalho e adiciona ~/.jiraya/bin ao PATH no ~/.bashrc e no ~/.zshrc. Abra um terminal novo para o comando aparecer.

Para escolher outras pastas, defina as variáveis antes do bash:

$curl -fsSL https://api.jiraya.io/install.sh | JIRAYA_BIN_DIR=$HOME/bin JIRAYA_SYMLINK_DIR=$HOME/.local/bin bash

Windows. O binário fica em %USERPROFILE%\.jiraya\bin\jiraya.exe, e essa pasta é adicionada ao Path do seu usuário, sem pedir permissão de administrador. Antes de instalar, o script confere o SHA-256 do arquivo baixado com a lista publicada pelo servidor. Abra um terminal novo para que outras janelas reconheçam o comando.

Origens do downloadCopiar link da seção

Os dois instaladores conferem o SHA-256 do arquivo baixado com a lista api.jiraya.io/api/cli/checksums.txt. O install.sh não instala nada se o SHA-256 não bater, se a lista não tiver o arquivo ou se não conseguir baixar a lista.

O instalador não usa o Homebrew, mesmo que o comando brew exista na máquina.

AtualizarCopiar link da seção

Há três formas de manter a CLI em dia. Nenhuma pede sudo, porque o binário fica numa pasta do seu usuário.

Nas três, o binário novo vem do servidor do Jiraya, e o SHA-256 dele é conferido antes de substituir o atual. Uma CLI instalada antes pelo Homebrew também é atualizada assim: o binário é trocado no mesmo lugar, e o Homebrew deixa de acompanhar a versão. Para levá-la à pasta padrão, rode brew uninstall jiraya e depois o instalador.

Pelo terminalCopiar link da seção

$jiraya update

Para só saber se há versão nova, sem instalar:

$jiraya update --check

O update mostra a versão atual, o servidor consultado e a versão mais recente. O servidor é escolhido nesta ordem: a opção --server-url, a variável JIRAYA_SERVER_URL, o daemon em execução no perfil ativo e, por último, o server_url salvo na configuração do perfil. Se a configuração e o daemon apontarem para servidores diferentes, o comando avisa e usa o do daemon.

Depois que o binário é trocado, o daemon percebe a nova versão em até 10 minutos e reinicia com ela assim que não houver execução em andamento. Nenhuma execução é interrompida.

Pela interfaceCopiar link da seção

Na página Ambientes de execução, cada ambiente mostra a Versão da CLI: da máquina. Quando há versão nova disponível, use Atualizar: o daemon baixa a versão nova e reinicia.

• Só o dono do ambiente e os administradores do workspace veem o botão; os demais veem Somente leitura.
• Se houver tarefas em execução na máquina, a atualização é recusada. Tente de novo quando ela estiver ociosa.
• Um ambiente com uma versão fora de release, como um build local, mostra Build local e precisa ser atualizado na própria máquina.

AutomaticamenteCopiar link da seção

O daemon também consulta o servidor a cada 6 horas e, quando há versão nova e nenhuma execução em andamento, atualiza a CLI e reinicia sozinho. Para desligar, inicie o daemon com:

$jiraya daemon start --no-auto-update

Ou defina JIRAYA_DAEMON_AUTO_UPDATE=false no ambiente do daemon. --auto-update-interval muda o intervalo da consulta.

Problemas comunsCopiar link da seção

Depois de instalar, conecte a máquina ao workspace com jiraya setup, como mostra o Início rápido. Todos os comandos estão na referência da CLI.