• GitHub
  • Discussions
  • Collections
  • Docker Hub
  • GitHub Actions
Ansible Logo
arillso Documentation

Getting Started

  • Quick Start Guide
    • What is arillso?
    • Choose Your Path
    • Prerequisites
    • Installation
      • Install Ansible Collections
      • Verify Installation
    • Path 1: System Administration
      • Your First Playbook
      • Next Steps
    • Path 2: Container Orchestration
      • K3s Cluster Setup
      • Docker with Fleet GitOps
      • Next Steps
    • Path 3: Monitoring & Observability
      • Grafana Alloy Setup
      • DigitalOcean Monitoring
      • Tailscale VPN
      • Next Steps
    • Complete Example: Full Stack Deployment
    • Using Container Images
    • Using Go Library
    • Using GitHub Actions
    • Common Patterns
      • Secrets Management
      • Idempotent Operations
      • Check Mode (Dry Run)
    • Troubleshooting
      • Installation Issues
      • Connection Issues
    • Next Steps
  • Development Environment
    • Prerequisites
      • System Requirements
      • Required Software
    • Quick Start Setup
      • One-Command Setup
      • Manual Setup
    • IDE Setup
      • Visual Studio Code (Recommended)
      • JetBrains IDEs (PyCharm, IntelliJ)
      • Vim/Neovim
    • .editorconfig for Ansible Collections
    • .pre-commit-config.yaml for Ansible
    • Project Configuration
    • Development Tools
      • Linters and Formatters
      • Testing Tools
    • Docker Development Environment
    • Virtual Environments
      • Python venv
      • pipx for Tools
    • Git Configuration
      • Git Hooks
      • Git Aliases
    • CI/CD Local Testing
      • Test GitHub Actions Locally
      • GitLab CI Local Testing
    • Performance Optimization
      • Ansible Configuration
      • Mitogen Strategy
    • Troubleshooting Setup
      • Common Issues
    • Environment Checklist
    • Next Steps
    • Additional Resources
      • Documentation
      • Community
  • Architecture Guide
    • Platform Overview
    • Architecture Principles
    • Component Architecture
      • Ansible Collections Layer
      • Container Images Layer
      • Go Libraries Layer
      • GitHub Actions Layer
    • Integration Patterns
      • Pattern 1: Full Stack Deployment
      • Pattern 2: Kubernetes Cluster
      • Pattern 3: GitOps with Fleet
    • Data Flow Architecture
    • Security Architecture
    • CI/CD Architecture
    • Scalability Patterns
      • Horizontal Scaling
      • Vertical Scaling
      • Multi-Region Architecture
      • High Availability
    • Deployment Strategies
      • Blue-Green Deployment
      • Rolling Updates
      • Canary Deployment
    • Observability Architecture
    • Extension Points
      • Custom Roles
      • Custom Plugins
    • Design Decisions
      • Why Ansible?
      • Why Alpine Linux?
      • Why Mitogen?
      • Why K3s over K8s?
    • Best Practices
    • Common Anti-Patterns
    • Reference Architecture
    • Next Steps

Working with arillso

  • Use Cases & Scenarios
    • Overview
    • Docker Application Server
    • K3s Cluster Setup
    • Developer Workstation
    • DigitalOcean Droplet with Monitoring
    • Helm Chart Deployment
    • Grafana Alloy Monitoring
    • System Hardening
    • Multi-Region Tailscale Mesh
    • Run Playbooks in Docker Container
    • Programmatic Ansible with Go
    • GitHub Actions CI/CD
    • Next Steps
  • Complete Examples
    • Example 1: Docker Server Setup
    • Example 2: K3s Cluster
    • Example 3: Developer Workstation
    • Example 4: Multi-Server Tailscale Mesh
    • Example 5: Helm Chart Deployment
    • Example 6: Docker Container Execution
    • Example 7: Go Application Integration
    • Example 8: GitHub Actions Deployment
    • Example 9: K3s + Fleet + Monitoring
    • Example 10: Multi-Host Firewall
    • Example 11: Secret Management
    • Tips & Best Practices
    • Next Steps
  • Security & Best Practices
    • Security Philosophy
    • Secrets Management
      • Using Ansible Vault
      • Using Bitwarden Secrets
      • Environment Variables
    • SSH Security
      • SSH Key Management
      • SSH Hardening
    • Firewall Configuration
      • Basic Firewall Setup
      • Advanced Firewall Rules
      • Network Segmentation
    • System Hardening
      • Kernel Hardening
      • Package Management
    • Container Security
      • Docker Security
      • Kubernetes Security
    • Monitoring & Auditing
      • Security Monitoring
      • Audit Logging
    • Compliance
      • CIS Benchmarks
    • Best Practices Checklist
      • Infrastructure Security
      • Container Security
      • Monitoring & Compliance
    • Common Security Mistakes
    • Security Resources
      • Documentation
      • Tools
    • Next Steps
  • Ansible Role & Collection Design
    • Part 1 - The Role
      • The Guiding Principle
      • Directory Structure - The Minimum
      • Rule 1 - Prefix Everything
      • Rule 2 - Defaults Explain the Why
        • Every Variable Lives in Three Places
      • Rule 3 - argument_specs Is the Contract
      • Rule 4 - <role>_enabled as Master Switch
      • Rule 5 - tasks/main.yml Is a Dispatcher
        • import_tasks vs. include_tasks
      • Rule 6 - Composition, but Only for Real Substance
        • The Test: What Is Inside the Called Role?
        • How It Looks
        • When to Leave It Alone
        • The Price of Coupling
      • Rule 7 - Use set_fact Sparingly
      • Rule 8 - Namespace Your Handlers
      • Rule 9 - Idempotence Is Not Negotiable
      • Rule 10 - no_log on Secrets
      • Rule 11 - FQCN Everywhere
    • Part 2 - The Collection
      • The Collection Is the Standard Unit
      • Structure
      • galaxy.yml - The Dependency Contract
      • meta/runtime.yml
      • Take SemVer Seriously
      • Test Pyramid
      • Molecule Scenario
      • Makefile as Entry Point
    • Part 3 - Architecture Level
      • Layers
      • What Belongs in the Playbook - and What Does Not
      • module_defaults Against Parameter Duplication
      • Secrets
      • Error Handling
      • Performance
    • Pre-Merge Checklist
      • Role
      • Collection

