An open API service indexing awesome lists of open source software.

https://github.com/wayofdev/docker-project-services

Contains docker-compose files, and configuration for services, used per project
https://github.com/wayofdev/docker-project-services

Last synced: 10 months ago
JSON representation

Contains docker-compose files, and configuration for services, used per project

Awesome Lists containing this project

README

          



Logo for light mode
Logo for dark mode





Build Status
Latest Version
Software License
Commits since latest release


# Docker Project Services

This Repository is used together with SOA based projects, consisting of microservices, built on [laravel-starter-tpl](https://github.com/wayofdev/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](https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-22-04)
* **Cloned, configured and running** [docker-shared-services](https://github.com/wayofdev/docker-shared-services), to support system-wide DNS, Routing and SSL support via Traefik.


## ๐Ÿ’ป Usage

> **Warning**: Repository with [docker-shared-services](https://github.com/wayofdev/docker-shared-services) should be configured, up and running before

### โ†’ Instructions

1. Clone repository:

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

2. Generate default .env file:

```bash
# 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:
```bash
$ make override
```

4. Run this repository:

```bash
$ make up
```

5. Check that everything works:

```bash
$ 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:

```bash
$ make test
```


## ๐Ÿค License

[![Licence](https://img.shields.io/github/license/wayofdev/docker-project-services?style=for-the-badge&color=blue)](./LICENSE)


## ๐Ÿ™†๐Ÿผโ€โ™‚๏ธ Author Information

This repository was created in **2022** by [lotyp / wayofdev](https://github.com/wayofdev).


## ๐Ÿซก Contributors

Contributors


Contributors