Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Taken from oms-docker github:

...

To stop everything, run `docker-compose down` in the folder. You can start everything again with `docker-compose up -d` Other than that, you should have a working dev-environment by now. If something breaks during development, you can try rebuilding everything with `docker-compose build`. Maybe also calling the bootstrap scripts again could help, but in theory they should only be needed upon creation.

With `docker ps` you can see which containers are currently running. If you want to "log into" the omscore, you can run `docker-compose exec omscore bash`. For omsevents run `docker-compose exec omsevents bash`

# Credits
This repo was loosely based upon laradock, the docker-alternative to the native homestead.This page provides overall tips for using of the OMS system, with the aim of reducing frustration and increasing productivity!

Docker

Useful commands:

  • `docker-compose up -d`
    • Start the system in detached mode - no endless log in the terminal.
  • `docker-compose down -v`
    • (Gracefully) stop the system, `-v` specifies that the volumes (data) of the containers should be removed as well
  • `docker ps -a`
    • Show (`-a` for all) running containers
  • `docker-compose logsĀ [service-name]`
    • Show the logs of a specific container, leave empty for all logs
  • `docker-compose run [service-name] bash`
    • 'Enter' the container using bash.

You can also use `docker help`, `docker-compose help` to get more help and see the other commands.

Info
titledocker vs docker-compose

`docker` works system wide, `docker-compose` works from a folder with a `docker-compose.yml` file (for oms-docker this is `oms-docker/docker`)


Helper scripts

oms-docker/docker/oms_setup.sh

A bash script that has the goal of providing quick and easy ways to build, tag and push containers (a single container, just the stable ones or all of them!)

Additionally it has a reset command to reset all the docker containers on your system (note that this also removes docker containers unrelated to OMS):

Code Block
languagebash
titleReset the docker containers, useful for a clean install!
bash oms_setup.sh --reset

oms-docker/deploy.sh

This script is designed to aid deployment on a public (production) server, having the ability to quickly install the newest version while retaining environment variables. Simply move the file one level above the oms-docker installation and call it using `bash deploy.sh`