https://github.com/oleks/docker-in5570v20
An Emerald installation for IN5570v20
https://github.com/oleks/docker-in5570v20
Last synced: about 2 months ago
JSON representation
An Emerald installation for IN5570v20
- Host: GitHub
- URL: https://github.com/oleks/docker-in5570v20
- Owner: oleks
- License: bsd-3-clause
- Created: 2020-01-16T08:08:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2020-06-04T10:41:17.000Z (almost 5 years ago)
- Last Synced: 2025-02-10T13:44:12.038Z (3 months ago)
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/portoleks/in5570v20
- Size: 671 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# An Emerald installation for IN5570v20
[](LICENSE.md)
The slightly long-winded way to use this Docker image is to go to the
directory where you have your Emerald code (and not much else!), and
run the following (Linux/macOS) command:
**NB!** Do not execute before reading the above and the below.
```
docker run \
--interactive --tty --rm \
--volume "$(pwd):/home/docker/src/" \
--workdir "/home/docker/src/" \
portoleks/in5570v20:latest
```
(Windows users; see below)
## Debunking the options
* `--interactive --tty` make your session interactive, instead of
spawning the container in the background (background instantiation
might be useful later to start many concurrent Emerald nodes)
* `--rm` will make your session ephemeral; that is, anything that
happens inside the container, outside otherwise mounted volumes
(see below), will disappear as soon as you exit
* `--volume` mounts the current working directory under
`/home/docker/src`
* `--workdir` makes sure that you spawn with `/home/docker/src` as
the working directory
So what happens when you execute this command?
You land in a `bash` from where you can run `emc`, `ec`, and `ex`.
You will see a prompt like:
```
[email protected] ~
$
```
Here, `1331eb6fa70` is the hostname, and `172.17.0.2` is the IP
address. These will be different for each container you start. This
should make it easier to work with multiple Docker+Emerald nodes. (The
username is always `docker`, and it is not shown in the prompt.)
To gracefully exit from the Docker image, type `exit` or press
`Ctrl`+`D`.
Please remember that when you exit, everything done outside the
virtual `/home/docker/src/` directory will be lost. At the same time,
whatever happens in `/home/docker/src/` will be reflected in the
directory from where you ran the above command.
## Windows Users
If you are using Windows 10 Home Edition (or similar), you might need
[Docker Toolbox](https://docs.docker.com/toolbox/overview/), otherwise
[Docker Desktop for
Windows](https://docs.docker.com/docker-for-windows/) should work for
you.
Windows users using PowerShell (rather than Git BASH), should execute
the following command instead:
```
docker run `
--interactive --tty --rm `
--volume "${PWD}:/home/docker/src/" `
--workdir "/home/docker/src/" `
portoleks/in5570v20:latest
```
## Tools for working with the Docker image
That command was quite a mouthful!
This is why we provide some tools for working with the Docker image.
You will find them here: https://github.com/emerald/in5570v20