How-To Guides

Task-oriented instructions for common BlumeOps operations. These guides assume you already understand the basic concepts - see Tutorials if you’re learning.

Deployment

GuideDescription
deploy-k8s-serviceDeploy a new service to Kubernetes via ArgoCD
add-ansible-roleAdd a new Ansible role for indri services

Configuration

GuideDescription
update-tailscale-aclsUpdate Tailscale access control policies
gandi-operationsManage DNS records and cycle the Gandi API token
use-pypi-proxyConfigure pip and publish packages to devpi
expose-service-publiclyExpose a service to the public internet via Fly.io + Tailscale

Documentation

GuideDescription
update-documentationPublish docs via build-blumeops workflow

Knowledge Base

GuideDescription
review-documentationPeriodically review and maintain documentation

Operations

GuideDescription
restart-indriSafely shut down and restart indri
manage-flyio-proxyDeploy, shutoff, and troubleshoot the public proxy
troubleshootingDiagnose and fix common issues