Skip to main content

Orchestr8 - Enterprise GitOps platform for Kubernetes orchestration

Project description

Orchestr8

A unified SDK and CLI for automated Kubernetes platform management using GitOps principles.

Features

  • 🚀 Zero-touch cluster bootstrapping - Automated setup with minimal manual steps
  • 🔐 Integrated secrets management - AWS/GCP Secrets Manager support with automatic generation
  • 🤖 Multiple interfaces - Use as CLI or SDK for programmatic access
  • ☁️ Multi-cloud ready - Support for AWS, GCP, Azure, and local development
  • 🔄 GitOps native - Built on ArgoCD with the app-of-apps pattern
  • 🩺 Built-in diagnostics - Auto-running health checks and environment validation

Installation

# Install from PyPI
uv tool install orchestr8-platform

# Or add to your project
uv add orchestr8-platform

Quick Start

CLI Usage

# Interactive setup
o8 setup

# Non-interactive setup
o8 setup \
  --provider aws \
  --cluster my-cluster \
  --domain platform.example.com \
  --github-org my-org \
  --region us-east-1

# Check status and validate environment
o8 status
o8 doctor

# Validate prerequisites
o8 validate

SDK Usage

from orchestr8 import Orchestr8SDK, Config, CloudProvider
from orchestr8.core.config import GitHubConfig

# Create configuration
config = Config(
    provider=CloudProvider.AWS,
    region="us-east-1",
    cluster_name="my-cluster",
    domain="platform.example.com",
    github=GitHubConfig(
        org="my-org",
        token="ghp_..."
    )
)

# Initialize SDK
sdk = Orchestr8SDK(config)

# Run setup
await sdk.setup()

# Check status
status = await sdk.get_status()

Architecture

Orchestr8 sets up:

  • ArgoCD - GitOps continuous delivery
  • Istio - Service mesh for traffic management
  • Keycloak - Identity and access management
  • Prometheus/Grafana - Monitoring and observability
  • Cert-Manager - Automatic TLS certificate management

Migration from Orchestr8

If you're migrating from Orchestr8 Orchestrator (Orchestr8):

  1. Install Orchestr8: uv tool install orchestr8-platform
  2. Update scripts: Replace orchestr8 commands with o8
  3. Validate setup: Run o8 doctor to check your environment
  4. Update repositories: Change repo references from orchestr8 to orchestr8

Your existing configurations will be automatically detected and migration prompts provided.

Development

# Clone the repository
git clone https://github.com/killerapp/orchestr8
cd orchestr8/o8-cli

# Install dependencies
uv sync

# Run tests
uv run pytest

# Run CLI in development
uv run python -m orchestr8.cli

Publishing to PyPI

# Build the package
uv build

# Publish to PyPI
uv publish

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

orchestr8_platform-3.0.1.tar.gz (92.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orchestr8_platform-3.0.1-py3-none-any.whl (91.9 kB view details)

Uploaded Python 3

File details

Details for the file orchestr8_platform-3.0.1.tar.gz.

File metadata

  • Download URL: orchestr8_platform-3.0.1.tar.gz
  • Upload date:
  • Size: 92.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.8.13

File hashes

Hashes for orchestr8_platform-3.0.1.tar.gz
Algorithm Hash digest
SHA256 d0cbe83dd33a00f67f5f86383807aa0e72ced10c5c4fae1dd8559ef94eb5365d
MD5 6c75098b76269f1bbcba7ab07f4f46e4
BLAKE2b-256 089eb8a852e38c2352e74e74a0cb39b67ffdd27d5bd09b118dfe85aef08c1b76

See more details on using hashes here.

File details

Details for the file orchestr8_platform-3.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for orchestr8_platform-3.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 64a1819e05974396a39a397b946f809af9d48b482a00f60de69a53088cdcd745
MD5 9961d5beda0fa5dbfd07f073caa08583
BLAKE2b-256 7096f810d8da6e64ec1e8ff8efbd3322b690ed3e155d73c7ffa5639f5ad14eb2

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page