opencode-ansible/README.md

52 lines
1.6 KiB
Markdown

# OpenCode Ansible
Dedicated Ansible orchestration repo for propagating opencode (oh-my-openagent) across the fleet.
## Structure
```
opencode-ansible/
├── ansible.cfg # Ansible configuration
├── inventory/
│ ├── opencode.yml # Main inventory
│ └── group_vars/
│ └── opencode.yml # Group-wide defaults
├── host_vars/ # Per-host overrides
├── playbooks/ # Deployment playbooks
├── roles/ # Ansible roles (if needed)
├── templates/ # Jinja2 templates
├── scripts/ # CLI wrapper scripts
├── callback_plugins/ # Audit logging
├── audit/ # JSONL audit trail
└── docs/ # Documentation
```
## Quick Start
```bash
# Check readiness of a host
ansible-playbook -i inventory/opencode.yml playbooks/readiness.yml --limit crew2
# Full deployment pipeline
bash scripts/full-deploy.sh --limit crew2
# Verify deployment
ansible-playbook -i inventory/opencode.yml playbooks/verify.yml --limit crew2
```
## Playbooks
| Playbook | Purpose |
|----------|---------|
| `readiness.yml` | Pre-install host assessment |
| `bootstrap.yml` | Install prerequisites and service accounts |
| `install.yml` | Install opencode binary/runtime |
| `config.yml` | Deploy configuration and sync repos |
| `service.yml` | Deploy and enable systemd services |
| `verify.yml` | Post-deployment health checks |
| `rollback.yml` | Revert opencode deployment |
## Target Hosts
crew2, crewsupport, llm01, erpnext, poweredget150, a10, noc, kenny-GE76-Raider-11UE