Erich Blume
5c79a8dbe2
## Summary - Add `doc-random` mise task that selects a random documentation card for review - Add how-to/knowledgebase section with review-documentation guide - Add Caddy reference card with proxy configuration details - Fix replication tutorial sequence (tailscale-setup now links to core-services) - Fix "BluemeOps" typo in tailscale-setup - Clean up obsolete zk/ directory references from doc-links ## Deployment and Testing - [x] `mise run doc-random` works and displays a random card - [x] `mise run doc-links` passes (all wiki-links valid) - [x] Pre-commit hooks pass 🤖 Generated with [Claude Code](https://claude.com/claude-code) Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/98
41 lines
1 KiB
Markdown
41 lines
1 KiB
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 |
|
|
| [[use-pypi-proxy]] | Configure pip and publish packages to devpi |
|
|
|
|
## Documentation
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[update-documentation]] | Publish docs via build-blumeops workflow |
|
|
|
|
## Knowledge Base
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[review-documentation]] | Periodically review and maintain documentation |
|
|
|
|
## Operations
|
|
|
|
| Guide | Description |
|
|
|-------|-------------|
|
|
| [[troubleshooting]] | Diagnose and fix common issues |
|