Compare commits

..

1 Commits

Author SHA1 Message Date
4922e9075e polevoy_sergey_lab_1_completed 2024-09-18 19:01:17 +04:00
5 changed files with 67 additions and 110 deletions

View File

@@ -1,61 +0,0 @@
# Отчет. Лабораторная работа 1
В рамках лабораторной работы с помощью технологии контейнеризации docker были развернуты сервисы:
- Redmine - система баг-трекинга
- Postgres - СУБД
- RabbitMQ - брокер сообщений
## Описание
В docker-compose.yml файле описаны настройки для запуска трех выбранных сервисов в контейнерах. Для большинства строк файла оставлены
комментарии, объясняющие содержимое файла.
Стоит отметить, для сервиса Redmine было принято решение в качестве сервера баз данных не использовать базу данных по умолчанию - SQLite,
а поднять внешний сервер баз данных Postgres, который был запущен в рамках этого же файла docker-compose.yml.
Для того, чтобы при старте postgres уже была создана база данных для Redmine, а также пользователь, под учетной записью
которого будет работать Redmine, был написан скрипт init-database.sh с использованием bash и sql:
```
# Создаем пользователя redmine и БД redminedb
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
CREATE USER redmine WITH PASSWORD 'redmine-password';
CREATE DATABASE redminedb;
GRANT ALL PRIVILEGES ON DATABASE redminedb TO redmine;
EOSQL
# Даем права на схему public
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USERNAME" -d redminedb <<-EOSQL
ALTER SCHEMA public OWNER TO redmine;
GRANT ALL ON SCHEMA public TO redmine;
EOSQL
```
Этот скрипт монтируется в директорию контейнера postgres ``docker-entrypoint-initdb.d``, которая является специальной точкой входа
для инициализации БД и содержит соответствующие скрипты.
## Как запустить
Для того, чтобы запустить сервисы, необходимо выполнить следующие действия:
1. Установить и запустить Docker Engine или Docker Desktop (включает в себя Docker Engine и предоставляет UI)
2. Через консоль перейти в папку, в которой расположен файл docker-compose.yml
3. Выполнить команду:
```
docker compose up -d
```
В случае успешного запуска всех контейнеров в консоли будет выведено следующее сообщение:
```
[+] Running 3/3
✔ Container rabbitmq Started 0.8s
✔ Container redmine Started 1.2s
✔ Container postgres Started 0.5s
```
Также будет создана папка postgres_data, которая монтируется в контейнере postgres
Мы также можем увидеть статус всех запущенных контейнеров, если выполним команду:
```
docker ps
```
Или обратившись к логам каждого из контейнеров:
``
docker logs <container_name>
``
## Видео-отчет
Работоспособность лабораторной работы можно оценить в следующем [видео](https://disk.yandex.ru/d/15QhUl3KQYSavA).

View File

@@ -1,34 +0,0 @@
services:
postgres:
image: postgres:latest # название и версия образа docker
container_name: postgres # название контейнера
environment: # блок переменных окружения, которые будут использованы для запуска и настройки
POSTGRES_USERNAME: postgres # имя пользователя супер-пользователя СУБД
POSTGRES_PASSWORD: postgres-admin # имя пользователя супер-пользователя СУБД
PGDATA: "/var/lib/postgresql/data/pgdata" # путь к директории, где Postgres будет хранить свои данные.
ports:
- "5432:5432" # пробрасываем стандартный порт для доступа к postgres
volumes:
- ./postgres_data:/var/lib/postgresql/data/ # монтируем локальную директорию в директорию внутри контейнера с данными базы данных
- ./init-database.sh:/docker-entrypoint-initdb.d/init-database.sh # Монтирует скрипт инициализации базы данных в специальную директорию внутри контейнера.
redmine:
image: redmine
container_name: redmine
ports:
- "8080:3000"
environment:
REDMINE_DB_POSTGRES: postgres # хост, на котором расположена база данных Postgres
REDMINE_DB_USERNAME: redmine # имя пользователя для подключения к базе данных Redmine
REDMINE_DB_DATABASE: redminedb # база данных, к которой будет подключаться Redmine
REDMINE_DB_PASSWORD: redmine-password # пароль, который будет использоваться для подключения
depends_on: # обозначаем зависимость запуска сервиса redmine от запуска сервиса postgres
- postgres
rabbitmq:
container_name: rabbitmq
image: rabbitmq:3-management
environment:
RABBITMQ_DEFAULT_USER: rabbit # переопределяем значения имя для пользователя, который создается по умолчанию
RABBITMQ_DEFAULT_PASS: rabbit-password # переопределяем значения пароля для пользователя, который создается по умолчанию
ports:
- "15672:15672" # порт для доступа к веб-интерфейсу
- "5672:5672" # порт для доступа через протокол AMQP к брокеру сообщений

View File

@@ -1,15 +0,0 @@
#!/bin/bash
set -e
# Создаем пользователя redmine и БД redminedb
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USER" --dbname "$POSTGRES_DB" <<-EOSQL
CREATE USER redmine WITH PASSWORD 'redmine-password';
CREATE DATABASE redminedb;
GRANT ALL PRIVILEGES ON DATABASE redminedb TO redmine;
EOSQL
# Даем права на схему public
psql -v ON_ERROR_STOP=1 --username "$POSTGRES_USERNAME" -d redminedb <<-EOSQL
ALTER SCHEMA public OWNER TO redmine;
GRANT ALL ON SCHEMA public TO redmine;
EOSQL

View File

@@ -0,0 +1,42 @@
services: # Начало объявления сервисов
gitea: # Указывается название сервиса
image: gitea/gitea:1.22.2 # Указание названия образа (и/или его версии), который будет взят для создания контейнера
restart: always # Указывается политика перезапуска, в данном случае всегда перезапускать контейнер, если он остановился
environment: # Указываются переменные среды
- GITEA__database__DB_TYPE=postgres # Тип базы данных
- GITEA__database__HOST=postgres:5432 # Хост бд. Название сервиса это а-ля доменное имя и внутри сети разрешается в ip нужного контейнера
- GITEA__database__NAME=gitea # Название базы данных
- GITEA__database__USER=superuser # Пользователь базы данных
- GITEA__database__PASSWD=superpassword # Пароль пользователя базы данных
ports: # Перечисляются пробросы портов на хостовую машину. Слева порт хостовой машины, справа порт контейнера
- "3000:3000" # Web интерфейс
- "222:22" # SSH
volumes: # Указываются монтированные тома, папки, файлы. В данном случае в папку /data монтируется объявленный ниже том gitea
- gitea:/data
depends_on: # Указывается зависимость запуска контейнера от другого сервиса, в данном случае запускается только после запуска сервиса бд
- postgres
# Дальше всё по аналогии, различаются лишь названия, переменные окружения, образы, порты и тома
postgres:
image: postgres:14
restart: always
environment:
- POSTGRES_USER=superuser
- POSTGRES_PASSWORD=superpassword
- POSTGRES_DB=gitea
ports:
- "5432:5432"
volumes:
- postgres:/var/lib/postgresql/data
rabbitmq:
image: rabbitmq:3-management
environment:
RABBITMQ_DEFAULT_USER: superuser
RABBITMQ_DEFAULT_PASS: superpassword
ports:
- "5672:5672"
- "15672:15672"
volumes: # Перечисление томов, которые можно использовать как в одном, так и в нескольких сервисах
postgres:
gitea:

View File

@@ -0,0 +1,25 @@
# Лабораторная работа №1
В рамках данной лабораторной работы будут развёрнуты следующие сервисы:
1. **Gitea** - система управления версиями
2. **Postgres** - реляционая база данных
3. **Rabbitmq** - брокер сообщений
Инструкции к запуску контейнеров и пояснения к ним находятся в файле ```docker-compose.yml```
## Порядок запуска
#### 1. Установить docker или убедиться, что он установлен
#### 2. Перейти в папку с файлом ```docker-compose.yml```
#### 3. Выполнить команду в терминале: ```docker-compose up --build --remove-orphans```
Проверить успешность запуска можно командой ```docker ps -a```. Если всё прошло успешно, то в терминале будет написано:
```
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
1a794331b32b gitea/gitea:1.22.2 "/usr/bin/entrypoint…" 20 seconds ago Up 18 seconds 0.0.0.0:3000->3000/tcp, 0.0.0.0:222->22/tcp polevoy_sergey_lab_1-gitea-1
b5fe33c61c1d rabbitmq:3-management "docker-entrypoint.s…" 20 seconds ago Up 19 seconds 4369/tcp, 5671/tcp, 0.0.0.0:5672->5672/tcp, 15671/tcp, 15691-15692/tcp, 25672/tcp, 0.0.0.0:15672->15672/tcp rabbitmq
3d2db73d15c5 postgres:14 "docker-entrypoint.s…" 20 seconds ago Up 19 seconds 0.0.0.0:5432->5432/tcp polevoy_sergey_lab_1-postgres-1
```
Работать со всеми перечисленными сервисами можно сразу после запуска за исключением **gitea**. После первого запуска необходимо зайти на сервис, выполнить первоначальную настройку и создать суперпользователя.
## Видеодемонстрация работы
### Видео доступно по [ссылке](https://disk.yandex.ru/i/3Out4mUV6NEJuA)