Convert Your Dev Environment to a Docker Stack - PHP Tek 2025.pdf

Converting Your Dev Environment
to a Docker Stack
Dana Luther
https://joind.in/talk/7bbd7
https://github.com/DanaLuther/DevDockerStackSample/tree/phptek
@danaluther@phpc.social

Consolidated Work Stack
PHP 8.4 FPM
NGINX
MySQL

Friend A
PHP 8.0
Apache
MySQL
PHP 8.4 FPM
NGINX
MySQL

Friend A
PHP 8.0
Apache
MySQL
Cause B
PHP 8.1 FPM
NGINX
MySQL
PHP 8.4 FPM
NGINX
MySQL

Licensed
Application
PHP 5.6
Apache
MySQL 5.7
Client A

Licensed
Application
PHP 5.6
Apache
MySQL 5.7
Client A
Client B
PHP 8.4
Apache
MySQL 8.4

Licensed
Application
Client C
PHP 8.1 FPM
NGINX
MySQL 8.4
PHP 5.6
Apache
MySQL 5.7
Client A
Client B
PHP 8.4
Apache
MySQL 8.4

Licensed
Application
Client D
PHP 7.1 FPM
NGINX
MySQL 8.0
Client C
PHP 8.1 FPM
NGINX
MySQL 8.4
PHP 5.6
Apache
MySQL 5.7
Client A
Client B
PHP 8.4
Apache
MySQL 8.4

So, how does that work???
🤔
?
? ?
?

docker-compose.yml
Docker Compose Version
Services in the Stack
Con
fi
gurations,
Secrets,
Storage Volumes,
etc.
Version: “3.7”
services:
nginx:
image: nginx
command: [
'sh',
'
-
c',
"exec nginx
-
g 'daemon off;'"
]
…
php:
image: php:8.4-fpm
…
network:
web_frontend
conf
i
g:
nginx.conf:
f
i
le: ./nginx/nginx.conf
volumes:
https://docs.docker.com/compose/compose-
fi
le/

SIDEB
AR:The Docker Hierarchy
Image Container Service Stack

SIDEB
AR:The Docker Hierarchy
Image Container Service Stack
Node Swarm

> docker stack deploy …
Swarm
NODE 1
NODE 2
ETC.
PHP 1 MySQL
NGINX PHP 2

SIDEB
AR:Docker Command Syntax
docker (object) (action) (args)

SIDEB
> docker container ls

SIDEB
> docker image ls

SIDEB
> docker image ls
> docker service ls

SIDEB
> docker image ls
> docker service ls
> docker volume ls

SIDEB
> docker image ls
> docker service ls
> docker volume ls
image
container
stack
service
con
fi
g
network
node
plugin
swarm
Objects

SIDEB
> docker image ls
> docker service ls
> docker volume ls
image
container
stack
service
con
fi
g
network
node
plugin
swarm
Objects
ls
ps
prune
inspect
create
remove / rm
Common
Actions

The swarm …
Node
Manager
Node
Worker
Node
Worker
Node
Worker

Node
Manager
A SWARM OF ONE
> docker swarm init

⚠ Common “Gotcha”
Swarm init — ONE TIME ONLY
* THE SWARM PERSISTS *

> docker swarm leave

> docker swarm leave
> docker swarm leave —force

POP
QUIZ! A. What’s the di
ff
erence
between a container and a
service?

POP
QUIZ! A. What’s the di
ff
erence
between a container and a
service?
B. What’s the di
ff
erence
between a service and a
stack?

Commonly Useful Images:
mysql
php
nginx
httpd
node
redis
wordpress
composer
memcached
alpine
postgres
busybox
https://hub.docker.com

mysql
php
nginx
httpd
node
redis
wordpress
composer
memcached
alpine
postgres
busybox
phpmyadmin/phpmyadmin

mysql
php
nginx
httpd
node
redis
wordpress
composer
memcached
alpine
postgres
busybox
BONUS POP QUIZ!

mysql
php
nginx
httpd
node
redis
wordpress
composer
memcached
alpine
postgres
busybox
BONUS POP QUIZ!
How do you pull an image manually?

mysql
php
nginx
httpd
node
redis
wordpress
composer
memcached
alpine
postgres
busybox
> docker image pull mysql:latest
BONUS POP QUIZ!
How do you pull an image manually?

Images for Automated Testing
selenium/standalone-chrome-debug
selenium/standalone-
fi
refox-debug:2.53.0
acceptance.suite.yml
docker-compose.yml

SIDEB
AR:Legacy images, containers, volumes
> docker image prune
> docker container prune
> docker (whatever) prune

SIDEB
AR:Legacy images, containers, volumes
> docker image prune
> docker container prune
> docker (whatever) prune
> docker system prune

