# GitLab CI for zexc
## If the pipeline fails instantly with **no jobs**
That is almost never a Rust compile error. Check in order:
### 1. Enable instance (shared) runners
1. Open project → **Settings → CI/CD**
2. Expand **Runners**
3. Under **Instance runners**, turn **ON**:
*“Turn on instance runners for this project”*
4. Confirm at least one runner shows as **online** (green).
Without this, GitLab creates a pipeline that finishes **Failed** immediately and the Jobs list stays empty.
### 2. CI/CD minutes (Free tier)
GitLab.com Free has monthly CI minutes.
**Settings → Usage quotas → Pipelines** — if minutes are 0, buy/pack or wait for reset.
### 3. CI/CD enabled
**Settings → General → Visibility** — CI/CD must not be disabled.
**Settings → CI/CD → General pipelines** — “Public pipelines” optional.
### 4. Re-run after enabling runners
**Build → Pipelines → Run pipeline** (branch `main`), or push a new commit.
## What the pipeline does
| check | `check` | `cargo check` |
| check | `clippy` / `fmt` | lint (allow_failure) |
| test | `test` | lib + integration + doctests |
| build | `build` | release binary + tarball artifact |
| build | `package` | `cargo package` dry-run (main/tags) |
| release | `release` | **only** on tags `vX.Y.Z` → Generic Package + Release |
Image: `rust:latest` (must be ≥ 1.85 for edition 2024).
## Local parity
```bash
cargo check --all-targets
cargo test --lib
cargo test --tests
cargo build --release
```
## Tag release
```bash
git tag -a v1.1.0 -m "zexc 1.1.0"
git push origin v1.1.0
```