development.md

Development Guide

Overview

Workspaces' services run on Docker containers. These containers can be all started at once using Docker Compose.

Setup

Build the base image:

make docker-base

In the Makefile, this Docker command is run:

docker build -t ssa-containers.aoc.nrao.edu/ops/base:workspaces -f Dockerfile.base .

This builds a local Docker image tagged as ssa-containers.aoc.nrao.edu/ops/base:workspaces on your machine using the Dockerfile.base Dockerfile.

Once the image has been built, Docker will save this image on your machine. You do not need to run the make docker-base command again unless you delete this image or modify the Dockerfile.base Dockerfile.

Starting Workspaces

To start Workspaces as foreground process, run:

docker-compose up

To start Workspaces as background process, run:

docker-compose up -d

Stopping Workspaces

To stop Workspaces, run:

docker-compose down

Starting Individual Services

To start Workspaces as foreground process, run: