Navigating the App
zCICD appears in Odoo as a top-level app called CICD. Which menu items you can see depends on your role — if something described here is missing for you, see User Roles.
The main menu
| Menu | What you find there | Visible to |
|---|---|---|
| Dashboard | Overview of the system's current state | Everyone |
| Dev | Development instances | Everyone |
| Prod | Production instances | Developers and up |
| Branches | Every branch zCICD knows about — the main working area | Everyone |
| Test Runs | Results of past and running test runs | Developers and up |
| Releases | Release planning and deployment | Developers and up |
| Dumps | Available database dumps | Dump-download roles, Managers |
| Compressor | Jobs that shrink and anonymise dumps | Everyone |
| Tasks | Background jobs across the whole system | Developers and up |
| Logging | Live Logs and stored log lines | Managers |
| Configuration | Everything below | Managers |
Most day-to-day work happens under Branches.
Configuration
The Configuration menu is manager-only and holds the system's wiring:
| Item | Purpose |
|---|---|
| Repositories | Connected Git repositories — see Repositories |
| Machines | Servers that instances run on |
| Registries | Docker registries for built images |
| Postgres Server | Database servers available to instances |
| Ticket-Systems | Jira and similar integrations |
| Schedules | Recurring job definitions |
| Epics | Groupings of related branches |
| Branch-Types | Branch classifications |
| CICD Container | Direct container logs for zCICD itself |
| Configuration Backup | Export and restore of the zCICD configuration |
| Update cicd | Updates the zCICD application itself |
The branch screen
Opening a branch from Branches is where you will spend most of your time. The screen is organised as:
- a header showing the branch name, its state, the latest commit and the workspace directory
- an Actions area with the buttons that operate on the instance — these are documented in Branch Actions
- a Tasks tab showing background jobs for this branch, and whether they succeeded
- tabs for commits, test runs and releases relating to this branch
A note on background work
Almost nothing in zCICD happens synchronously. Pressing Build does not freeze your browser — it creates a task that runs on the server and reports back.
This means two things in practice:
- After pressing a button, watch the Tasks tab rather than waiting for the page to change.
- If something appears not to have worked, the task's log is the place to look first, not the Odoo error log.