## Summary - Create `docs/how-to/` directory with index and four how-to guides - deploy-k8s-service: Quick reference for Kubernetes deployments via ArgoCD - add-ansible-role: Adding new Ansible roles for indri services - update-tailscale-acls: Modifying Tailscale ACL policies via Pulumi - troubleshooting: Diagnosing and fixing common issues - Update exploring-the-docs to include How-to section links - Update README.md to mark Phase 4 as complete ## Deployment and Testing - [x] Pre-commit hooks pass (including doc-links validator) - [ ] Build and deploy to docs.ops.eblu.me to verify rendering 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/95
34 lines
842 B
Markdown
34 lines
842 B
Markdown
---
|
|
title: how-to
|
|
tags:
|
|
- how-to
|
|
---
|
|
|
|
# How-To Guides
|
|
|
|
Task-oriented instructions for common BlumeOps operations. These guides assume you already understand the basic concepts - see [[tutorials/index|Tutorials]] if you're learning.
|
|
|
|
## Deployment
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[deploy-k8s-service]] | Deploy a new service to Kubernetes via ArgoCD |
|
|
| [[add-ansible-role]] | Add a new Ansible role for indri services |
|
|
|
|
## Configuration
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[update-tailscale-acls]] | Update Tailscale access control policies |
|
|
|
|
## Documentation
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[update-documentation]] | Publish docs via build-blumeops workflow |
|
|
|
|
## Operations
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[troubleshooting]] | Diagnose and fix common issues |
|