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):
- Install Orchestr8:
uv tool install orchestr8-platform - Update scripts: Replace
orchestr8commands witho8 - Validate setup: Run
o8 doctorto check your environment - Update repositories: Change repo references from
orchestr8toorchestr8
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d0cbe83dd33a00f67f5f86383807aa0e72ced10c5c4fae1dd8559ef94eb5365d
|
|
| MD5 |
6c75098b76269f1bbcba7ab07f4f46e4
|
|
| BLAKE2b-256 |
089eb8a852e38c2352e74e74a0cb39b67ffdd27d5bd09b118dfe85aef08c1b76
|
File details
Details for the file orchestr8_platform-3.0.1-py3-none-any.whl.
File metadata
- Download URL: orchestr8_platform-3.0.1-py3-none-any.whl
- Upload date:
- Size: 91.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.8.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
64a1819e05974396a39a397b946f809af9d48b482a00f60de69a53088cdcd745
|
|
| MD5 |
9961d5beda0fa5dbfd07f073caa08583
|
|
| BLAKE2b-256 |
7096f810d8da6e64ec1e8ff8efbd3322b690ed3e155d73c7ffa5639f5ad14eb2
|