8 часов, 2 ак. дня.
- RAM ≥ 4Gb
- Права локального админа для аккаунта участника
- Доступен git repo с данным руководством
https://github.com/artemnikotin/docker
<https://github.com/eugene-krivosheyev/docker
- Доступен
https://hub.docker.com
(Docker Hub) - Зарегистрирована учетная запись
artemnikotin
наhttps://hub.docker.com
- Установлен Docker CE или совместимый менеджер контейнеров (e.g. Podman)
sudo dnf install -y docker
7:20
- две части курса: обязательная базовая для всех ролей и расширенные темы больше в сторону эксплуатации
- Зачем нужен Docker? Метафора морского контейнера
- Каковы функции инструментов контейнеризации?
- development environment?
- testing environment?
- production environment?
- Виртуализация (инфраструктуры) VS контейнеризация (приложения)?
- место на диске для гостевой ОС
- время запуска гостевой ОС
- overhead операций гостевой ОС
- Контейнер – процесс ОС "на стероидах": какие ресурсы необходимо изолировать и инкапсулировать?
- Схема контейнеризации
- dockerd
- docker cli
- disk image provisioning tool (dockercli) and Dockerfile
- disk image
- disk image registries: docker hub and corporate registries
- container = running process + container data (container layer)
puml
@startuml
node "container\nregistry" {
database "disk\nimage" as disk_image
}
node "host" {
rectangle "container" {
component "application"
database "container\nlayer" as layer
}
database "disk" {
database "image"
file "volume"
folder "shared\nfolder" as folder
disk_image - image
}
image --layer
volume -# container
folder -# container
}
container #--# host : "port\nmapping"
@enduml
-
Клиентский UI
-
docker cli
-
podman cli
-
GUI в дистрибутиве для MacOS
-
GUI в IDEA
-
...
-
Итого
Контейнер – это новый экзешник. Переносимый, безопасный и управляемый.
-
Given
-
сделан форк данного руководства для собственных пометок
-
форк открыт в браузере для внесения пометок
-
для последующей удобной работы с copy+paste для ресурсов раздела Prerequisites плейсхолдеры заменены актуальными значениями
-
Сформированы пары участников с чередованием ролей в паре
-
Hint: синонимы команд docker cli
-
Hint:
... --help
-
Hint: docker cli reference
-
Hint: при работе в терминале используйте
Tab
и↑
для автоподстановки значений -
"Как описать сценарий использования команд?"
В общем случае:
- предварительные команды подготовки системы к действию
- команды действия
- команды проверки успешности и корректности действия
- When участники именуют сценарии, выполняют команды и анализируют их вывод и поведение
- Сценарий "Как мне узнать состояние системы?"
docker version # отобразить версию клиента и сервера
docker system info # отобразить текущее состояние системы: установленные плагины, запущенные образы,...
docker system df # отобразить использование диска
docker events # слушать события докера
- Сценарий "Как мне авторизироваться?"
(в новом ssh shell, чтобы параллельно видеть вывод
docker events
)
docker logout
open https://hub.docker.com/settings/security # to make Access Token
docker login -u artemnikotin -p {{ access-token }} # login default hub.docker.com registry
- Сценарий "Как скачать образ?"
docker image pull alpine
docker system df
- Сценарий "Как запустить контейнер?"
docker container ls [--all]
docker container run --name demo -it alpine
/# cat /etc/os-release
/# exit
- Сценарий "Как удалить контейнер?"
docker container ls [--all]
docker container rm [--force] demo
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Успешна ли сконфигурирована система для использования docker?
- Какая версия API? # 1.41
- Откуда взялся образ диска? # из Docker HUB
- Сколько места занимает образ? # 5.595MB
- Сколько места занимает контейнер? # активный 0B, 5B после выхода
- Какая версия образа скачивается по умолчанию? # :latest
- Какая гостевая команда запускается при запуске контейнера? # /bin/sh
- Задача среды исполнения контейнеров: изоляция диска
- Отображение диска контейнера на диск хостовой системы: образ
- Что должно быть на диске для запуска и работы контейнеризованного приложения?
- Состав образа диска (от
scratch
до prod-ready) - OS libraries
- OS executables
- Application libraries
- Application executables
- Config files
- Data files
$ docker run --rm -it alpine ls
bin dev etc home lib media mnt opt proc root run sbin srv sys tmp usr var
- Идентификация образов:
id
как хеш [слоя] образахост/репозиторий/имя:тег
хост/репозиторий/группа/имя:тег
- Жизненный цикл образа в репозитории и аналогии с git
docker container run
+ side effects >docker container commit
>docker image push
# редко используемый "ручной" ЖЦdocker image build
>docker image push
>docker image pull
|docker container run
# штатный автоматизированный ЖЦ
$ docker image ls [--all]
REPOSITORY TAG IMAGE ID CREATED SIZE
alpine latest b0e47758dc53 6 weeks ago 5.33MB
hello-world latest a29f45ccde2a 19 months ago 9.14kB
$ docker image history ekr26/backend:1.0.0
IMAGE CREATED CREATED BY SIZE COMMENT
e96641ea7cdf 2 days ago COPY dbo-1.0-SNAPSHOT.jar /dbo # buildkit 65.9MB buildkit.dockerfile.v0
<missing> 2 days ago ENTRYPOINT ["java" "-jar" "dbo-1.0-SNAPSHOT.… 0B buildkit.dockerfile.v0
<missing> 2 days ago WORKDIR /dbo 0B buildkit.dockerfile.v0
<missing> 2 days ago RUN /bin/sh -c mkdir -p /dbo # buildkit 0B buildkit.dockerfile.v0
<missing> 2 days ago EXPOSE map[8080/tcp:{}] 0B buildkit.dockerfile.v0
<missing> 5 days ago /bin/sh -c #(nop) ENV JAVA_HOME=/opt/java/o… 0B
<missing> 5 days ago /bin/sh -c set -eux; apk add --no-cache … 96.9MB
<missing> 5 days ago /bin/sh -c #(nop) COPY multi:b8938281d618ac3… 16.7kB
<missing> 5 days ago /bin/sh -c #(nop) ENV JAVA_VERSION=jdk8u282… 0B
<missing> 5 days ago /bin/sh -c apk add --no-cache tzdata --virtu… 14.2MB
<missing> 5 days ago /bin/sh -c #(nop) ENV LANG=en_US.UTF-8 LANG… 0B
<missing> 6 days ago /bin/sh -c #(nop) CMD ["/bin/sh"] 0B
<missing> 6 days ago /bin/sh -c #(nop) ADD file:f77db8e5b937d8ebb… 5.58MB
$ docker run --rm -v /var/run/docker.sock:/var/run/docker.sock nate/dockviz images -t
├─<missing> Virtual Size: 5.6 MB
│ └─<missing> Virtual Size: 5.6 MB
│ └─<missing> Virtual Size: 5.6 MB
│ └─<missing> Virtual Size: 19.8 MB
│ └─<missing> Virtual Size: 19.8 MB
│ └─<missing> Virtual Size: 19.8 MB
│ └─<missing> Virtual Size: 116.7 MB
│ └─<missing> Virtual Size: 116.7 MB
│ ├─<missing> Virtual Size: 116.7 MB
│ │ └─<missing> Virtual Size: 116.7 MB
│ │ └─<missing> Virtual Size: 116.7 MB
│ │ └─<missing> Virtual Size: 136.7 MB
│ │ └─<missing> Virtual Size: 136.7 MB
│ │ └─3c1355b22f16 Virtual Size: 136.7 MB Tags: training-docker/ekr-stub:1.0.0
│ └─<missing> Virtual Size: 116.7 MB
│ └─<missing> Virtual Size: 116.7 MB
│ └─<missing> Virtual Size: 116.7 MB
│ └─<missing> Virtual Size: 116.7 MB
│ └─e96641ea7cdf Virtual Size: 182.6 MB Tags: training-docker/ekr-backend:1.0.0
-
docker image history
+docker image inspect
- Вспомогательные утилиты
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock nate/dockviz images -t
docker run -v /var/run/docker.sock:/run/docker.sock -ti -e TERM tomastomecek/sen
- dive
-
Given пары участников
-
When участники именуют сценарии, выполняют команды и анализируют их вывод и поведение
-
Сценарий "Как получить список скаченых образов?"
docker image ls # TODO: собственные пометки участников для будущего использования в проектах
- Сценарий "Как скачать образ?"
docker image pull alpine
docker image ls
- Сценарий "Как посмотреть историю и детали образа в определенном формате?"
docker image history alpine
docker image inspect alpine
docker image inspect alpine --format="{{.Id}} -> {{.Parent}}"
- Сценарий "Как посмотреть и закомитить изменения?"
docker container run --name demo -it alpine
/# touch side-effect.txt
/# exit
docker container diff demo
docker container commit demo artemnikotin/demo
docker image ls
- Сценарий "Как добавить новое символьное имя образа?"
docker image tag artemnikotin/demo:latest artemnikotin/demo:1.0.0
docker image ls
- Сценарий "Как сохранить образ в хабе?"
docker image push artemnikotin/demo:1.0.0
- Сценарий "Как удалить образ?"
docker image ls
docker container rm demo
docker image prune # групповое удаление всех без символьного имени
docker image ls
docker image rm artemnikotin/demo:1.0.0 # удаление символьного имени образа
docker image ls
docker image rm artemnikotin/demo:latest # удаление символьного имени и самого образа
docker image ls
docker image prune --all # групповое удаление всех неассоциированных с контейнерами
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Какие способы идентификации образа? # символьное имя и/или сам образ
- Какой тег у образа по умолчанию при создании коммитом? # :latest
- Какой тег у образа по умолчанию при операции
pull
? # :latest - В чем физический смысл удаления образа командой
rm
? # удалить образ или символьное имя - Всегда ли удаляется образ по команде
rm
? # только если последний и нет ассоциированных контейнеров - Что делает prune? # групповое удаление
- Что такое dangling image? # образ без символьного имени
-
container = running process + container data (container layer)
-
Что значит "запуск" контейнера? Что именно там запускается?
-
Как можно доопределить команду, запускаемую в контейнере?
-
Что нужно определить для запуска контейнера?
-
имя контейнера (+defaults)
-
disk image
-
virtual network
-
folder | volume mapping
-
entry point (image
entrypoint
override) -
guest environment variables
-
command line arguments (image
cmd
override) -
Экстернализация конфигурации приложения при запуске контейнера
-
docker container create
+docker container start
=docker container run
[args]
-
docker container pause
,docker container unpause
-
docker container commit
-
просмотр работающих и остановленных контейнеров
docker container ls [--all]
-
подключение к рабочему контейнеру
-
просмотр лога контейнера
-
docker container stop
-
docker container rm
-
Запуск контейнера в интерактивном и фоновом режимах:
-d
vs-it
-
Сколько по времени будет работать контейнер?
-
Можно ли запускать несколько сервисов в одном контейнере?
-
отслеживается только один процесс c PID 1 (из директив ENTRYPOINT + CMD) и по его завершению контейнер завершается тоже, жестко останавливая остальные процессы
-
поэтому технически можно, но если очень аккуратно запустить свой менеджер процессов и управлять дочерними процессами
-
в целом вся философия, инструментарий и паттерны Docker рекомендуют подход "service per container"
-
иначе сложно контейнеры отлаживать, мониторить, анализировать логи, разделять ресурсы и данные, обрабатывать падения сервисов
-
для управления группой контейнеров существуют оркестраторы
-
Given пары участников
-
[optional]
sudo yum install -y jq
# json cli viewer -
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как посмотреть список работающих и остановленных контейнеров?"
docker container ls --all
docker container ls --format '{{.ID}} | {{.Names}} | {{.Status}} | {{.Image}}'
- Сценарий "Как запустить 'одноразовый' контейнер?"
docker container run --rm -it alpine # note `--rm`
/# exit
docker container ls
- Сценарий "Как запустить контейнер в фоновом режиме?"
docker container run --detach --name proxy --publish 80:80 nginx:1.19.4 # note `--detach`
docker container ls
curl localhost:80
- Сценарий "Как 'подключиться' к работающему контейнеру?"
docker container logs proxy
docker container attach --sig-proxy=false proxy # otherwise detach key `ctrl-c` will stop container
curl localhost:80 # in other terminal
docker container top proxy
docker container exec -it proxy /bin/sh
- Сценарий "Как посмотреть свойства контейнера?"
docker container port proxy
docker container inspect proxy [| jq]
- Сценарий "Как поставить на паузу контейнер?"
docker container pause proxy
docker container ls
docker container unpause proxy
docker container ls
- Сценарий "Как создать контейнер с сервисом без запуска?"
docker container create --name my-proxy --publish 80:80 nginx:1.19.4
docker container ls --all
- Сценарий "Как запустить созданный контейнер?"
docker container stop proxy
docker container start my-proxy
docker container ls
- Сценарий "Как остановить и запустить снова работающий контейнер?"
docker container restart my-proxy # start even if not started
docker container stop my-proxy # send SIGTERM, and then SIGKILL after grace period (Exited (0))
docker container start my-proxy
docker container kill # send SIGKILL, or specified signal (Exited (137))
- Сценарий "Как удалить работающий контейнер?"
docker container rm --force my-proxy
- Сценарий "Как удалить остановленный контейнер?"
docker container rm proxy
docker container prune # все остановленные контейнеры
- Сценарий "Как узнать и сохранить container data (container layer)?"
docker container diff
docker container commit
docker images --all
- Опциональный сценарий "Как обменяться файлами с контейнером?"
docker container cp
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Какие способы идентификации контейнера?
- Какое имя у контейнера по умолчанию?
- В чем физический смысл удаления контейнера?
- Что делает
prune
? - Сколько новых layers добавила команда
commit
к базовому образу? # 1
- Ценность
- Что на производство
- Что улучшить
- Какие вопросы дозакрыть
- Автоматическая сборка – "это другое!"
- часть CI/CD pipeline:
- требования к частоте сборок
- требования к скорости сборок
- требования к ресурсоемкости
- Какие действия необходимо совершить для подготовки образа в случае автоматической сборки?
- Экстернализация конфигурации приложения при сборке образа
- Команда сборки образа
docker [image] build
- Понятие build context
- Кеширование при сборке (включая
--pull
,--no-cache
)
$ docker image build .
Uploading context 6.76 MB
Step 1/2 : FROM busybox
---> 769b9341d937
Step 2/2 : CMD echo Hello world
---> Using cache
---> 99cc1ad10469
Successfully built 99cc1ad10469
- Структура Dockerfile и декларативность директив
- Ключевые директивы Dockerfile
FROM
WORKDIR
создаст папку при необходимостиCOPY
andADD
from build context (+.dockerignore
)RUN
(+shell
and preferredexec
forms) andSHELL
for non-default shellENV
ARG
EXPOSE
documentationVOLUME
ENTRYPOINT
andCMD
(+ preferredexec
and similardefault parameters to ENTRYPOINT
,shell
forms)
docker container run [--entrypoint Dockerfile's ENTRYPOINT override] IMAGE [Dockerfile's CMD defaults override]
FROM alpine
ENTRYPOINT ["echo", "Hello"]
CMD ["World"] # 'default parameters to ENTRYPOINT' form
...
$ docker build --tag test .
...
$ docker run --rm test
Hello World
...
$ docker run --rm test Alpine
Hello Alpine
-
Системные образы для базы VS прикладные образы с приложениями
-
Dockerfile should specify at least one of
CMD
orENTRYPOINT
commands -
ENTRYPOINT
should be defined when using the container as an executable. -
CMD
should be used as a way of defining default arguments for anENTRYPOINT
command or for executing an ad-hoc command in a container -
CMD
will be overridden when running the container with alternative arguments -
If
CMD
is defined from the base image, settingENTRYPOINT
will resetCMD
to an empty value -
Версионирование создаваемого образа через теги
-
опасность
:latest
-
semantic versioning
-
unique tags
- Given пары участников
- Будущая структура папок, которую участники создадут в процессе этой и следующих практик
application
├── backend
│ ├── Dockerfile
│ ├── dbo-1.0-SNAPSHOT-sources.zip
│ └── dbo-1.0-SNAPSHOT.jar
├── db
│ └── Dockerfile
├── proxy
│ ├── Dockerfile
│ └── nginx.conf
├── stub
│ ├── mappings
│ │ └── legacyAccountingSystemResponse.json
│ ├── Dockerfile
│ └── wiremock-standalone-2.27.2.jar
└── docker-compose.yml
- Создана рабочая папка проекта
mkdir application
- When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
- Сценарий "Как создать и опубликовать собственный образ на основе Dockerfile?"
cd application
cat backend/Dockerfile # check it for reference of new base/Dockerfile
mkdir base
nano base/Dockerfile #TODO describe image that based on CentOS fixed fresh available version and install java-1.8.0-openjdk-headless with `yum install -y`
docker image build --tag artemnikotin/base:1.0.0 ./base
docker container run --rm artemnikotin/base:1.0.0 java -version
docker image push artemnikotin/base:1.0.0
-
Given
-
пары участников
-
опубликованные базовые образы других команд
-
Dockerfiles для основных сервисов приложения
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как задать "чужой" образ как базовый для своих следующих образов?"
cd application
nano backend/Dockerfile # TODO fix FROM for new base image
- Сценарий "Как описать provision образа в Dockerfile?"
cd application/backend
cat Dockerfile # check out application's default configuration
- Сценарий "Как собрать свой образ с приложением на базе Dockerfile?"
cd application
docker image build --tag artemnikotin/backend:1.0.0 ./backend
docker images
- Сценарий "Как сохранить образ в репозитории?"
docker login
docker image push artemnikotin/backend:1.0.0
- Сценарий "Как запустить "одноразовый" контейнер на базе своего образа с приложением?"
docker container run \
--name backend \
--rm \ # одноразовый: удалится после остановки
--detach \ # -d
--publish 8080:8080 \ # [host address:]8080:8080
--env SPRING_PROFILES_ACTIVE=preprod # ignored as we set profile in CMD
--volume $(pwd)/log:/dbo/log \ # папка в конейнере /dbo/log отображена на папку на хосте /current-path/log
artemnikotin/backend:1.0.0 \ # репозиторий и тег
--spring.profiles.active=qa # параметры командной строки
curl http://localhost:8080/dbo/actuator/health
curl -X POST http://localhost:8080/dbo/actuator/shutdown
docker container ls --all
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- В каком порядке выполнялись директивы Dockerfile?
- Сколько новых layers добавила сборка к базовому образу?
- Когда и по какой причине остановился контейнер?
- Сколько раз вы столкнулись с настройкой экстернализированной конфигурации приложения?
- Какие приориеты у этих точек конфигурации? # cmd -> env
- Что случится при запуске контейнера с параметром командной строки
docker run ... --spring.profiles.active=preprod
?
- Что нужно для целостной работы multi-container приложения?
- Целостная сборка образов (опционально)
- Целостный запуск, работа и завершение
- Какие ресурсы необходимо виртуализировать?
- network
- volumes/folders
- Оркестраторы:
compose
,swarm
,k8s (+minikube)
и их ограничения - Клиенты оркестраторов: Docker Compose (+build) и Docker Stack over Swarm/k8s/minikube (-build)
- Демо
cat docker-compose.yml
-
Given пары участников
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как ...?"
cd application/backend
nano Dockerfile # TODO fix active Spring profile to `preprod` instead of `qa`
docker image build --tag {{ registry-account }}/backend:1.0.0 ./backend
cd application/stub
nano Dockerfile # TODO fix FROM for new custom base image
docker image build --tag {{ registry-account }}/stub:1.0.0 ./stub
- Сценарий "Как ...?"
cd application
docker container run \
--detach \
--name db \
--publish 5432:5432 \
--volume db:/var/lib/postgresql/data \
--env POSTGRES_DB=dbo-db \
--env POSTGRES_USER=dbo \
--env POSTGRES_PASSWORD=dbo \
postgres:11-alpine
docker container run \
--detach \
--name stub \
--publish 8888:8888 \
{{ registry-account }}/stub:1.0.0
curl localhost:8888/api/account [| jq]
docker container run \
--detach \
--name backend \
--publish 8080:8080 \
--env SPRING_PROFILES_ACTIVE=preprod \ # необязательно, установили как параметр командной строки в Dockerfile
--env SPRING_DATASOURCE_URL="jdbc:postgresql://$(hostname -i)/dbo-db" \
--env SPRING_DATASOURCE_USERNAME=dbo \
--env SPRING_DATASOURCE_PASSWORD=dbo \
--env SPRING_INTEGRATION_LEGACYACCOUNTINGSYSTEM_BASEURL="http://$(hostname -i):8888/api" \
{{ registry-account }}/backend:1.0.0
curl -H "X-API-VERSION:1" localhost:8080/dbo/actuator/health [| jq]
curl -H "X-API-VERSION:1" localhost:8080/dbo/api/account [| jq]
open http://{{ external host ip }}:8080/dbo/swagger-ui.html
- Сценарий "Как ...?"
docker container ls [--all]
- Сценарий "Как ...?"
docker container stop
docker container rm [--force]
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- По какому URL получили доступ к веб-интерфейсу приложения для тестирования работоспособности?
- Система работоспособна?
- Исходя из экстернализированных настроек, как связаны компоненты системы?
- Какие ресурсы были виртуализированы?
- Какой оркестратор использовался?
- Что происходит с изменениями в образе при остановке контейнера?
- Как зафиксировать изменения в образе?
- Как откатить изменения в образе?
- Как можно сохранять изменения на диске вне образа?
- Stateful VS Stateless containers
- Управление данными на хостовой машине
- Shared folders как подмонтированные FS
cd application
docker container run --volume "$(pwd)"/folder/file:/folder/file:ro # пути у folder абсолютные, начинаются с "/"
- Volumes как блочные устройства
cd application
docker container run --volume my_volume:/folder/file:ro # имя volume не начинается с "/"
- Жизненный цикл
docker volume
docker volume create
|docker run --volume
|docker build
+ Dockerfiledocker volume ls
docker volume inspect
docker volume rm
|docker volume prune
-
Given пары участников
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как пробросить shared folder с хостовой системы в контейнер?"
docker container run -v # TODO Сделать proxy/Dockerfile ненужным: пробросить nginx.conf как read-only файл в контейнер proxy при его запуске (не при сборке)
- Сценарий "Как посмотреть volumes/folders контейнера?"
docker container inspect # "Mounts"
- Сценарий "Как посмотреть все текущие volumes?"
docker volume ...
- Сценарий "Как удалить неиспользуемую volume?"
docker volume ...
- Сценарий "Как управлять volume и shared folder в docker-compose?"
cd application
nano docker-compose.yml
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Где физически храняться volume?
- Что такое "неиспользуемые" volume?
- Отображение портов
- Варианты сетевой топологии
- Разрешение адресов и имен в виртуальных сетях
--name
default hostname--hostname
explicit hostname-
localhost
issue - слушайте 0.0.0.0
-
Given пары участников
-
В случае podman для работы символьных имен хостов в виртуальных сетях необходимо собрать и сконфигурировать плагин
dnsname
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как создать виртуальную сеть?"
docker network ...
docker container run \
--detach \
--network my_deployment \
--name db \
--volume db:/var/lib/postgresql/data \
--env POSTGRES_DB=dbo-db \
--env POSTGRES_USER=dbo \
--env POSTGRES_PASSWORD=dbo \
postgres:11-alpine
docker container run \
--detach \
--network my_deployment \
--name stub \
{{ registry-account }}/stub:1.0.0
docker container run \
--detach \
--network my_deployment \
--name backend \
--env SPRING_PROFILES_ACTIVE=preprod \ # необязательно, установили как параметр командной строки в Dockerfile
--env SPRING_DATASOURCE_URL="jdbc:postgresql://db/dbo-db" \ # hostname instead of external ip is the result of virtualizing network
--env SPRING_DATASOURCE_USERNAME=dbo \
--env SPRING_DATASOURCE_PASSWORD=dbo \
--env SPRING_INTEGRATION_LEGACYACCOUNTINGSYSTEM_BASEURL="http://stub:8888/api" \ # hostname instead of external ip is the result of virtualizing network
{{ registry-account }}/backend:1.0.0
cd application
nano proxy/nginx.conf #TODOs
docker image build --tag {{ registry-account }}/proxy:1.0.0 ./proxy
docker container run \
--detach \
--network my_deployment \
--name proxy \
--publish 80:80 \
{{ registry-account }}/proxy:1.0.0
- Сценарий "Как подключить контейнер к виртуальным сетям?"
docker network connect
docker network disconnect
- Сценарий "Как посмотреть состояние виртуальных сетей?"
docker network ls
docker network inspect
- Сценарий "Как удалить виртуальную сеть?"
docker network rm
docker network prune
- Сценарий "Как управлять виртуальными сетями в docker-compose?"
cd application
nano docker-compose.yml
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Какая сетевая топология определяется по умолчанию?
- Для каких контейнеров мы определили меппинг портов? Почему не для всех?
- Как мы задаем хосты в экстернализированной конфигурации приложений? Почему не ip?
- Отображение портов
- Установка переменных окружения ОС для контейнера
- Просмотр статистики потребления ресурсов
- Лимитирование памяти и CPU
- Лимитирование дискового объема контейнера
- Лимитирование ресурсов при запуске контейнера
- Лимитирование ресурсов в docker-compose
- Как ведет себя одиночный контейнер при ошибках контейнеризуемого приложения
- Как ведет себя контейнер в swarm при ошибках контейнеризуемого приложения
Hands-on practice quest #07: networked multi-component stateful application resource-limited containerization (10+5)
-
Given пары участников
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как понять текущее потребление ресурсов?"
docker stats
- Сценарий "Как лимитировать ресурсы при запуске контейнера?"
docker container run # ограничить по CPU и памяти, чтобы получить OOME
- Сценарий "Как лимитировать ресурсы в docker-compose?"
cd application
nano docker-compose.yml # ограничить по CPU, чтоб не баловал и по памяти, чтобы получить OOME
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Какие лимиты на ресурсы устанавливаются Docker по умолчанию?
- Какое поведение отдельного контейнера при OOME по умолчанию?
- Как уменьшить размер образа? Как ускорить сборку образа?
- Директивы Dockerfile как слои образа
- каждая директива выполняется своим контейнером
- RUN, COPY, ADD create layers
- Other instructions create temporary intermediate images, and do not increase the size of the build
docker image build --tag stub ./stub
[+] Building 2.2s (10/10) FINISHED
=> [internal] load build definition from Dockerfile 0.0s
=> => transferring dockerfile: 328B 0.0s
=> [internal] load .dockerignore 0.0s
=> => transferring context: 34B 0.0s
=> [internal] load metadata for docker.io/library/openjdk:8-jre-slim 1.3s
=> [1/5] FROM docker.io/library/openjdk:8-jre-slim@sha256:0330883ffeb5e14c4c15271004cdf6a2df21e827420b71dca01c34e41a23690d 0.1s
=> => resolve docker.io/library/openjdk:8-jre-slim@sha256:0330883ffeb5e14c4c15271004cdf6a2df21e827420b71dca01c34e41a23690d 0.0s
=> => sha256:5563c7e505fa828bd868ae99f24c5a56bb0bd5488a10184f7175d10f167b0898 1.16kB / 1.16kB 0.0s
=> => sha256:a6c8e47b54ca34cb71f873f586aaac09f73ace9bffe1b5b62eb2b05f8c974deb 7.14kB / 7.14kB 0.0s
=> => sha256:0330883ffeb5e14c4c15271004cdf6a2df21e827420b71dca01c34e41a23690d 320B / 320B 0.0s
=> [internal] load build context 0.4s
=> => transferring context: 20.00MB 0.4s
=> [2/5] RUN mkdir -p /stub/mappings 0.5s
=> [3/5] WORKDIR /stub 0.0s
=> [4/5] COPY mappings/* mappings/ 0.0s
=> [5/5] COPY wiremock-standalone-2.27.2.jar /stub 0.1s
=> exporting to image 0.1s
=> => exporting layers 0.1s
=> => writing image sha256:0a8dfafa48b9c717b862532fe441e8f2db7146a6deb8380768e6a713c75a6da4 0.0s
=> => naming to docker.io/library/stub
- Кеширование включаемых файлов и результатов директив
docker image build --tag stub ./stub
[+] Building 1.9s (11/11) FINISHED
=> [internal] load build definition from Dockerfile 0.0s
=> => transferring dockerfile: 328B 0.0s
=> [internal] load .dockerignore 0.0s
=> => transferring context: 32B 0.0s
=> [internal] load metadata for docker.io/library/openjdk:8-jre-slim 1.8s
=> [auth] library/openjdk:pull token for registry-1.docker.io 0.0s
=> [1/5] FROM docker.io/library/openjdk:8-jre-slim@sha256:0330883ffeb5e14c4c15271004cdf6a2df21e827420b71dca01c34e41a23690d 0.0s
=> [internal] load build context 0.0s
=> => transferring context: 689B 0.0s
=> CACHED [2/5] RUN mkdir -p /stub/mappings 0.0s
=> CACHED [3/5] WORKDIR /stub 0.0s
=> CACHED [4/5] COPY mappings/* mappings/ 0.0s
=> CACHED [5/5] COPY wiremock-standalone-2.27.2.jar /stub 0.0s
=> exporting to image 0.0s
=> => exporting layers 0.0s
=> => writing image sha256:1b7c6f374f61947cd1e96233307f4fa56dfc3c0e5fd6bf228b0e7e27803ca011 0.0s
=> => naming to docker.io/library/stub
- Оптимизации
- Используйте build cache: порядок директив в Dockerfile
- Составные команды
- Выбор образа-предка: легковесные ОС, busybox и
scratch
-образ
Hands-on practice quest #08: build-optimized networked multi-component stateful application resource-limited containerization (15+5)
-
Given пары участников
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как оптимизировать сборку?"
nano application/backend/Dockerfile # TODO оптимизировать сборку и убедиться в ускорении
nano application/proxy/Dockerfile
nano application/stub/Dockerfile
- Сценарий "Как управлять кешем сборки?"
docker builder prune [--all]
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Насколько получилось оптимизировать сборки в измеряемых метриках?
- Минимизировать security риски
- Используйте минимальные образы: быстрее и меньше зависимостей + меньше рисков
- Запуск в rootless mode или от пользователя с минимальными привилегиями с возможностью при запуске добавить прав
- Подписывать образы и проверять подписи
- Сканеры уязвимостей для образов
docker scan --dependency-tree <image>
- Линтеры для Dockerfile
- COPY вместо ADD
- Аккуратно с рекурсивным копированием + .dockerignore
- Фиксированные теги для идентификации образов (Semantic versioning vs Unique tags)
-
Хранение и передача конфигурации и чувствительных данных
-
Локальное журналирование и доступ к логам
- docker logging drivers
- dedicated logs shared folders/volumes
- remote log collectors
-
Мониторинг
-
Паттерн Builder vs "multi-stage build" для конвейера разработки и поставки ПО: CI/CD pipeline
-
в том числе, чтобы в итоговый образ не утекли чувствительные данные
Hands-on practice quest #09: build-optimized networked multi-component stateful application resource-limited best practice based containerization (10+5)
-
Given пары участников
-
When участники именуют сценарии, формируют свои команды и проверяют их вывод и поведение
-
Сценарий "Как ...?"
docker info --format '{{.LoggingDriver}}'
docker container run -it --log-driver local --log-opt mode=non-blocking --log-opt max-buffer-size=4m
docker inspect -f '{{.HostConfig.LogConfig.Type}}'
docker logs
- Сценарий "Как осуществить multi-stage сборку образа?"
cd application/backend
nano Dockerfile # TODO: BUILD stage with `mvn clean verify` and QA stage with `java -jar ... --spring.profiles.active=qa`
- Then участники делятся проблемами и отвечают на вопросы
- Как проименовали сценарии?
- Какие интересные Вам метрики можно снимать?
- Как Docker упрощает ручное тестирование
- Версионирование как дисциплина
- Образ для ручного тестирования с подготовленными тестовыми данными
- Легкий старт нужного окружения on demand
- Окружение тестирования больше не узкое место
- Как Docker упрощает автоматизированное тестирование
- TestContainers
- k8s больше не поддерживает docker: все пропало?
- Как устроен Docker? Элементы.
- Как устроены аналоги? Элементы.
- Ценность
- Что на производство
- Что улучшить
- Какие вопросы дозакрыть
Для желающих:
- Пройти практику до конца на stand-alone containers
- Пройти практику до конца с использованием оркестратора (docker-compose.yml compliant:
docker compose
,docker stack
in default swarm mode,podman compose
)