Pular para o conteúdo
Documentation

Instale o runner

O runner é um único binário para macOS, Linux e Windows nas arquiteturas amd64 e arm64. As versões são publicadas em code-downloads.champrep.com.

  • macOS 12 ou posterior, Linux ou Windows 10, 11 ou Server 2019 ou posterior.
  • Git 2.24 ou posterior em PATH. No Windows, o Git para Windows.
  • HTTPS de saída para code.champrep.com.
  • Para o executor Docker: Docker Engine 25 ou posterior executando contêineres Linux.
  • Para o executor do Kubernetes: acesse o cluster no qual as tarefas são executadas.

Terminal window
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | sh

O instalador identifica seu sistema operacional e sua arquitetura, baixa a versão mais recente e verifica se ela está de acordo com a SHA256SUMS, e instala-o em /usr/local/bin (será solicitado que sudo quando necessário). Sem acesso de gravação e sem sudo, a instalação ocorre em ~/.local/bin.

Verifique a instalação:

Terminal window
champrep-code-runner version

No PowerShell:

Terminal window
irm https://code-downloads.champrep.com/install/runner.ps1 | iex

O instalador verifica a soma de verificação e instala em %LOCALAPPDATA%\CHAMPREP\bin. Para executar o executor como um serviço do Windows, copie primeiro o arquivo binário para um local estável, por exemplo C:\Program Files\CHAMPREP\champrep-code-runner.exe.

Novas instalações recebem a versão mais recente. Para instalar uma versão específica, configure CHPCODE_RUNNER_VERSION para o instalador:

Terminal window
curl -fsSL https://code-downloads.champrep.com/install/runner.sh | CHPCODE_RUNNER_VERSION=0.1.1 sh
Terminal window
$env:CHPCODE_RUNNER_VERSION = '0.1.1'; irm https://code-downloads.champrep.com/install/runner.ps1 | iex

Defina a variável em sh, após o pipe, não em curl. Todas as versões permanecem disponíveis: releases.json lista todas elas, começando pela mais recente.

Para instalar em outro local, configure CHPCODE_INSTALL_DIR da mesma forma.

Cada versão possui uma pasta com um executável por plataforma e um SHA256SUMS arquivo:

https://code-downloads.champrep.com/releases/<version>/runner/champrep-code-runner-<os>-<arch>
https://code-downloads.champrep.com/releases/<version>/runner/SHA256SUMS

<os> é darwin, linux ou windows (os arquivos do Windows terminam em .exe), e <arch> é amd64 ou arm64. Verifique o arquivo baixado antes de executá-lo:

Terminal window
shasum -a 256 -c SHA256SUMS --ignore-missing

Os executores que já estão em execução continuam funcionando quando uma nova versão é lançada; portanto, o(a) senhor(a) pode fazer a atualização quando for mais conveniente:

  1. Interrompa o executor. As tarefas em execução serão concluídas primeiro: champrep-code-runner service stop (ou Ctrl+C em um terminal).
  2. Execute o instalador novamente, opcionalmente com CHPCODE_RUNNER_VERSION.
  3. Inicie-o: champrep-code-runner service start (ou champrep-code-runner run).

Seu registro e sua configuração são mantidos. Para voltar a uma versão anterior, instale-a da mesma maneira.

Terminal window
champrep-code-runner service uninstall # if you installed the service
champrep-code-runner unregister --all # remove this machine's runners
sudo rm /usr/local/bin/champrep-code-runner

Em seguida, exclua o executor no CodeCHAMPREP (Configurações > CI/CD > Executores) para revogar seu token.