https://github.com/joseluisq/local-dev-env
Sample repository to reproduce a small local development environment with trusted certificates and Docker Stack. :white_check_mark:
https://github.com/joseluisq/local-dev-env
development-environment docker-stack mkcert tls-certificate traefik
Last synced: about 1 month ago
JSON representation
Sample repository to reproduce a small local development environment with trusted certificates and Docker Stack. :white_check_mark:
- Host: GitHub
- URL: https://github.com/joseluisq/local-dev-env
- Owner: joseluisq
- License: mit
- Created: 2019-03-11T13:57:57.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2019-03-29T07:40:56.000Z (about 6 years ago)
- Last Synced: 2024-04-14T04:23:31.191Z (about 1 year ago)
- Topics: development-environment, docker-stack, mkcert, tls-certificate, traefik
- Language: Makefile
- Homepage:
- Size: 3.91 KB
- Stars: 0
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Local Development Environment
> Sample repository to reproduce a small local development environment with [trusted development certificates](https://github.com/FiloSottile/mkcert) and [Docker Stack](https://docs.docker.com/engine/reference/commandline/stack/).
Feedback welcome!
## Features
- [https://dev.local](https://dev.local/) domain thanks to [mkcert](https://github.com/FiloSottile/mkcert).
- [Docker stack](https://docs.docker.com/engine/reference/commandline/stack/) examples.
## Usage
### Certificates
1. To generate the certificates, install [mkcert](https://github.com/FiloSottile/mkcert) first and then run:
```sh
make certs
```
2. Add `dev.local` to your `/etc/hosts` file.
```sh
# other entries...
127.0.0.1 dev.local
# you can add your custom hostnames as well...
127.0.0.1 name-a.dev.local
127.0.0.1 name-b.dev.local
127.0.0.1 name-n.dev.local
```
## Docker stack
This sample contains [Treafik Proxy](https://github.com/containous/traefik) that you can use as proxy across your docker containers.
If some custom configuration is needed take a look into [docker-stack](./docker-stack) directory.
### Create a proxy network
```sh
make network
```
A `proxy_net` network will be created with `--attachable` option, so you will be able to attach your container apps to Traefik later.
### Traefik proxy
```sh
make proxy
```
Now, navigate to [https://dev.local](https://dev.local/) :tada:
## Contributions
Feel free to send some [Pull request](https://github.com/joseluisq/local-dev-env/pulls) or [issue](https://github.com/joseluisq/local-dev-env/issues).
## License
MIT license
© 2019 [Jose Quintana](https://git.io/joseluisq)