cloud

The rumi cloud commands provision and manage Rumi private clouds - Rumi's standardized deployment model.

What is a Rumi Private Cloud?

A Rumi private cloud is a standardized deployment architecture consisting of:

Platform Services

• Admin - Administrative interface and deployment management

• Agent - Monitoring and management agent

• Monitor - Observability dashboards and metrics

• Messaging Broker - Solace, Kafka, or ActiveMQ

• Jump Server - Secure access gateway (non-local environments)

• Name Server - DNS services (environments without managed DNS like Route 53)

Application Services

• User Microservices - Your deployed Rumi applications

Key Concept

The private cloud structure is identical across all environments - whether running locally in Docker, on bare metal, AWS, Civo, GCP, Azure, or any other infrastructure. This uniformity provides:

• Consistent deployment model - Same architecture everywhere

• Environment portability - Move applications between environments seamlessly

• Simplified operations - Same tooling and procedures across all deployment targets

• Predictable behavior - Applications behave identically regardless of underlying infrastructure

Deployment Environments

Environment	Description	Documentation
local	Docker-based on your local machine	Local Commands
aws	Amazon Web Services	AWS Commands
civo	Civo Cloud	⚠️ In Development
equinix	Equinix Metal bare-metal servers	Coming soon
bare metal	Your own physical infrastructure	Coming soon

The rumi cloud commands abstract away environment-specific details, allowing you to work with the same standardized private cloud model regardless of where it's deployed.

Command Structure

rumi cloud <environment> <command> [options]

Where:

• <environment> is where to deploy (local, aws, civo, equinix)

• <command> is the operation to perform

• [options] are command-specific parameters

Private Cloud Architecture Benefits

The standardized private cloud model provides:

1. Consistent Operations - Same commands and procedures across all environments

2. Easy Migration - Move applications between environments without changes

3. Unified Tooling - Single CLI for all deployment targets

4. Predictable Scaling - Add capacity using the same patterns everywhere

5. Simplified Training - Learn once, deploy anywhere

Typical Workflow

# 1. Develop locally
rumi cloud local provision --message-broker activemq
rumi cloud local deploy --xar my-app.xar

# 2. Test in cloud
rumi cloud aws provision --name dev-cloud --region us-east-1
rumi cloud aws deploy --name dev-cloud --xar my-app.xar

# 3. Deploy to production (same commands, different environment)
rumi cloud aws provision --name prod-cloud --region us-west-2
rumi cloud aws deploy --name prod-cloud --xar my-app.xar

Getting Help

Use --help (or -h) on any cloud command:

# General cloud help
rumi cloud --help

# Environment-specific help
rumi cloud local --help
rumi cloud aws --help

# Command-specific help
rumi cloud local provision --help
rumi cloud aws create-network --help

Related Documentation

• Installation - Install the Rumi CLI

• Quickstart - Generate quickstart applications