Pular para o conteúdo
Documentation

Registre um Runner

O registro conecta uma máquina a um executor que o senhor criou no CodeCHAMPREP. O senhor precisa do executor token de autenticação, que começa com ccrt_.

  1. Abra seu projeto (ou grupo) e acesse Configurações > CI/CD > Executores.
  2. Selecionar Novo executor.
  3. Escolha quais trabalhos ele aceita:
    • Tags: tarefas com tags: Executar apenas em executores que possuam todos esses requisitos.
    • Executar tarefas sem tag: se ele também aceita tarefas sem tags.
    • Protegido: execute apenas trabalhos de ramos e tags protegidos.
  4. Selecionar Criar executor e copie o token. Ele é exibido uma única vez.

Trate o token como uma senha. Qualquer pessoa que o possua poderá assumir seus trabalhos.

A maneira mais simples, em um terminal na máquina:

Terminal window
champrep-code-runner register --url https://code.champrep.com

O executor solicita o token (sem exibi-lo) e o executor. Ele verifica o token e, em seguida, salva o executor em seu arquivo de configuração.

Para automatizar o processo, passe o token pela entrada padrão ou a partir de um arquivo, de modo que ele nunca apareça no histórico do seu shell ou na lista de processos:

Terminal window
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \
--url https://code.champrep.com --token-stdin \
--name build-01 --executor shell
Terminal window
champrep-code-runner register --url https://code.champrep.com \
--token-file /root/runner-token --executor docker --docker-image alpine:3.24

No Windows, a partir de um prompt do PowerShell com privilégios elevados:

Terminal window
$env:RUNNER_TOKEN | champrep-code-runner.exe register `
--url https://code.champrep.com --token-stdin --name win-build-01 `
--executor shell --shell pwsh

OpçãoSignificado
--urlSeu endereço no CodeCHAMPREP, por exemplo https://code.champrep.com.
--token-stdin / --token-file PATHLeia o token da entrada padrão ou de um arquivo.
--name NAMEO nome do executor nesta máquina (padrão: o nome do host).
--executorshell, docker ou kubernetes.
--shellPara o executor de shell: bash, sh, pwsh ou powershell.
--docker-image IMAGEImagem padrão do trabalho para os executores do Docker e do Kubernetes.
--kubernetes-namespace NSExecutar trabalhos do Kubernetes neste namespace.
--limit NNo máximo N tarefas simultaneamente para este executor.
--non-interactiveNunca solicitar confirmação; falhar se um valor estiver faltando.
--config PATHUtilize este arquivo de configuração (veja abaixo).

CHPCODE_RUNNER_URL e CHPCODE_RUNNER_TOKEN pode substituir --url e as opções de token.

Quando você o executa comoArquivo
root (Linux, macOS)/etc/champrep-runner/config.toml
Um prompt com privilégios elevados ou o serviço (Windows)%ProgramData%\champrep-runner\config.toml
Qualquer outro usuário~/.champrep-runner/config.toml

CHPCODE_RUNNER_CONFIG ou --config escolha outro arquivo. O arquivo foi criado como somente legível pelo proprietário. Uma máquina pode hospedar vários executores: registre-se novamente com um diferente --name.

Terminal window
champrep-code-runner run # in this terminal
champrep-code-runner service install # or as a service that starts at boot

Consulte Comandos do executor para verificar seu status, interrompê-lo e outras ações.