Newer
Older
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
# 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:
```sh
make docker-base
```
In the Makefile, this Docker command is run:
```sh
docker build -t marconi.aoc.nrao.edu/ops/base:workspaces -f Condaless.dockerfile.v2 .
```
This builds a local Docker image tagged as `marconi.aoc.nrao.edu/ops/base:workspaces` on your machine
using the `Condaless.dockerfile.v2` 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 `Condaless.dockerfile.v2` Dockerfile.
### Starting Workspaces
To start Workspaces as foreground process, run:
```sh
docker-compose -f docker-compose.local.yml up
```
To start Workspaces as background process, run:
```sh
docker-compose -f docker-compose.local.yml up -d
```
### Stopping Workspaces
To stop Workspaces, run:
```sh
docker-compose -f docker-compose.local.yml down
```
### Starting Individual Services
To start Workspaces as foreground process, run:
```sh
docker-compose -f docker-compose.local.yml up <service_name>
```
### List Containers
To get a list of running containers:
```sh
docker container ls
```
Or:
```sh
docker ps
```
### Show Container Logs
To output logs of a specific container:
```sh
docker logs <container_name>
```
To continuously tail logs of a specific container:
```sh
docker logs -f <container_name>
```
### Open a Shell on a Running Container
Using Docker:
```sh
docker exec -it <container_name> bash
```
Using Docker Compose:
```sh
docker-compose exec <service_name> bash
```
### Run a command on a Running Container
Using Docker:
```sh
docker exec <container_name> pwd
```
Using Docker Compose:
```sh
docker-compose exec <service_name> pwd
```