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. Crie o executor no CodeCHAMPREP
Seção intitulada “1. Crie o executor no CodeCHAMPREP”- Abra seu projeto (ou grupo) e acesse Configurações > CI/CD > Executores.
- Selecionar Novo executor.
- 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.
- Tags: tarefas com
- 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.
2. Registrar a máquina
Seção intitulada “2. Registrar a máquina”A maneira mais simples, em um terminal na máquina:
champrep-code-runner register --url https://code.champrep.comO 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:
printf '%s\n' "$RUNNER_TOKEN" | champrep-code-runner register \ --url https://code.champrep.com --token-stdin \ --name build-01 --executor shellchamprep-code-runner register --url https://code.champrep.com \ --token-file /root/runner-token --executor docker --docker-image alpine:3.24No Windows, a partir de um prompt do PowerShell com privilégios elevados:
$env:RUNNER_TOKEN | champrep-code-runner.exe register ` --url https://code.champrep.com --token-stdin --name win-build-01 ` --executor shell --shell pwsh
Opções comuns
Seção intitulada “Opções comuns”| Opção | Significado |
|---|---|
--url | Seu endereço no CodeCHAMPREP, por exemplo https://code.champrep.com. |
--token-stdin / --token-file PATH | Leia o token da entrada padrão ou de um arquivo. |
--name NAME | O nome do executor nesta máquina (padrão: o nome do host). |
--executor | shell, docker ou kubernetes. |
--shell | Para o executor de shell: bash, sh, pwsh ou powershell. |
--docker-image IMAGE | Imagem padrão do trabalho para os executores do Docker e do Kubernetes. |
--kubernetes-namespace NS | Executar trabalhos do Kubernetes neste namespace. |
--limit N | No máximo N tarefas simultaneamente para este executor. |
--non-interactive | Nunca solicitar confirmação; falhar se um valor estiver faltando. |
--config PATH | Utilize este arquivo de configuração (veja abaixo). |
CHPCODE_RUNNER_URL e CHPCODE_RUNNER_TOKEN pode substituir --url e as opções de token.
Onde a configuração é salva
Seção intitulada “Onde a configuração é salva”| Quando você o executa como | Arquivo |
|---|---|
| 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.
3. Inicie-o
Seção intitulada “3. Inicie-o”champrep-code-runner run # in this terminalchamprep-code-runner service install # or as a service that starts at bootConsulte Comandos do executor para verificar seu status, interrompê-lo e outras ações.