🏃 Runner Commands

Manage GitLab runners - create, configure, deploy, and cancel.

Workflow

runner new runner config runner deploy runner cancel

runner new

Create a new runner configuration.

$ cicerone runner new --name my-runner --tags "linux,docker"
Flags:
  • --name, -n - Runner name (default: hostname-runner)
  • --gitlab, -g - GitLab instance URL
  • --tags, -t - Comma-separated tags
  • --executor, -e - shell or docker (default: shell)

runner config

Configure GitLab API tokens.

$ cicerone runner config --api-token glpat-xxxxx --project group/project
Flags:
  • --api-token - GitLab personal access token
  • --project - Project path (group/project)
  • --group - Group path (for group runners)

runner deploy

Register and start your runner.

$ cicerone runner deploy
Registering runner with GitLab...
Starting gitlab-runner service...
Runner 'my-runner' is now online!

runner cancel

Unregister and archive the runner.

$ cicerone runner cancel
Unregistering runner...
Archiving configuration...
Done!

Backing Files

Runner configurations are stored in ~/.cicerone/runners/

~/.cicerone/runners/
├── state.json      # Current state and history
├── active.json     # Active runner configuration
├── tokens/
│   └── api-token   # GitLab API token (600)
└── archive/
    └── runner-*.json  # Archived configurations

Current Runners

No runner data available. Run cicerone runner show to see runners.