Skip to content

Latest commit

 

History

History
108 lines (81 loc) · 4.43 KB

Technical.md

File metadata and controls

108 lines (81 loc) · 4.43 KB

Devilbox Documentation

Overview | Quickstart | Install | Update | Configure | Run | Usage | OS | Backups | Examples | Technical | Hacking | FAQ


Technical

  1. Networking
  2. Ports and forwarding
    1. PHP Container
    2. Docker Host
  3. Works the same on Host and PHP Container

1. Networking

It is best to use the hostnames and not to rely on the ip addresses as they might change. In most cases however you can use 127.0.0.1 for all connections. Read up to find out why.

E.g.: When you want to setup a MySQL database connection use mysql or 127.0.0.1 as the hostname.

Container Container name Hostname IP Address
DNS bind bind 172.16.238.100
PHP / HHVM php php 172.16.238.10
Apache / Nginx http http 172.16.238.11
MySQL / MariaDB mysql mysql 172.16.238.12
PostgreSQL pgsql pgsql 172.16.238.13
Redis redis redis 172.16.238.14
Memcached memcd memcd 172.16.238.15
MongoDB mongo mongo 172.16.238.16

2. Ports and forwarding

2.1 PHP Container

The php container is the center of all container. Everything happens in there. This is also the reason it does some more magic than actually required.

Remote ports and remote sockets are made available to the php container.

The PHP container is using socat to

  1. forward the remote mysql port 3306 (on the mysql container) to its own 127.0.0.1:3306
  2. forward the remote pgsql port 5432 (on the pgsql container) to its own 127.0.0.1:5432
  3. forward the remote redis port 6379 (on the redis container) to its own 127.0.0.1:6379
  4. forward the remote memcached port 11211 (on the memcd container) to its own 127.0.0.1:11211
  5. forward the remote mongodb port 27017 (on the mongo container) to its own 127.0.0.1:27017

The following container can be reached from within the PHP container via the following methods:

Container Hostname IP Address IP Address Port
DNS bind 172.16.238.100 - 53
PHP / HHVM php 172.16.238.10 - 9000
Apache / Nginx http 172.16.238.11 - 80
MySQL / MariaDB mysql 172.16.238.12 127.0.0.1 3306
PostgreSQL pgsql 172.16.238.13 127.0.0.1 5432
Redis redis 172.16.238.14 127.0.0.1 6379
Memcached memcd 172.16.238.15 127.0.0.1 11211
MongoDB mongo 172.16.238.16 127.0.0.1 27017

2.2 Docker Host

The docker host (your computer) does exactly the same as the php container.

  1. container mysql port 3306 is exposed to the host on port 127.0.0.1:3306
  2. container pgsql port 5432 is exposed to the host on port 127.0.0.1:5432
  3. container redis port 6379 is exposed to the host on port 127.0.0.1:6379
  4. container memcd port 11211 is exposed to the host on port 127.0.0.1:11211
  5. container mongo port 27017 is exposed to the host on port 127.0.0.1:27017

The following container can be reached from the Docker host via the following methods:

Container IP Address Port
DNS 127.0.0.1 1053
PHP / HHVM - 9000
Apache / Nginx 127.0.0.1 80
MySQL / MariaDB 127.0.0.1 3306
PostgreSQL 127.0.0.1 5432
Redis 127.0.0.1 6379
Memcached 127.0.0.1 11211
MongoDB 127.0.0.1 27017

3. Works the same on Host and PHP Container

As you might have noticed, the ports and addresses will be exactly the same inside the PHP container and on the docker host (when using 127.0.0.1) for most container. That way it is possible to write your php application like this:

<?php
mysql_connect('127.0.0.1', 'user', 'pass');