Robert Helewka 2ffcf00570 feat: migrate freecad-mcp to GitHub fork install and refactor deployments
- Switch freecad-mcp installation from PyPI to Heluca GitHub fork,
  using a configurable git ref (freecad_mcp_git_ref) instead of
  pinned PyPI version
- Retarget freecad-mcp deployment from Caliban to Larissa, update
  port from 22032 to 22063, and change service user to freecad-mcp
- Add git to apt dependencies for pip git+https installs
- Make deployment summary use inventory_hostname instead of hardcoded host
- Refactor kernos deploy to target all ubuntu hosts with service-based
  filtering via `services` host_var, replacing static host group
2026-04-06 15:07:15 +00:00
2026-03-03 11:35:14 +00:00

Ouranos

Red Panda Approved™ Infrastructure as Code

Ouranos is an infrastructure-as-code project that provisions and manages the Ouranos Lab — a development sandbox at ouranos.helu.ca. All infrastructure is tracked in Git for fully reproducible deployments.

Component Purpose
Terraform Provisions 10 specialised Incus containers (LXC) with networking, security policies, and resource dependencies
Ansible Configures Docker, databases, observability stack, and application runtimes across all containers

Containers are named after moons of Uranus and resolved via the .incus DNS domain.

Quick Start

The Ansible virtual environment is expected at ~/env/ouranos/bin/activate.

# Provision containers
cd terraform
terraform init && terraform apply

# Configure services
cd ../ansible
source ~/env/ouranos/bin/activate
ansible-playbook site.yml

Common Operations

# Start all containers
ansible-playbook sandbox_up.yml

# Stop all containers
ansible-playbook sandbox_down.yml

# Update all hosts
ansible-playbook apt_update.yml

# Deploy a specific service
ansible-playbook <service>/deploy.yml

Documentation

Document Description
docs/ouranos.md Complete lab reference — hosts, services, routing, workflows
docs/terraform.md Terraform practices and patterns
docs/ansible.md Ansible project structure and conventions
docs/red_panda_standards.md Red Panda Approval™ quality standards

🐾 Red Panda Approval™

This project adheres to Red Panda Approval™ standards.

Description
Agathos is a comprehensive infrastructure-as-code project that provisions and manages a complete development sandbox environment. The project combines **Terraform** for infrastructure provisioning and **Ansible** for configuration management, themed around the moons of Uranus.
Readme 912 KiB
Languages
Jinja 75.2%
Python 12.7%
HCL 8.1%
HTML 3.8%
Shell 0.2%