genofire/hs_monolith
genofire
/
hs_monolith
Archived
1
0
Fork 0
This repository has been archived on 2020-09-27. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Matthias Stock 275128c389 Enhanced Getting Started Guide
Added port env variable, removed +x since file permissions are corrected
in the repo itself.
2017-03-26 21:56:49 +02:00
config/checkstyle Products From Database 2017-03-08 23:41:35 +01:00
gradle/wrapper Gradle Wrapper 2017-03-09 00:19:57 +01:00
src Locale Lookup 2017-03-11 22:52:09 +01:00
.gitignore Initial commit 2017-03-01 22:07:08 +01:00
.gitlab-ci.yml CI Config 2017-03-09 21:31:47 +00:00
LICENSE Add license 2017-03-08 23:17:25 +00:00
README.md Enhanced Getting Started Guide 2017-03-26 21:56:49 +02:00
build.gradle Products From Database 2017-03-08 23:41:35 +01:00
gradlew Fixed File Permissions 2017-03-26 21:46:33 +02:00
gradlew.bat Fixed File Permissions 2017-03-26 21:46:33 +02:00
start-db.sh Fixed File Permissions 2017-03-26 21:46:33 +02:00

README.md

Getting Started

1. Install Docker

There are several ways to install docker depending on your host operating system (OS). Only the Docker Community Edition (Docker CE) from the stable channel is required.

Windows 10 Proffesional or Enterprise Edition

If you have Windows 10 Proffesional or Enterprise then Docker will work "nativley" using the internal Hyper-V virtualization technology. Follow these installation instructions and check if all is working fine according to this little guide.

  • Docker tools should be readily available in any shell/terminal

Other Windows Edition

Docker does not run "natively" on other Windows versions and editions. However, Docker provides the Docker Toolbox to install the neccassry tooling and let Docker use the VirtualBox virtualization technology. Follow these installation instructions.

  • It will also install a bash like Docker Quickstart Terminal
  • The Toolbox version requires bash like terminals, hence one can also use the Git Bash but needs to setup the environment by running eval $("docker-machine.exe" env)

Mac

Here, the choice between newer more "native" installations or use of Docker Toolbox also depends on the version of Mac (Requires OSX Yosemite 10.10.3 or above). Then it will be depply integrated with the MacOS Hypervisor framework, networking and filesystem.

Otherwise also install Docker Toolbox following these instructions.

Linux/Unix

There should be no issue if the distribution uses a recent kernel.

2. Run Monolith

  1. Set up an environment variable LAB_MONOLITH_DB_HOST and assign the docker host's IP.

    For docker machine type docker-machine env and use the value of DOCKER_HOST, otherwise localhost is probably correct.

  2. Set up an environment variable LAB_MONOLITH_DB_PORT and assign any free port you want the PostgreSQL Database to use.

  3. Set up an environment variable LAB_MONOLITH_DB_PASSWORD and assign any password.

  4. ./start-db.sh

    Starts a PostgreSQL database using the password from LAB_MONOLITH_DB_PASSWORD.

  5. ./gradlew bootRun

  6. Open http://localhost:8080

  7. Happy exploring and di-secting