Introduction

In this guide we’ll configure a Cosmos cloud env to run docker compose commands, start a test instance of a given app and preview it via Cosmos tunnels.

Configuration

Create a new env with support for Docker: cosmos.augmentcode.com > Settings > Environments > Create an environment > Augment Cloud:

Name - ex: env01 (VM)
Base image - keep the default image
Repositories - you can leave unselected for now and come back to it after completing this guide
Runtime - make sure to select Virtual Machine (=VM)
Refresh - toggle on Scheduled refresh
Click on Create environment

Once your cloud env is created: cosmos.augmentcode.com > New session > Select Cosmos Advisor > Select the env you created above > Submit this prompt:

In the attached env, Install Docker + Docker Compose during the environment rebuild:
#!/usr/bin/env bash
set -euo pipefail

apt-get update
DEBIAN_FRONTEND=noninteractive apt-get install -y ca-certificates curl

Add Docker's official GPG key:
install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

Add the repository to Apt sources:
. /etc/os-release
printf 'deb [arch=%s signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian %s stable\n' "((dpkg --print-architecture)" ")VERSION_CODENAME" > /etc/apt/sources.list.d/docker.list
apt-get update

Install Docker Engine AND Compose from Docker's official servers
DEBIAN_FRONTEND=noninteractive apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

docker compose version
find /var/lib/apt/lists -mindepth 1 -delete

==========
Then start docker on every VM boot:

#!/usr/bin/env bash
set -euo pipefail
rm -f /var/run/docker.pid
nohup dockerd >/tmp/dockerd.log 2>&1 &
for _in {1..30};do
docker info >/dev/null 2>&1 &&exit 0
sleep 1
done
cat /tmp/dockerd.log >&2;exit 1

Note: in the thought process of the session, Cosmos Advisor created the corresponding provision and startup .sh scripts and applied them to the env:

The session should give you a confirmation when the env is updated:

Run a test session

Test a docker compose command with a simple repo: cosmos.augmentcode.com > New session > Select the env you create above > Submit this prompt:

deploy this app https://github.com/augment-solutions/docker-based-app

The session will run docker compose and offer to expose the app via a Augment authenticated url - select that option. Note on the right drawer the tunnel has been created (forwarding port 8080):

If you click on “temporary preview is live” or the tunnel link in the right drawer, you’ll see the app preview:

Congrats, your cloud env can now run docker compose! 🎉 You can run this cloud env to spin up a new test instance of your app, which is very helpful to run end2end tests as part of the code producing loop (yellow)

Getting Started

Cosmos

Auggie CLI

Other clients

Admin

Models & Pricing

Troubleshooting

Docker Compose in cloud envs

Introduction

Configuration

Run a test session

​Introduction

​Configuration

​Run a test session

Introduction

Configuration

Run a test session