version: “3.7”
services:
nginx:
image: nginx
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
com.envisageinternational.desc: “Nginx Service”
volumes:
- ./public_html:/var/
w
w
w
/html
conf
i
gs:
- source: mysite
target: /etc/nginx/conf.d/mysite.conf
ports:
- “80
:
80”
- “443
:
443”
depends_on:
- php
- db
labels:
com.envisageinternational.desc: “Nginx Container”
command: [‘sh’,'
-
c',"exec nginx
-
g 'daemon off;’”]
db:
image: mysql
ports:
- “3306
:
3306”
networks:
- web
secrets:
- db_pwd
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
placement:
constraints: [ node.role
=
=
manager ]
php:
image: php:8.4-fpm
networks:
- web
depends_on:
- db
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
com.envisageinternational.desc: “PHP-FPM Service”
ports:
- “9000
:
9000”
volumes:
w
w
w
/html
labels:
com.envisageinternational.desc: “PHP-FPM Container”
php
-
cli:
image: php:8.4-cli
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
com.envisageinternational.desc: “PHP-CLI Service”
volumes:
w
w
w
/html
labels:
com.envisageinternational.desc: “PHP-CLI Container”
command: [‘bin/sh’, ‘
-
c’, “sleep inf
i
nity”]
networks:
web:
conf
i
gs:
mysite:
f
i
le: ./mysite.conf
secrets:
PHP 8.4 FPM
NGINX
MySQL

php:
image: php:8.4-fpm
networks:
- web
depends_on:
- db
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
ports:
- “9000
:
9000”
volumes:
w
w
w
/html
labels:
php
-
cli:
image: php:8.4-cli
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
labels:
-
c’, “sleep inf
i
nity”]
networks:
web:
conf
i
gs:
mysite:
f
i
le: ./mysite.conf
secrets:
version: “3.7”
services:
nginx:
image: nginx
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
conf
i
gs:
- source: mysite
ports:
- “80
:
80”
- “443
:
443”
depends_on:
- php
- db
labels:
-
c',"exec nginx
-
db:
image: mysql
ports:
- “3306
:
3306”
networks:
- web
secrets:
- db_pwd
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
placement:
=
=
manager ]
PHP 8.4 FPM
NGINX
MySQL

php:
image: php:8.4-fpm
networks:
- web
depends_on:
- db
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
ports:
- “9000
:
9000”
volumes:
w
w
w
/html
labels:
php
-
cli:
image: php:8.4-cli
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
labels:
-
c’, “sleep inf
i
nity”]
networks:
web:
conf
i
gs:
mysite:
f
i
le: ./mysite.conf
secrets:
nginx:
image: nginx
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
conf
i
gs:
- source: mysite
ports:
- “80
:
80”
- “443
:
443”
depends_on:
- php
- db
labels:
-
-
PHP 8.4 FPM
NGINX
MySQL

SIDEB
AR:LABELS — use them everywhere!
🤔
?
? ?
? The -f toggle
-
f name=vm_php
-
f label=com.envisage.desc=php

Volume Example for php
php:
volumes:
w
w
w
/html
Local path relative
to the
fi
le
Path location within
the container

Using named storage volumes
Volumes:
pub_html:
external: true
…
php:
volumes:
- pub_html:/var/
w
w
w
/html
Volume name
Path location
within the container
> docker volume create pub_html
—opt type=none
—opt o=bind
—opt device=/Volumes/E/site/
—label “com.envisage.desc=Site”

Using named storage volumes
> docker volume create pub_html
—opt type=none
—opt o=bind
—opt device=/Volumes/E/site/
—label “com.envisage.desc=Site”

* BEWARE WINDOWS PATHS *
C
:
DockerDriveSite
/C/DockerDrives/Site
/host_mnt/c/DockerDrives/Site
/
/
c/DockerDrives/Site
Windows
LCOW
Volume
Path

Convert Your Dev Environment to a Docker Stack - PHP Tek 2025.pdf

POP
QUIZ! A. What is the command to
initialize a swarm?

POP
QUIZ! A. What is the command to
initialize a swarm?
B. What is the command to
deploy a docker stack?

> docker stack deploy
-
c docker
-
compose.yml phptek

-
c docker
-
compose.yml phptek
🤔
?
? ?
?

-
c docker
-
compose.yml phptek
🤔
?
? ?
?
> docker service ls

-
c docker
-
compose.yml phptek
🤔
?
? ?
?
> docker service ls
> docker stack ps phptek

> docker service logs phptek_db

-
c docker
-
compose.yml
-
-
resolve
-
image=never phptek
-
c docker
-
compose.yml phptek

Want to see it in action?
> docker service logs phptek_nginx
-
f

localhost:3306 db:3306

localhost:3306 db:3306
upstream fastcgi {
server 127.0.0.1
:
9000
}
upstream fastcgi {
server php:9000
}

