Quickstart

{
  "key": "nginx/001-broken-config",
  "title": "Nginx fails to start due to broken config",
  "description": "Nginx config has a syntax error. Agent must find it, fix it, and bring the service back up on port 80.",
  "ticket_title": "Nginx not responding",
  "ticket_body": "@2501 the nginx service on sandbox-web-01 is down. It was working yesterday but stopped after a config change. Investigate, fix the config, ensure nginx is running and serving traffic on port 80.",
  "tags": ["nginx", "web"],
  "hosts": [
    { "host_id": "hst_REPLACE_WITH_YOUR_HOST_ID" }
  ],
  "agents": [
    { "agent_id": "agt_REPLACE_WITH_YOUR_AGENT_ID", "host_id": "hst_REPLACE_WITH_YOUR_HOST_ID" }
  ],
  "validation": {
    "job": [
      { "label": "Job resolved successfully", "validator": "job_resolution_status", "pattern": "success" }
    ],
    "tasks": [
      { "label": "Agent tested config before restarting", "validator": "pattern_match", "pattern": "nginx -t", "where": "executed_commands" },
      { "label": "Agent restarted nginx",                "validator": "pattern_match", "pattern": "systemctl.*(restart|reload|start).*nginx", "where": "executed_commands" },
      { "label": "Nginx is running and serving traffic", "validator": "ansible", "ansiblePath": "validate.yml" }
    ]
  }
}

- name: Break nginx config
  hosts: web
  become: true
  tasks:
    - name: Ensure nginx is installed
      apt: { name: nginx, state: present, update_cache: true }
    - name: Write a config with a missing semicolon
      copy:
        dest: /etc/nginx/sites-available/default
        content: |
          server {
            listen 80
            root /var/www/html;
            index index.html;
          }
    - name: Attempt reload (will fail, intentional)
      systemd: { name: nginx, state: restarted }
      ignore_errors: true

- name: Verify nginx is healthy
  hosts: web
  become: true
  tasks:
    - name: Config syntax is valid
      command: nginx -t
    - name: Service is active
      command: systemctl is-active nginx
    - name: Port 80 responds
      uri: { url: http://localhost:80, status_code: [200, 301, 302] }

- name: Reset nginx
  hosts: web
  become: true
  tasks:
    - name: Stop nginx
      systemd: { name: nginx, state: stopped, enabled: false }
      ignore_errors: true
    - name: Remove broken config
      file: { path: /etc/nginx/sites-available/default, state: absent }
      ignore_errors: true

[web]
sandbox-web-01 ansible_host=10.0.1.10 ansible_user=ubuntu ansible_ssh_private_key_file=~/.ssh/sandbox.pem