Skip to content

Latest commit

 

History

History
53 lines (35 loc) · 2.72 KB

File metadata and controls

53 lines (35 loc) · 2.72 KB

OpenFrame CLI Documentation

openframe is an interactive command-line tool for standing up and managing OpenFrame Kubernetes environments. It provisions local k3d clusters, deploys the OpenFrame platform via an ArgoCD app-of-apps GitOps workflow, and keeps itself up to date.

This repository (flamingo-stack/openframe-cli) is the CLI. The platform and application manifests it deploys live in flamingo-stack/openframe-oss-tenant.

Getting Started

Reference

  • Terminal Output — Live dashboards, sequential/CI mode, --plain/--silent/--verbose, color and glyph controls, GitHub Actions integration

Commands

  • openframe bootstrap — Create a cluster and install the platform in one step
  • openframe cluster {create,delete,list,status,cleanup} — Manage k3d and cloud (EKS/GKE) clusters
  • openframe app {install,upgrade,status,access,uninstall} — Manage the OpenFrame app-of-apps deployment (status also has --watch and --interactive live views)
  • openframe prerequisites {check,install} — Check and install required tools
  • openframe update (check, rollback, update <version>) — Self-update the CLI
  • openframe completion — Generate shell completion scripts

System Requirements

A full local platform is demanding. Recommended host:

Resource Recommended
RAM 24 GB
CPU 6 cores
Disk 50 GB free

Dependencies

Docker is the only tool you install and run yourself. The CLI auto-installs pinned, verified copies of kubectl, k3d, and helm into ~/.openframe/bin. mkcert is used to issue a locally-trusted certificate for the HTTPS ingress. See Prerequisites.

Community and Support

We don't monitor GitHub Issues for support — use Slack.

License

See LICENSE.md.