Reference

  • Version Compatibility
    • Supported Versions
      • Current Release Status
      • Version Support Policy
    • Requirements
      • Ansible Requirements
      • Python Requirements
    • Operating System Support
      • Control Node (Where Ansible Runs)
      • Managed Nodes (Target Hosts)
    • Architecture Support
    • Collection Compatibility
      • Inter-Collection Compatibility
      • Community Collections
    • Third-Party Tool Versions
      • Container Runtimes
      • Monitoring Tools
    • Upgrade Guides
      • Upgrading Collections
    • Migration Paths
      • From Other Collections
      • From Manual Configuration
    • Breaking Changes
      • Version 1.x Breaking Changes
      • Planned Deprecations
    • Version Pinning
      • Best Practices
      • Lock Files
    • Compatibility Testing
      • Testing Different Versions
      • Matrix Testing
    • Known Issues
      • Current Known Issues
      • Version-Specific Issues
    • Compatibility Checklist
      • Before Upgrading
      • After Upgrading
    • Getting Help
      • Version-Related Issues
    • Release Calendar
      • Release Schedule
    • Next Steps
  • Troubleshooting & FAQ
    • Installation Issues
      • Collection Not Found
      • Version Conflicts
      • Permission Denied During Install
    • Connection Issues
      • SSH Connection Failed
      • Permission Denied (Publickey)
      • Sudo Password Required
    • Role & Collection Issues
      • Role Not Found
      • Module Not Found
      • Variable Not Defined
    • Performance Issues
      • Playbook Runs Slowly
      • High Memory Usage
    • Collection-Specific Issues
      • arillso.system Issues
      • arillso.container Issues
      • arillso.agent Issues
    • Debugging Techniques
      • Verbose Output
      • Check Mode (Dry Run)
      • Debug Module
      • Tags for Selective Execution
      • Step-by-Step Execution
      • Syntax Checking
    • Frequently Asked Questions
      • General Questions
      • Installation & Setup
      • Configuration
      • Performance
      • Security
      • Compatibility
    • Getting Help
      • Where to Get Help
    • Error Reference
      • Common Error Messages
    • Next Steps
  • Repository Standards
    • Core Principles
    • Required Files
      • Every Repository Must Have
      • Recommended Structure
    • README.md Structure
      • Minimal Format
      • Guidelines
    • LICENSE Format
      • Copyright Year Format
    • GitHub Configuration
      • CODEOWNERS
      • Renovate Configuration
      • GitHub Rulesets
    • Workflow Standards
      • Naming Convention
      • Standard Workflows
      • GitHub Actions Security
      • Schedule Frequency
    • Ansible Collection Standards
      • Required Files
      • Testing Philosophy
      • CI Workflow Structure
      • Linting Standards
      • Release Process
      • Publish Workflow
      • Documentation
      • Version Variables
    • Go Project Standards
    • Docker/Container Standards
    • AI Agent Documentation
      • CLAUDE.md
      • AGENTS.md Structure
    • CHANGELOG Format
    • Issue Templates
      • Required for Ansible Collections
    • Pull Request Template
      • Required for Ansible Collections
    • What NOT to Include
      • Files to Avoid
  • CI/CD & Linting
    • Workflow Standards
      • General Principles
      • Workflow Template Structure
    • CI Workflow (pull-request.yml, merge.yml)
      • Standard Linting Workflow
    • CodeQL Workflow (nightly-security.yml)
      • Security Scanning
    • Deploy/Publish Workflow
      • For Docker/Actions (tag.yml)
      • For Ansible Collections (tag.yml)
    • Linter Configurations
      • YAML Lint (.yamllint.yml)
      • Go Lint (.golangci.yml)
      • Ansible Lint (.ansible-lint)
      • EditorConfig (.editorconfig)
    • Common Linter Commands
      • Local Testing
      • Install Linters
    • Pre-commit Hooks
      • Optional but Recommended
    • GitHub Actions Best Practices
      • SHA Pinning
      • Caching
      • Matrix Testing
      • Concurrency Control
      • Conditional Steps
      • Path Filters
    • Troubleshooting
      • Common Issues
      • Debugging Workflows
  • Contributing
    • General Guidelines
      • Code of Conduct
      • Prerequisites
      • Types of Contributions
    • Ansible Collection Standards
      • File Organization
      • Code Style
      • Best Practices
      • Variable Documentation
      • Testing Requirements
      • Release Process
    • Go Project Standards
      • Code Style
      • Testing
      • Documentation
    • Docker/Container Standards
      • Dockerfile Best Practices
      • Testing
    • GitHub Actions Standards
      • Action Development
      • Action.yml Structure
    • Commit Guidelines
      • Commit Message Format
    • Pull Request Process
      • 1. Prepare Your Changes
      • 2. Create Pull Request
      • 3. PR Review Process
      • 4. After Merge
    • Documentation Standards
      • README Structure
      • Inline Documentation
    • Version Compatibility
    • CI/CD Workflows
    • Security Guidelines
      • Secrets Management
      • Dependency Management
      • Code Security
    • Getting Help
    • Community
    • Questions?

Ansible Collections

  • Collection Index
    • Collections in the arillso Namespace
      • arillso.agent
        • Description
        • Plugin Index
        • Role Index
      • arillso.container
        • Description
        • Plugin Index
        • Role Index
      • arillso.system
        • Description
        • Plugin Index
        • Role Index

Container Images

  • Container Index
    • Docker Images
      • docker.ansible
        • docker.ansible

Go Libraries

  • Libraries Index
    • Go Libraries
      • go.ansible
        • go.ansible

GitHub Actions

  • GitHub Actions Index
    • Actions
      • action.playbook
        • action.playbook

Plugin References

  • Index of all Filter Plugins
    • arillso.container
    • arillso.system
  • Index of all Lookup Plugins
    • arillso.system
  • Index of all Modules
    • arillso.system
  • Index of all Roles
    • arillso.agent
    • arillso.container
    • arillso.system

Additional Resources

  • Index of all Collection Environment Variables
arillso
  • Search

© Copyright arillso contributors.

Quick Start Collections FAQ Contributing GitHub Ansible Galaxy