---
# =============================================================================
# Ansible Collections Requirements
# =============================================================================
#
# This file defines the Ansible collections required for this infrastructure.
# Install with: ansible-galaxy collection install -r collections/requirements.yml
#
# Update with: ansible-galaxy collection install -r collections/requirements.yml --upgrade
#
# =============================================================================

collections:
  # Community General Collection
  # Provides a wide range of modules and plugins for general system management
  - name: community.general
    version: ">=8.0.0"
    source: https://galaxy.ansible.com

  # Ansible POSIX Collection
  # Essential for POSIX system operations (ACLs, SELinux, sysctl, etc.)
  - name: ansible.posix
    version: ">=1.5.0"
    source: https://galaxy.ansible.com

  # Ansible Built-in Collection
  # Core Ansible modules (ping, setup, command, shell, etc.)
  - name: ansible.builtin
    source: https://galaxy.ansible.com

  # Community Crypto Collection
  # For certificate management, OpenSSL, and cryptographic operations
  - name: community.crypto
    version: ">=2.0.0"
    source: https://galaxy.ansible.com

  # Community Docker Collection
  # Docker and container management (if using Docker/Podman)
  - name: community.docker
    version: ">=3.0.0"
    source: https://galaxy.ansible.com

  # Community Libvirt Collection
  # KVM/libvirt virtualization management
  - name: community.libvirt
    version: ">=1.3.0"
    source: https://galaxy.ansible.com

  # Ansible Utils Collection
  # Utilities for network automation and data manipulation
  - name: ansible.utils
    version: ">=2.0.0"
    source: https://galaxy.ansible.com

  # Community MySQL Collection
  # MySQL/MariaDB database management
  - name: community.mysql
    version: ">=3.0.0"
    source: https://galaxy.ansible.com

  # Community PostgreSQL Collection
  # PostgreSQL database management
  - name: community.postgresql
    version: ">=3.0.0"
    source: https://galaxy.ansible.com

  # ==========================================================================
  # Cloud Provider Collections (uncomment as needed)
  # ==========================================================================

  # AWS Collection
  # - name: amazon.aws
  #   version: ">=6.0.0"
  #   source: https://galaxy.ansible.com

  # - name: community.aws
  #   version: ">=6.0.0"
  #   source: https://galaxy.ansible.com

  # Azure Collection
  # - name: azure.azcollection
  #   version: ">=1.19.0"
  #   source: https://galaxy.ansible.com

  # Google Cloud Collection
  # - name: google.cloud
  #   version: ">=1.2.0"
  #   source: https://galaxy.ansible.com

  # DigitalOcean Collection
  # - name: community.digitalocean
  #   version: ">=1.24.0"
  #   source: https://galaxy.ansible.com

  # ==========================================================================
  # CMDB and Inventory Collections (uncomment as needed)
  # ==========================================================================

  # NetBox Collection
  # - name: netbox.netbox
  #   version: ">=3.15.0"
  #   source: https://galaxy.ansible.com

  # ServiceNow Collection
  # - name: servicenow.servicenow
  #   version: ">=2.0.0"
  #   source: https://galaxy.ansible.com

  # ==========================================================================
  # Monitoring and Observability (uncomment as needed)
  # ==========================================================================

  # Grafana Collection
  # - name: community.grafana
  #   version: ">=1.6.0"
  #   source: https://galaxy.ansible.com

  # Zabbix Collection
  # - name: community.zabbix
  #   version: ">=2.1.0"
  #   source: https://galaxy.ansible.com

  # Prometheus Collection
  # - name: prometheus.prometheus
  #   version: ">=1.0.0"
  #   source: https://galaxy.ansible.com

# =============================================================================
# Installation Instructions
# =============================================================================
#
# 1. Install all collections:
#    ansible-galaxy collection install -r collections/requirements.yml
#
# 2. Install to specific path:
#    ansible-galaxy collection install -r collections/requirements.yml -p ./collections
#
# 3. Force upgrade existing collections:
#    ansible-galaxy collection install -r collections/requirements.yml --force
#
# 4. Verify installed collections:
#    ansible-galaxy collection list
#
# =============================================================================