Ok, great! But … ¯_(ツ)_/¯
My production server
has lots of con
fi
gurations
that have been customized…
php/conf.d/*
my.cnf
nginx.conf
nginx/conf.d/*

version: “3.7”
services:
nginx:
image: nginx
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
conf
i
gs:
- source: mysite
ports:
- “80
:
80”
- “443
:
443”
depends_on:
- php
- db
labels:
-
c',"exec nginx
-
db:
image: mysql
ports:
- “3306
:
3306”
networks:
- web
secrets:
- db_pwd
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
placement:
=
=
manager ]
-
image: php:8.4-cli
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
com.envisageinternational.d
volumes:
w
w
w
/html
labels:
com.envisageinternational.de
-
c’, “sleep
i
networks:
web:
conf
i
gs:
mysite:
i
PHP 8.4 FPM
NGINX
MySQL

Con
fi
g: mysite
> docker conf
i
g inspect phptek_mysite

version: “3.4”
services:
nginx:
image: nginx
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
conf
i
gs:
- source: mysite
ports:
- “80
:
80”
- “443
:
443”
depends_on:
- php
- db
labels:
-
c',"exec nginx
-
db:
image: mysql
ports:
- “3306
:
3306”
networks:
- web
secrets:
- db_pwd
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
placement:
=
=
manager ]
php:
image: php:8.4-fpm
networks:
- web
depends_on:
- db
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
ports:
- “9000
:
9000”
volumes:
w
w
w
/html
labels:
php
-
cli:
image: php:8.4-cli
networks:
- web
deploy:
replicas: 1
restart_policy:
condition: on
-
failure
labels:
volumes:
w
w
w
/html
labels:
-
c’, “sleep inf
i
nity”]
networks:
web:
conf
i
gs:
mysite:
f
i
le: ./mysite.conf
secrets:
PHP 8.4 FPM
NGINX
MySQL

Secret: db_pwd
> docker secret inspect phptek_db_pwd

> docker conf
i
g ls

> docker conf
i
g create mysite.2 ./mysite2.conf
> docker conf
i
g ls

> docker conf
i
g create mysite.2 ./mysite2.conf
> docker conf
i
g ls
> docker service update
-
-
conf
i
g
-
rm phptek_mysite
-
-
conf
i
g
-
add source=mysite.2,target=/etc/nginx/conf.d/default.conf
phptek_nginx

> docker service rollback phptek_nginx

Done with the project for now?
> docker stack rm phptek

POP
QUIZ! A. How do you check the
replication status of services?

POP
B. How do you check for error
messages on the stack?

POP
BONUS POINT

POP
BONUS POINT
How do you avoid truncating the error message?

POP
> docker stack ps vm
-
-
no
-
trunc
BONUS POINT
How do you avoid truncating the error message?

Same project … multiple production
targets?
docker-compose.yml
docker-compose-clientA.yml
docker-compose-clientB.yml

POP
QUIZ! A. How do you
fi
lter a list of
docker objects (services,
containers, images, etc)

SIDEB
AR:The $( ) magic with -q -l -f
-q Quiet (ID only)
-l Last Updated Only (1 result)
-f Filter (you remember this)

SIDEB
-q Quiet (ID only)
-
q
-
l

SIDEB
-q Quiet (ID only)
-
q
-
l
> docker container exec
-
it $(docker ps
-
lq
-
f name=phptek_nginx) bash

.zshrc aliases for the win …
¯_(ツ)_/¯
(Sorry, you’re on your own for Windows mounts)

Need WordPress?
FROM wordpress:6-php8.3-fpm AS wpbuilder
# *** PHP-FPM image clean and viable for building others, preloaded with the wordpress base from
wordpress directly *** #
FROM fpm AS wordpressrelease
COPY --from=wpbuilder /usr/src/wordpress /usr/src/wordpress
COPY ./wp/db.php /usr/src/wordpress/wp-content/
COPY ./wp/db-con
fi
g.php /usr/src/wordpress/
CMD php-fpm
# Copy in the blog base
COPY —from=mynamespace/php:wordpress-8.3 /usr/src/wordpress/ /var/www/html/blog/
# Copy in the current source code
COPY ./ /var/www/html

Questions?
https://joind.in/talk/7bbd7
🤔
?
? ?
?
@danaluther@phpc.social
https://www.linkedin.com/in/danaluther
dluther@envisageinternational.com
https://github.com/DanaLuther/DevDockerStackSample/tree/phptek

Convert Your Dev Environment to a Docker Stack - PHP Tek 2025.pdf

More Related Content

Similar to Convert Your Dev Environment to a Docker Stack - PHP Tek 2025.pdf (20)

More from Dana Luther (9)

Recently uploaded (20)

Convert Your Dev Environment to a Docker Stack - PHP Tek 2025.pdf