opsbox 0.1.1

AI-powered infrastructure management

Opsbox

AI-Powered Infrastructure Management

Welcome to Opsbox, the open-source platform that adds a dash of AI magic to your infrastructure management. With our flexible plugin system and policy-as-code approach using Rego, managing your infrastructure has never been this enjoyable!

Features

• 🎛️ Plugin System: Customize and extend functionality with ease.
• 📝 Policy-as-Code with Rego: Define compliance checks and policies efficiently.
• 🤖 AI Assistance: Leverage AI models to analyze and process your infrastructure data.
• 💻 Command-Line Interface: An interactive CLI.
• 📚 Documentation Support: Generate and view documentation effortlessly using mkdocs.

Installation

Ready to dive in? Let's get you set up!

Prerequisites

• Python 3.11
• uv

Step-by-Step

1. Clone the Repository

   git clone https://github.com/sudoersllc/Opsbox.git
   cd Opsbox
   

2. Install with uv

   We use [uv] for managing dependencies. If you don't have it installed, you can get it via pip:

   pip install uv
   

   Now, let's install Opsbox:

   uv sync
   

   This command will install all required dependencies specified in pyproject.toml.

Running Opsbox

Time to see the magic in action!

Simply run:

python -m opsbox

This will launch Opsbox and display the CLI help along with available commands.

Example Usage

Want to run a specific pipeline? Here's how:

python -m opsbox --modules your_input-your_optional_assistant-your_output --opa_upload_url http://your-opa-upload-url --opa_apply_url http://your-opa-apply-url

Configuration

Opsbox is flexible when it comes to configuration. You can provide options via:

• Command-Line Arguments
• Configuration Files
• Environment Variables

Using a Configuration File

Create a file named .opsbox_conf.json in your home directory:

{
  "aws_access_key_id": "YOUR_ACCESS_KEY_ID",
  "aws_secret_access_key": "YOUR_SECRET_ACCESS_KEY",
  "aws_region": "YOUR_AWS_REGION",
  "opa_upload_url": "http://your-opa-upload-url",
  "opa_apply_url": "http://your-opa-apply-url"
}

Command-Line Arguments

You can also provide configuration options directly through the command line:

python -m opsbox --modules example_module --aws_access_key_id YOUR_ACCESS_KEY_ID --aws_secret_access_key YOUR_SECRET_ACCESS_KEY --aws_region YOUR_AWS_REGION --opa_upload_url http://your-opa-upload-url --opa_apply_url http://your-opa-apply-url

Let's Get Started!

Now that you're all set, it's time to unleash the power of AI on your infrastructure. Happy automating!