README.md 1.06 KB
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
# About

This is a project to create the "Master" Docker-in-Docker container that will be used in some other SIS projects.

Docker-in-Docker is a mechanism that allows an installation of Docker _inside_ a container to control the _host_ installation of Docker; spawning other containers, etc.

This means that we no longer have to worry about developer machines having anything more than Docker and Bash installed -- top-level watch/test scripts, Docker Compose, `chronic`, etc., can all now be bundled as part of this project and not be a requirement of the developer before work can begin on the parent project.

# Example Usage

```bash
PROJECT_NAME=ExampleProject
MASTER_IMAGE=code.ornl.gov:4567/sis/dockermaster:{TAG}

# Basic example that runs a simple Docker command on the host.
docker run \
    --privileged \
    --name $PROJECT_NAME \
    -v /var/run/docker.sock:/var/run/docker.sock \
    --rm $MASTER_IMAGE \
    docker ps;
```

# Deployment

Run the following after making your changes.  (ORNL GitLab credentials and project permissions required.)

```
./build_and_deploy
```