npm package: @matthew-p/docker-server
Description: Universal docker server, Nginx, Node, MySql, Redis
Author: Yarmaliuk Mikhail
Latest version: 1.5.6

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 git@githab.com:foob/bar.git .
git pull
```

That's all. Check it. :)