Skip to main content

DevOps

Development operations infrastructure for RavenmaskOS.

Overview

The DevOps stack provides:

  • Container Runtime - Docker via Colima on macOS
  • CI/CD - GitLab CE with container registry
  • Container Management - Standardized deployment patterns
  • Tool Integration - MCP servers for Claude Code

Stack Components

ComponentPurposeDocumentation
Docker/ColimaContainer runtime[[DevOps/Docker-Colima]]
GitLab CESource control, CI/CD[[DevOps/GitLab]]
Container RegistryImage storage[[DevOps/GitLab#container-registry]]
Deployment ScriptsService management[[DevOps/Container-Management]]
MCP ServersClaude Code integration[[DevOps/MCP-Servers]]

Architecture

┌─────────────────────────────────────────────────────────┐
│ Developer Workstation │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │
│ │ Claude Code │ │ Git │ │ Docker CLI │ │
│ │ + MCP │ │ Client │ │ │ │
│ └──────┬──────┘ └──────┬──────┘ └────────┬────────┘ │
└─────────┼────────────────┼──────────────────┼───────────┘
│ │ │
▼ ▼ ▼
┌─────────────────────────────────────────────────────────┐
│ Odin │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────┐ │
│ │ GitLab │ │ Registry │ │ Colima │ │
│ │ (CI/CD) │ │ (Images) │ │ (Docker VM) │ │
│ └──────┬──────┘ └──────┬──────┘ └────────┬────────┘ │
│ │ │ │ │
│ └────────────────┴──────────────────┘ │
│ │ │
│ ▼ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Docker Containers (45+) │ │
│ │ │ │
│ │ ┌────────┐ ┌────────┐ ┌────────┐ ┌────────┐ │ │
│ │ │ norns │ │bifrost │ │livekit │ │ n8n │ ...│ │
│ │ └────────┘ └────────┘ └────────┘ └────────┘ │ │
│ └──────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘

Key Paths

PathPurpose
~/ravenhelm/services/Docker compose files
~/ravenhelm/data/Persistent volumes
~/ravenhelm/secrets/.envCentralized secrets
~/ravenhelm/scripts/Management scripts
~/ravenhelm/backups/Backup storage

Quick Reference

Deploy a Service

./scripts/deploy/deploy-service.sh <service-name>

Full Backup

./scripts/backup/backup-all.sh

View All Containers

docker ps --format 'table {{.Names}}\t{{.Status}}'

GitLab Access

Subpages

  • [[DevOps/Docker-Colima]] - Container runtime configuration
  • [[DevOps/GitLab]] - Source control and CI/CD
  • [[DevOps/Container-Management]] - Deployment patterns and scripts
  • [[DevOps/MCP-Servers]] - Claude Code tool integration

See Also

  • [[Infrastructure]] - Core platform services
  • [[Operations/Deployment]] - Deployment procedures
  • [[Operations/Backup]] - Backup procedures