Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/matthewpattell/docker-server

Universal docker server (PHP-FPM/NODE, Nginx, MySql, Redis). Launch your site in 5 steps and <5 min :)
https://github.com/matthewpattell/docker-server

autoconf docker docker-compose express hostsfile mysql node nodejs php-fpm proxy redis templates universal web

Last synced: about 2 months ago
JSON representation

Universal docker server (PHP-FPM/NODE, Nginx, MySql, Redis). Launch your site in 5 steps and <5 min :)

Awesome Lists containing this project

README

        

Universal docker server
===========================
Nginx (1.17.8), PHP (7.4) / Node (13.10), MySql (5.7), Redis (5.0.7)

Installation
------------

The preferred way to install this extension.

Either run

- for **composer**
```bash
php composer.phar require --prefer-dist matthew-p/docker-server
```

or add

```
"matthew-p/docker-server": "^5.1.0"
```

to the require section of your `composer.json` file.
- for **npm**
```bash
npm i --save @matthew-p/docker-server@latest
```
or add

```
"@matthew-p/docker-server": "^1.1.1"
```
to the dependencies section of your `package.json` file.

## After install package:

1. Add or update section **scripts** in **composer.json** or **package.json**:

- for **composer.json**
```json5
{
"scripts": {
"server": "vendor/bin/site-start.sh --env-file=docker/.env.local",
"server-run": "vendor/bin/site-run.sh --env-file=docker/.env.local",
"server-exec": "vendor/bin/site-exec.sh --env-file=docker/.env.local",

// (optional)
"server-prod": "vendor/bin/site-aws.sh --env-file=docker/.env.prod",
// (optional)
"server-deploy-dev": "vendor/bin/site-deploy.sh --env-file=docker/.env.dev"
}
}
```
- for **package.json**
```json5
{
"scripts": {
"server": "docker-server-start --env-file=docker/.env.local",
"server-run": "docker-server-run --env-file=docker/.env.local",
"server-exec": "docker-server-exec --env-file=docker/.env.local",

// (optional)
"server-prod": "docker-server-aws --env-file=docker/.env.prod",
// (optional)
"server-deploy-dev": "docker-server-deploy --env-file=docker/.env.dev"
}
}
```

where **"docker/.env.local"** relative path to your local env config _(will be created in next step)_.

1. Run: ```composer server init``` or ```npm run server init```. This will create a **docker** folder in your project root directory.

1. Change **root-path** in _docker/nginx/conf-dynamic.d/sample.conf_

1. See [supported os](#supported-os) and config **docker/.env.local** according to your operating system

1. Run server: ```composer server up ``` or ```npm run server up```

## Supported OS
- [Linux](docs/LINUX.md)
- [Mac OS](docs/MACOS.md)

## Environments && Commands
- [See all available environments](docs/ENVIRONMENTS.md)
- [See console commands](docs/COMMANDS.md)

## PhpStorm samples
- [Deploy config](phpstorm/SAMPLE_DEPLOY_CONFIG.xml)

## Latest docker images
- NGINX
- matthewpatell/universal-docker-nginx:3.7
- SERVER
- matthewpatell/universal-docker-server:4.0
- matthewpatell/universal-docker-server:4.0-dev
- matthewpatell/universal-docker-server:4.0-jre (with java)
- PHP-FPM:
- matthewpatell/universal-docker-server-php-fpm:4.0
- NODE:
- node:13.10-alpine

**FEATURES**
---
- Multiple config: ```vendor/bin/site-start.sh --env-file=docker/.env.dev,docker/.env.local```
- Use environment, extends, overriding between configs
```dotenv
# Simple usage
SERVICES="$SERVICES -f my.yml"

# Will be recompiled (bad example)
SERVICES="${SERVICES} -f my.yml"

# Will be recompiled (good example)
SERVICES="${SERVICES_EXTERNAL} -f my.yml"
```
- Use all environments in docker-compose files
- Overriding, extends docker-compose files
- Run container and execute command: ```composer server-run server "ls && top"```
- Run command in working container: ```composer server-exec server "composer install"```
- AWS create/update "Task Definitions"
- Auto update _/etc/hosts_ file on host machine
- Auto create nginx proxies on host machine
- Deploy
- And etc.

## LIFEHACKS
- Configure hosts file:
1. Check nginx container _IP_ and add to hosts file:

```bash
docker inspect sample_nginx
```

view **"IPAddress"** and add to:

```bash
sudo nano /etc/hosts
```

_172.18.0.4 sample.io_ (for example)
save and check it.
2. Open browser and check **sample.io**

OR see below **static network layer**

- **Add static network layer** _(only for Linux)_
1. Change **SERVICES** variable in your local env (docker/.env.local) to:
```dotenv
SERVICES="$SERVICES -f docker/docker-compose.common.yml -f docker/docker-compose.static-network.yml"
```
2. Run: ```composer server restart``` and check it.
- **Update package without composer install and depencies**

- with composer image:

```bash
docker run --rm --interactive --volume $PWD:/app composer update --ignore-platform-reqs --no-scripts
```

- with server images:

```bash
docker run --rm --interactive --volume $PWD:/app matthewpatell/universal-docker-server:4.0 bash -c 'cd /app && composer install --no-scripts'
```

- with server image and additional global packages:

```bash
docker run --rm --interactive --volume $PWD:/app matthewpatell/universal-docker-server:4.0 bash -c 'cd /app && composer global require "fxp/composer-asset-plugin:^1.4.2" && composer global require "hirak/prestissimo:~0.3.7" && composer install --no-scripts'
```

- Use git-container instead of git itself

```bash

docker run -it --rm \
--user $(id -u):$(id -g) \
-v $HOME:$HOME:rw \
-v /etc/passwd:/etc/passwd:ro \
-v /etc/group:/etc/group:ro \
-v $PWD:$PWD:rw \
-w $PWD \
alpine/git \
clone [command]

# Or add alias in ~/.profile (change `git` to any another keyword if git actually installed)
cat >> ~/.profile << EOF
function git () {
(docker run -it --rm --user \$(id -u):\$(id -g) -v \$HOME:\$HOME:rw -v /etc/passwd:/etc/passwd:ro -v /etc/group:/etc/group:ro -v \$PWD:\$PWD:rw -w \$PWD alpine/git "\$@")
}
EOF
source ~/.profile
# and use via alias
git clone [email protected]:foob/bar.git .
git pull
```

That's all. Check it. :)