Configuration Projects

Manage Ansible playbooks and Kubernetes manifests for server and cluster configuration.

Project Types

Creating a Project

Project Card Fields

Project Actions

Policy Indicators

AI Playbook Generation

For Ansible projects, ops0 can generate playbooks from natural language using Claude.

In the AI chat panel, describe what you need:

Set up nginx as a reverse proxy for a Node.js app on port 3000,
with SSL using Let's Encrypt and a systemd service for auto-restart.

ops0 generates complete Ansible YAML with tasks, handlers, and variable definitions. Review the generated code, then click Validate before deploying.

Validating Configurations

Click Validate in the toolbar to lint files before deploying:

Validation errors are shown inline in the editor. Deployments are blocked until all validation errors are resolved.

GitHub and GitLab Sync

Link a configuration project to a repository to push files, pull changes, and create pull/merge requests for review.

1. Open the project editor → click GitHub or GitLab in the toolbar
2. Select integration, repository, branch, and base path (e.g. /configs/nginx-setup)
3. Click Connect

After connecting, use Push to commit files, Pull to fetch the latest, or Create PR/MR to open a review request before applying changes.

Approval Workflow

Projects can require approval before deployments run. Approval is configured via policies.

Prerequisites

Example: Creating Projects

Ansible Project for Web Servers

Project Setup:

Name:        nginx-webserver-setup
Type:        Ansible
Target:      Server Group: production-web
Description: Configure nginx with SSL and monitoring

File Structure:

nginx-webserver-setup/
├── site.yml
├── inventory/
│   └── hosts.ini        (auto-created from target)
├── roles/
│   └── nginx/
│       ├── tasks/
│       │   └── main.yml
│       ├── handlers/
│       │   └── main.yml
│       ├── templates/
│       │   └── nginx.conf.j2
│       └── vars/
│           └── main.yml
└── vars/
    └── main.yml

Kubernetes Project for Microservice

Project Setup:

Name:        api-gateway-deploy
Type:        Kubernetes
Target:      Cluster: production-eks
Description: Deploy API gateway with HPA and ingress

File Structure:

api-gateway-deploy/
├── namespace.yml
├── deployment.yml
├── service.yml
├── configmap.yml
├── hpa.yml
└── ingress.yml

Project List View