Repo: score-ra/homelab-deploy (private)
CLI entry point: task (go-task runner)
Framework: Taskfile + Ansible 2.14+
Language: YAML (Taskfile), Ansible playbooks
Infrastructure as Code repository for deploying containerized applications to Linux hosts using Ansible. Manages deployment stacks (elder-care home automation, Frigate surveillance) with remote SSH/Tailscale access.
Tasks
Core Deployment
| Task | Description | Parameters |
|---|
task setup | Set up a new host with base requirements | host (default: localhost), inventory |
task deploy | Deploy a stack to a host | stack (required), host, inventory |
task update | Update a running stack | stack (required), host, inventory |
task check | Dry-run a deployment (check mode with diff) | stack (required), host, inventory |
Discovery and Diagnostics
| Task | Description | Parameters |
|---|
task discover | Discover host capabilities and save to profile | host (required), inventory |
task ping | Test connectivity to hosts | host (default: all), inventory |
task facts | Gather Ansible facts from a host | host (required), inventory |
Utilities
| Task | Description | Parameters |
|---|
task ssh | SSH into a host | host (required) |
task lint | Lint Ansible playbooks and roles | -- |
task docs | Serve documentation locally (MkDocs) | -- |
Security and Vault
| Task | Description | Parameters |
|---|
task encrypt | Encrypt a file with Ansible Vault | file (required) |
task decrypt | Decrypt a file with Ansible Vault | file (required) |
Available Stacks
| Stack | Description | Services |
|---|
| elder-care | Home automation for elder care | OpenHAB, MkDocs, Mosquitto |
| frigate | Video surveillance system | Frigate NVR |
Parameters
All tasks accept these common parameters:
| Parameter | Description | Default |
|---|
host | Target hostname from inventory | localhost |
inventory | Inventory path | inventory/staging |
stack | Deployment stack name | -- |
Prerequisites
- Python 3.8+ and Ansible 2.14+
- Task (go-task runner)
- SSH access to target hosts (key auth preferred)
- Optional: Tailscale for remote VPN access