Docker Project Services

This Repository is used together with SOA based projects, consisting of microservices, built on laravel-starter-tpl.

→ Purpose

The purpose of this repository is to contain Docker services that can be shared across all microservices in one domain.

🚩 Requirements

• macOS Monterey or Linux
• Docker 20.10 or newer
  • How To Install and Use Docker on Ubuntu 22.04
• Cloned, configured and running docker-shared-services, to support system-wide DNS, Routing and SSL support via Traefik.

💻 Usage

Warning: Repository with docker-shared-services should be configured, up and running before

→ Instructions

1. Clone repository:

   $ git clone git@github.com:wayofdev/docker-project-services.git

2. Generate default .env file:

   # With custom namespace provided, it will be used to prefix all services
   # in Docker network for current project
   $ make env COMPOSE_PROJECT_NAME=bfq
   
   # Default project namespace will be used - **wod**
   $ make env

   Edit the created .env file if necessary. You may want to change the default domain.

3. (Optional) Enable the docker-compose.override.yaml file to run extra services, like pg-admin and others:

   $ make override

4. Run this repository:

   $ make up

5. Check that everything works:

   $ make ps
   $ make logs

🧪 Testing

You can check Makefile to get full list of commands for local testing. For testing, you can use these commands to test whole role or separate tasks:

Testing docker-compose using dcgoss:

$ make test

🤝 License

🙆🏼‍♂️ Author Information

This repository was created in 2022 by lotyp / wayofdev.

🫡 Contributors