Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add scripts for running, updating, restarting, and stopping Docker im…
…age. Add docker/README.md to explain the use of the Docker image scripts. Update docs/RunningDockerImage.md with new repository location and updated notes on running.
- Loading branch information
1 parent
e28c49c
commit b38b693
Showing
6 changed files
with
74 additions
and
13 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,20 @@ | ||
## Docker for Iamus Metaverse Server | ||
|
||
The files here are for creating and running Iamus under Docker. | ||
|
||
The `Dockerfile` is used to build the image with the `files` directory | ||
holding the scripts that are copied into the image for its operation. | ||
See the build action in `.github/workflows/docker-publish.yml` to see | ||
the steps for building. | ||
|
||
The other script files here are for starting, running, restarting, and | ||
updating a running Iamus metaverse-server. | ||
The naming pretty obvious. | ||
|
||
To run Iamus with Docker, | ||
read the information in `docs/RunningDockerImage.md` | ||
for setup of the configuration files and MongoDB. | ||
Then, on the server that has Docker and MongoDB installed, | ||
clone the Iamus repository | ||
and, from the directory with the created `config` directory, | ||
execute `run-metaverse-server.sh` to start the server. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
echo "==== stopping metaverseserver" | ||
docker stop metaverseserver | ||
echo "==== removing old metaverseserver image" | ||
docker rm metaverseserver | ||
echo "==== starting metaverseserver" | ||
./run-metaverse-server.sh | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,16 @@ | ||
#! /bin/bash | ||
# Start the metaverseserver with persistant data in local dir | ||
|
||
BASE=$(pwd) | ||
cd "${BASE}" | ||
|
||
DVERSION=latest | ||
|
||
docker run -d \ | ||
--name=metaverseserver \ | ||
--restart=unless-stopped \ | ||
-p 9400:9400 \ | ||
-e IAMUS_CONFIG_FILE=/home/cadia/config/iamus.json \ | ||
--network="host" \ | ||
--volume ${BASE}/config:/home/cadia/config \ | ||
ghcr.io/vircadia/iamus:${DVERSION} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,7 @@ | ||
#! /bin/bash | ||
# Stops the metaverse server and cleans up | ||
|
||
echo "==== stopping metaverse-server" | ||
docker stop metaverseserver | ||
echo "==== removing old metaverse-server image" | ||
docker rm metaverseserver |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,9 @@ | ||
echo "==== fetching latest docker image for metaverseserver" | ||
docker pull ghcr.io/vircadia/iamus:latest | ||
echo "==== stopping metaverseserver" | ||
docker stop metaverseserver | ||
echo "==== removing old metaverseserver image" | ||
docker rm metaverseserver | ||
echo "==== starting metaverseserver" | ||
./run-metaverse-server.sh | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters