Machine Formations¶
Single machine deployments from cloud images or Docker containers.
Overview¶
Machine formations are the simplest formation type -- they launch a single cloud instance. There are two variants:
| Type | Description |
|---|---|
| Cloud Formation | Launch instances from any cloud image (AWS AMI, Azure VM Image, GCP Image, etc.) |
| Docker Formation | Launch RosettaHub managed images with pre-configured Docker containers and ready-to-use applications |
Both variants are available in On-Demand and Spot modes.
Cloud Formations¶
Cloud formations launch instances from standard cloud provider images. You have full control over the OS and software stack.
Configuration:
- Machine Image -- any cloud image (public, private, or shared)
- Cloud Key -- credentials for the target cloud account and region
- Instance Type -- CPU, memory, and GPU specifications
- Root Disk Size -- storage for the operating system
- SSL Certificate -- optional HTTPS certificate
- Startup Scripts -- commands executed at launch time
Connection methods: SSH (Linux), RDP (Windows), PuTTY.
Docker Formations¶
Docker formations launch RosettaHub managed images with pre-configured containers. These provide browser-based access to ready-to-use applications without SSH or RDP.
Pre-configured applications:
- Jupyter Notebook / JupyterLab
- RStudio
- Data Science Workbench
- Zeppelin
- Custom Docker containers
Configuration (in addition to Cloud Formation settings):
- Container Image -- Docker/OCI image to run
- Container Volumes -- storage mounts for the container
- Container Environment -- environment variables
- Applications -- software activated at launch time
Connection methods: browser-based access to the application UI.
Creating a Machine Formation¶
From Scratch¶
- Click Create Formation in the Formations panel
- Select Machine or Docker as the formation type
- Configure image, cloud key, instance type, and region
- For Docker formations, configure container settings
- Save the formation
By Cloning¶
- Find an existing formation in the Formations panel or Marketplace
- Right-click and select Clone
- RosettaHub creates a copy with your default keys and certificates
- Customize as needed
Related Topics¶
- Formations Overview -- All formation types and lifecycle
- Sessions -- Connect to launched instances
- Images -- Machine images for cloud formations
- Container Images -- Docker images for Docker formations