Важно: прежде чем приступать, обязательно прочитайте руководство по установке Docker.
В качестве результата пришлите ссылки на ваши GitHub-проекты в личном кабинете студента на сайте netology.ru.
Все задачи этого занятия нужно делать в разных репозиториях.
Важно: если у вас что-то не получилось, то оформляйте issue по установленным правилам.
Важно: не делайте ДЗ всех занятий в одном репозитории. Иначе вам потом придётся достаточно сложно подключать системы Continuous integration.
- Инициализируйте на своём компьютере пустой Git-репозиторий.
- Добавьте в него готовый файл .gitignore.
- Добавьте в этот же каталог код, требуемый в ДЗ. Создать и отредактировать конфигурационные файлы вы можете в любом текстовом редакторе или IntelliJ IDEA. Если вы используете IntelliJ IDEA, то рекомендуется использовать тип проекта Empty Project.
- Сделайте необходимые коммиты.
- Создайте публичный репозиторий на GitHub и свяжите свой локальный репозиторий с удалённым.
- Сделайте пуш — удостоверьтесь, что ваш код появился на GitHub.
- Ссылку на ваш проект отправьте в личном кабинете на сайте netology.ru.
- Задачи, отмеченные как необязательные, можно не сдавать, это не повлияет на получение зачёта.
Важно: задачи этого занятия не предполагают подключения к CI.
Этот раздел не является частью ДЗ и не обязателен для выполнения, но он позволяет вам облегчить себе взаимодействие с Docker и Docker compose на первое время, воспользовавшись графическим интерфейсом.
Откройте IntelliJ IDEA, перейдите в раздел настроек:
- Windows/Linux: File -> Settings
- MacOS: IntelliJ IDEA -> Preferences
Найдите в поиске раздел Plugins:
Нажмите на кнопку Install
, после установки перезапустите IDEA.
Теперь при открытии файлов Dockerfile
, docker-compose.yml
IDEA будет предлагать автодополнение и возможность запуска прямо из окна редактора:
После запуска откроется окно Services
, где вы можете посмотреть образы, контейнеры и запущенные с помощью Docker compose сервисы:
Вам необходимо подготовить приложение к тестированию на СУБД PostgreSQL. Используйте образ 13-alpine, если он недоступен, то берите последний опубликованный на Docker Hub. Возьмите собранный JAR-файл db-api.jar
, аналогично примеру на лекции положите рядом файл application.properties
, но в строке:
jdbc:mysql://...
поменяйте mysql
на postgresql
.
Вам нужно дописать остальные настройки: хост, порт, БД, имя пользователя и пароль.
Кроме того, вам нужно подготовить файл docker-compose.yml
, в котором прописать настройки для запуска контейнера PostgreSQL. Всю информацию о его запуске вы найдёте на официальной странице образа на Docker Hub. Рекомендуем также изучить документацию по СУБД PostgreSQL для получения информации о данном продукте.
Запустите сначала docker-compose up
и только после того, как БД запустится, запустите целевое приложение: java -jar db-api.jar
. Если нужно поменять порт запуска, по умолчанию он 9999, то добавьте в файл application.properties
строку server.port=<нужный номер порта>
.
Если вы сделали всё правильно, то приложение запустится и на GET http://localhost:9999/api/cards
выдаст вам JSON с картами:
[
{
"id":1,
"name":"Альфа-Карта Premium",
"description":"Альфа-Карта вернёт ваши деньги",
"imageUrl":"/alfa-card-premium.png"
},
{
"id":2,
"name":"Alfa Travel Premium",
"description":"Самая выгодная карта для путешествий",
"imageUrl":"/alfa-card-travel.png"
},
{
"id":3,
"name":"CashBack Premium",
"description":"Заправь свою карту. Кешбэк на АЗС, в кафе и ресторанах",
"imageUrl":"/alfa-card-cashback.png"
}
]
В результате выполнения этой задачи вы должны положить в репозиторий следующие три файла (других файлов не должно быть):
- .gitignore
- db-api.jar,
- application.properties,
- docker-compose.yml,
- README.md со скриншотом ответа приложения.
Важно: для удаления всех данных и начала с чистого листа сделайте следующее:
docker-compose down
в каталоге с файломdocker-compose.yml
,- удалите каталог для хранения данных
data
, - запустите заново
docker-compose up
, после того как всё исправите.
Важно: команда docker-compose rm
в каталоге с файлом docker-compose.yml
удаляет сам контейнер.
Приложение можно упаковать в Docker-образ, чтобы затем запускать из него контейнеры.
Сделать это, в принципе, несложно: достаточно создать файл Dockerfile
, в котором описать правила сборки образа.
Для лучшего пониманию процесса докеризации приведем небольшой пример с использованием учебного приложения для Node.js.
Важно: Для решения домашнего задания надо будет выполнить докеризацию другого учебного приложения.
Поскольку наше приложение для Node.js написано на языке JavaScript, то со слов разработчиков:
Компилировать ничего не надо.
Нужна только установленная Node.js версии не ниже 12.
В командной строке нужно выполнить: npm install для установки зависимостей.
Для запуска приложения нужно выполнить: npm start.
Приложение запустится на порту 9999.
Итак, начнём по порядку. Мы, конечно, можем с нуля собрать образ, но так почти никто не делает. Мы можем взять уже готовый образ, в котором установлена платформа Node.js.
Поскольку мы рассматриваем простейший сценарий, то сборка образа сведётся к следующим инструкциям:
FROM
— выбираем готовый образ для старта, на базе которого мы будем создавать свой;WORKDIR
— установим рабочий каталог внутри образа;COPY
— копируем файлы из текущего каталога в файловую систему образа;RUN
— выполняем дополнительные действия, например, установку зависимостей;CMD
— описываем команду запуска;EXPOSE
— описываем, какие порты будет слушать контейнер.
Полное описание синтаксиса Dockerfile.
Идём на Docker Hub и ищем Node.js:
Начинаем писать наш Dockerfile
:
FROM node:erbium-alpine3.12
Apline Linux — минималистичный образ, который часто используется в качества базового благодаря своим небольшим размерам — около 5 мегабайт.
Устанавливаем рабочий каталог и пишем команду копирования всех файлов из текущего каталога нашего проекта в образ:
FROM node:erbium-alpine3.12
WORKDIR /opt/app
COPY . .
Запускаем команду установки зависимостей из инструкции разработчиков:
FROM node:erbium-alpine3.12
WORKDIR /opt/app
COPY . .
RUN npm install
Примечание: здесь есть нюансы, связанные с послойной организацией файловой системы образов Docker, но мы для простоты изложения проигнорируем их.
Прописываем команду старта:
FROM node:erbium-alpine3.12
WORKDIR /opt/app
COPY . .
RUN npm install
CMD ["npm", "start"]
Да, CMD пишется достаточно странно, но это связано с особенностями обработки. Текущая форма называется exec form
и представляет из себя JSON-массив в формате: ["executable","param1","param2"]
. О деталях вы можете почитать на странице описания Dockerfile.
Последнее, что осталось, — указать нужные порты. Это просто информация для того, кто будет запускать контейнер:
FROM node:erbium-alpine3.12
WORKDIR /opt/app
COPY . .
RUN npm install
CMD ["npm", "start"]
EXPOSE 9999
Собираем командой:
docker image build -t node-app:1.0 .
, где -t
— это задание тега образу.
Если всё соберётся успешно, то вы можете стандартными средствами посмотреть, что теперь ваш образ есть на вашем компьютере:
docker image ls
.
А также запустить из него контейнер, в том числе с использованием Docker compose.
Можно собрать всё приложение и запустить, сразу используя следующую конфигурацию Docker compose:
version: '3.7'
services:
node-app:
build: .
image: node-app:1.0
ports:
- '9999:9999'
build: .
означает, что мы собираем образ из Dockerfile
, находящемся в текущем каталоге.
И запускайте docker-compose up --build
. Уберите флаг --build
, чтобы образ не пересобирался каждый раз.
Готовый проект вы можете найти в каталоге node
вместе с файлом docker-compose.yml
.
Важно: После изучения примера, можно перейти к выполнению домашнего задания.
Теперь ваша задача — взять готовое приложение для контейнеризации db-api-for-docker.jar
(оно без зависимостей, никакая СУБД ему не нужна) и упаковать в образ, то есть создать Dockerfile
и docker-compose.yml
.
Общие условия:
- приложению для работы нужна Java 8, используйте в качестве базового образа openjdk:8-slim;
- никаких внешних файлов, кроме самого JAR-ника не требуется;
- JAR-ник запускается командой
java -jar db-api-for-docker.jar
и поднимает сервер на порту 9999. Для теста сделайтеGET http://localhost:9999/api/cards
.
В результате выполнения этой задачи вы должны положить в репозиторий следующие файлы:
- .gitignore
- db-api-for-docker.jar,
- Dockerfile,
- docker-compose.yml,
- README.md со скриншотом ответа приложения.