aws

The rumi cloud aws commands provision and manage Rumi private clouds in Amazon Web Services (AWS).

Overview

AWS commands provide complete lifecycle management for Rumi private clouds:

• Network Infrastructure - Create and manage VPCs, subnets, and security groups

• DNS Management - Set up hosted zones for private cloud domains

• Platform Services - Deploy Jump, Admin, Monitor, and messaging services

• Application Deployment - Deploy and manage your Rumi applications

• Lifecycle Management - Provision, start, stop, and deprovision entire clouds

Prerequisites

Before using AWS commands, you must:

1. Install the AWS CLI - Version 2.x required

2. Configure AWS credentials - See AWS Setup for detailed instructions

3. Have appropriate IAM permissions - EC2 and Route53 access required

Commands

Network Management

Command	Description
create-network	Create a new Rumi network (VPC)
list-networks	List all Rumi networks
delete-network	Delete a Rumi network

DNS Management

Command	Description
create-zone	Create a hosted zone
list-zones	List hosted zones

Jump Server

Command	Description
launch-jump	Provision and start Jump server
start-jump	Start Jump server
stop-jump	Stop Jump server
terminate-jump	Remove Jump server

Admin Service

Command	Description
launch-admin	Provision and start Admin service
start-admin	Start Admin service
stop-admin	Stop Admin service
terminate-admin	Remove Admin service
run-admin-script	Execute an admin script

Monitor Service

Command	Description
launch-monitor	Provision and start Monitor service
start-monitor	Start Monitor service
stop-monitor	Stop Monitor service
terminate-monitor	Remove Monitor service

Message Brokers

Command	Description
launch-solace	Provision and start Solace
start-solace	Start Solace
stop-solace	Stop Solace
terminate-solace	Remove Solace
launch-kafka	Provision and start Kafka
start-kafka	Start Kafka
stop-kafka	Stop Kafka
terminate-kafka	Remove Kafka

Platform

Command	Description
launch-platform	Provision and start platform
start-platform	Start platform
stop-platform	Stop platform
terminate-platform	Remove platform

Instance Management

Command	Description
launch-instance	Launch an EC2 instance
start-instance	Start an instance
stop-instance	Stop an instance
terminate-instance	Terminate an instance
list-instances	List all instances
attach-volume	Attach an EBS volume
run-command	Execute a command on an instance

High-Level Lifecycle

Command	Description
provision	Provision a complete private cloud
deploy	Deploy an application
configure	Configure an application
start	Start all services
stop	Stop all services
deprovision	Remove a private cloud

Common Options

Most AWS commands support these common options:

Option	Description
-p, --profile	AWS profile to use (required)
-r, --region	AWS region (default: us-east-1)
-n, --name	Name of the resource or private cloud

Typical Workflow

# 1. Provision a complete private cloud
rumi cloud aws provision \
  --profile my-aws-profile \
  --name my-cloud \
  --network my-network \
  --message-broker solace

# 2. Deploy your application
rumi cloud aws deploy \
  --profile my-aws-profile \
  --name my-cloud \
  --xar my-app.xar

# 3. Start all services
rumi cloud aws start --profile my-aws-profile --name my-cloud

# 4. Stop when not in use (saves costs)
rumi cloud aws stop --profile my-aws-profile --name my-cloud

# 5. Clean up when done
rumi cloud aws deprovision --profile my-aws-profile --name my-cloud

Related Documentation

• AWS Setup - Configure AWS CLI and credentials

• Local Commands - Docker-based local deployments

• Installation - Install the Rumi CLI