Skip to content

Commit 86a010c

Browse files
committed
Update docs for container changes
1 parent 937aa9b commit 86a010c

File tree

2 files changed

+46
-5
lines changed

2 files changed

+46
-5
lines changed

README.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,7 @@ Our original interactive analysis suite is currently hosted at: http://mlip-test
2121
## Contents
2222
- [Getting started](#getting-started)
2323
- [Features](#features)
24+
- [Docker Images](#docker-images)
2425
- [Development](#development)
2526
- [License](#license)
2627

@@ -45,11 +46,51 @@ To get all the latest changes, ML-PEG can be installed from GitHub:
4546
python3 -m pip install git+https://github.com/ddmms/ml-peg.git
4647
```
4748

49+
4850
## Features
4951

5052
Coming soon!
5153

5254

55+
## Docker images
56+
57+
A Docker image with the latest changes can be pulled from the GitHub container
58+
registry, following the command that can be found under this repository's
59+
[packages](https://github.com/ddmms/ml-peg/pkgs/container/ml-peg-app):
60+
61+
> [!NOTE]
62+
> Currently, this repository only contains images for the linux/amd64 platform.
63+
> On MacOS with ARM silicon, this can often still be run by setting
64+
> `--platform linux/amd64` when using `docker run`.
65+
66+
67+
Alternatively, to build the container yourself, you can use the
68+
[Dockerfile](containers/Dockerfile) provided. From the `ml-peg` directory, run:
69+
70+
```
71+
docker build -t ml-peg-app -f containers/Dockerfile .
72+
```
73+
74+
75+
Once built, you can mount your current application data and start the app by running:
76+
77+
```
78+
docker run --volume ./ml_peg/app/data:/app/ml_peg/app/data --publish 8050:8050 ml-peg-app
79+
```
80+
81+
> [!TIP]
82+
> Ensure `ml_peg/app/data` is populated with results before running the container.
83+
84+
85+
Alternatively, you can use the [compose.yml](containers/compose.yml) file provided, via
86+
Docker Compose:
87+
88+
```
89+
docker compose -f containers/compose.yml up -d
90+
```
91+
92+
The app should now be accessible at http://localhost:8050.
93+
5394
## Development
5495

5596
Please ensure you have consulted our

docs/source/user_guide/get_started.rst

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -41,18 +41,18 @@ following the command that can be found under this repository's
4141

4242
Alternatively, to build the container yourself, you can use the
4343
`Dockerfile <https://github.com/ddmms/ml-peg/blob/main/containers/Dockerfile>`_
44-
provided, and run:
44+
provided. From the ``ml-peg`` directory, run:
4545

4646
.. code-block:: bash
4747
48-
docker build . -t ml-peg-app
48+
docker build -t ml-peg-app -f containers/Dockerfile .
4949
5050
51-
Once built, you can mount your current directory and start the app by running:
51+
Once built, you can mount your current application data and start the app by running:
5252

5353
.. code-block:: bash
5454
55-
docker run --volume .:/app --publish 8050:8050 ml-peg-app
55+
docker run --volume ./ml_peg/app/data:/app/ml_peg/app/data --publish 8050:8050 ml-peg-app
5656
5757
.. tip::
5858

@@ -65,7 +65,7 @@ file provided, via Docker Compose:
6565

6666
.. code-block:: bash
6767
68-
docker compose up -d
68+
docker compose -f containers/compose.yml up -d
6969
7070
7171
The app should now be accessible at http://localhost:8050.

0 commit comments

Comments
 (0)