Добавление комментариев и readme

Reviewed-on: Alexey/DAS_2024_1#9

kashin_maxim_lab_2/.gitignore

@@ -0,0 +1 @@
+var/

kashin_maxim_lab_2/README.md

@@ -0,0 +1,60 @@
+# Кашин Максим ПИбд-42
+
+## Описание
+
+Этот проект состоит из трех отдельных программ, каждая из которых находится в своей папке (`program_0`, `program_1`, `program_2`). Каждая программа запускается в отдельном Docker-контейнере и взаимодействует с другими через общие директории, примонтированные как тома (volumes). Для управления контейнерами используется `docker-compose`.
+
+### Основная структура:
+- **program_0**: выполняет подготовку для выполнение задач (генерация файлов) и сохраняет результат в директорию `./var/data`.
+- **program_1**: использует данные из `./var/data`, генерируемые `program_0`, обрабатывает их и сохраняет результат в `./var/result`.
+- **program_2**: берет результаты из `./var/result`, созданные `program_1`, и выполняет заключительную часть обработки и сохраняет результат в `./var/result`.
+
+
+### Шаги для запуска
+
+1. **Запуск всех сервисов:**
+
+    Для запуска всех программ с помощью Docker Compose, выполните следующую команду:
+
+    ```bash
+    docker-compose up --build
+    ```
+
+    Это создаст и запустит все три программы в последовательности.
+
+2. **Работа с томами:**
+
+    Проект использует два общих тома для обмена данными между программами:
+    
+    - `/var/data`: программа `program_0` сохраняет туда свои данные, которые потом читает `program_1`.
+    - `/var/result`: программа `program_1` сохраняет результаты обработки, которые затем используются в `program_2`.
+
+3. **Остановка сервисов:**
+
+    Для остановки всех контейнеров выполните команду:
+
+    ```bash
+    docker-compose down
+    ```
+
+## Структура проекта
+
+- **program_0/**: 
+  - `main.py`: основной код для первой программы (генерация файлов).
+  - `Dockerfile`: инструкция по созданию Docker-образа для `program_0`.
+
+- **program_1/**: 
+  - `main.py`: основной код для второй программы (Скрипт на задание 1.3 - Формирует файл /var/result/data.txt так, что каждая строка файла - количество строк в файлах из каталога /var/data.)
+  - `Dockerfile`: инструкция по созданию Docker-образа для `program_1`.
+
+- **program_2/**: 
+  - `main.py`: основной код для третьей программы (Скрипт на задание 2.1 - Ищет набольшее число из файла /var/result/data.txt и сохраняет его вторую степень в /var/result/result.txt.)
+  - `Dockerfile`: инструкция по созданию Docker-образа для `program_2`.
+
+- **docker-compose.yml**: конфигурация для Docker Compose, описывающая, как собирать и запускать все контейнеры, а также тома, которые они используют.
+
+- **.gitignore**: файл для исключения директории `var/` (временных данных и результатов).
+
+### Видео-отчёт
+
+- [Видео отчёт Кашин Максим ПИбд-42](https://disk.yandex.ru/i/NGZD2HkmZkIBww)

kashin_maxim_lab_2/docker-compose.yml

@@ -0,0 +1,24 @@
+services:
+
+  program_0:
+    build: 
+      context: ./program_0  # Контекст сборки для контейнера program_0, указывающий на папку с Dockerfile
+    volumes:
+      - ./var/data:/data  # Монтирование локальной директории ./var/data в контейнер по пути /data
+
+  program_1:
+    build: 
+      context: ./program_1  # Контекст сборки для контейнера program_1, указывающий на папку с Dockerfile
+    volumes:
+      - ./var/data:/data  # Монтирование локальной директории ./var/data в контейнер по пути /data
+      - ./var/result:/result  # Монтирование локальной директории ./var/result в контейнер по пути /result
+    depends_on:
+      - program_0  # Зависимость от program_0; program_1 не будет запущен до завершения program_0
+
+  program_2:
+    build: 
+      context: ./program_2  # Контекст сборки для контейнера program_2, указывающий на папку с Dockerfile
+    volumes:
+       - ./var/result:/result  # Монтирование локальной директории ./var/result в контейнер по пути /result
+    depends_on:
+      - program_1  # Зависимость от program_1; program_2 не будет запущен до завершения program_1

kashin_maxim_lab_2/program_0/Dockerfile

@@ -0,0 +1,11 @@
+# Используем базовый образ Python версии 3.12 с минимальным размером
+FROM python:3.12-slim
+
+# Устанавливаем рабочую директорию внутри контейнера
+WORKDIR /program_0
+
+# Копируем файл main.py из локальной файловой системы в рабочую директорию контейнера
+COPY main.py /program_0/
+
+# Определяем команду, которая будет выполняться при запуске контейнера
+CMD ["python", "main.py"]

kashin_maxim_lab_2/program_0/main.py

@@ -0,0 +1,53 @@
+import random
+import os
+
+# Путь к папке, где будут создаваться файлы
+folder_path = '/data'
+
+# Функция для создания папки, если она не существует
+def creat_folder():
+    if not os.path.exists(folder_path):
+        os.makedirs(folder_path)  
+        print(f"Папка `{folder_path}` создана!")
+    else:
+        print(f"Папка `{folder_path}` уже существует!")
+
+# Функция для удаления всех файлов в папке
+def delete_files_in_folder():
+    for filename in os.listdir(folder_path):
+        file_path = os.path.join(folder_path, filename)
+        try:
+            if os.path.isfile(file_path):
+                os.remove(file_path) 
+                print(f"Файл `{file_path}` удален.")
+        except Exception as e:
+            print(f'Ошибка при удалении файла {file_path}. {e}')
+
+# Функция для создания файлов с случайными данными
+def creat_file():
+    # Создаем случайное количество файлов (от 10 до 20)
+    for i in range(random.randrange(10, 20)):
+        file = open(f'{folder_path}/file_{i}.txt', 'w+')
+        print(f"Создан файл: {folder_path}/file_{i}.txt")
+        # Заполняем файл случайным количеством строк (от 10 до 50)
+        for i in range(random.randrange(10, 50)):
+            file.write(f'{create_lines()} \n')  # Записываем строку данных в файл
+        file.close()
+
+# Функция для создания случайных числовых строк
+def create_lines():
+    # Создаем список случайных чисел
+    lines = [i for i in range(random.randrange(1, 50), random.randrange(50, 100), random.randrange(1, 10))]
+    return lines
+
+# Основная логика: проверка существования папки и выполнение операций
+if os.path.exists(folder_path):
+    print(f"Папка `{folder_path}` существует, удаляем старые файлы...")
+    delete_files_in_folder()
+    creat_file()
+else:
+    print(f"Папка `{folder_path}` не существует, создаем...")
+    creat_folder()
+    creat_file()
+
+print("Скрипт на создание файлов выполнен.")

kashin_maxim_lab_2/program_1/Dockerfile

@@ -0,0 +1,11 @@
+# Используем базовый образ Python версии 3.12 с минимальным размером
+FROM python:3.12-slim
+
+# Устанавливаем рабочую директорию внутри контейнера
+WORKDIR /program_1
+
+# Копируем файл main.py из локальной файловой системы в рабочую директорию контейнера
+COPY main.py /program_1/
+
+# Определяем команду, которая будет выполняться при запуске контейнера
+CMD ["python", "main.py"]

kashin_maxim_lab_2/program_1/main.py

@@ -0,0 +1,58 @@
+from pathlib import Path
+import os
+
+# Путь к папке, где будут создаваться файлы
+folder_path = '/result'
+# Путь к папке, где созданы файлы
+folder_generator = '/data'
+
+# Функция для создания папки, если она не существует
+def creat_folder():
+    if not os.path.exists(folder_path):
+        os.makedirs(folder_path)
+        print(f"Папка `{folder_path}` создана!")
+    else:
+        print(f"Папка `{folder_path}` уже существует!")
+
+# Функция для удаления всех файлов в папке
+def delete_files_in_folder():
+    for filename in os.listdir(folder_path):
+        file_path = os.path.join(folder_path, filename)
+        try:
+            if os.path.isfile(file_path):
+                os.remove(file_path)
+                print(f"Файл `{file_path}` удален.")
+        except Exception as e:
+            print(f'Ошибка при удалении файла {file_path}. {e}')
+
+# Функция для создания файлов
+def creat_file():
+    file = open(f'{folder_path}/data.txt', 'w+')
+    print(f"Создан файл: {folder_path}/data.txt")
+    for count in files_count():
+        file.write(f'{count} \n')
+    file.close()
+
+# Функция для подсчета количества строк в файлах
+def files_count():
+    files = []
+    files_count = []
+    files += os.listdir(folder_generator)
+    for file in files:
+        line_count = sum(1 for line in open(folder_generator + '/' + file))
+        files_count.append(line_count)
+        print(f"Файл {file} имеет {line_count} количество строк")
+    return files_count
+
+
+# Основная логика: проверка существования папки и выполнение операций
+if os.path.exists(folder_path):
+    print(f"Папка `{folder_path}` существует, удаляем старые файлы...")
+    delete_files_in_folder()
+    creat_file()
+else:
+    print(f"Папка `{folder_path}` не существует, создаем...")
+    creat_folder()
+    creat_file()
+
+print("Скрипт на задание 1.3 (Формирует файл /var/result/data.txt так, что каждая строка файла - количество строк в файлах из каталога /var/data.) выполнен.")

kashin_maxim_lab_2/program_2/Dockerfile

@@ -0,0 +1,11 @@
+# Используем базовый образ Python версии 3.12 с минимальным размером
+FROM python:3.12-slim
+
+# Устанавливаем рабочую директорию внутри контейнера
+WORKDIR /program_2
+
+# Копируем файл main.py из локальной файловой системы в рабочую директорию контейнера
+COPY main.py /program_2/
+
+# Определяем команду, которая будет выполняться при запуске контейнера
+CMD ["python", "main.py"]

kashin_maxim_lab_2/program_2/main.py

@@ -0,0 +1,53 @@
+from pathlib import Path
+import os
+
+# Путь к папке, где будут создаваться файлы
+folder_path = '/result'
+
+# Функция для создания папки, если она не существует
+def creat_folder():
+    if not os.path.exists(folder_path):
+        os.makedirs(folder_path)
+        print(f"Папка `{folder_path}` создана!")
+    else:
+        print(f"Папка `{folder_path}` уже существует!")
+
+# Функция для удаления всех файлов в папке
+def delete_files_in_folder():
+    for filename in 'result.txt':
+        file_path = os.path.join(folder_path, filename)
+        try:
+            if os.path.isfile(file_path):
+                os.remove(file_path)
+                print(f"Файл `{file_path}` удален.")
+        except Exception as e:
+            print(f'Ошибка при удалении файла {file_path}. {e}')
+
+# Функция для создания файлов
+def creat_file():
+    file = open(f'{folder_path}/result.txt', 'w+')
+    print(f"Создан файл: {folder_path}/result.txt")
+    file.write(f'{max_nubmer_file()**2}')
+    print(f"Максимальное число: {max_nubmer_file()}")
+    print(f"Максимальное число в степени 2: {max_nubmer_file()**2}")
+    file.close()
+
+# Функция для посчёта максимального числа в файле
+def max_nubmer_file():
+    max_number = 0
+    for line in open(f'{folder_path}/data.txt'):
+        if int(line) > max_number:
+            max_number = int(line)
+    return max_number
+
+# Основная логика: проверка существования папки и выполнение операций
+if os.path.exists(folder_path):
+    print(f"Папка `{folder_path}` существует, удаляем старые файлы...")
+    delete_files_in_folder()
+    creat_file()
+else:
+    print(f"Папка `{folder_path}` не существует, создаем...")
+    creat_folder()
+    creat_file()
+
+print("Скрипт на задание 2.1 (Ищет набольшее число из файла /var/result/data.txt и сохраняет его вторую степень в /var/result/result.txt.) выполнен.")

yakovleva_julia_lab_1/README.md

@@ -0,0 +1,50 @@
+# Отчет по лабораторной работе 1
+
+## Описание
+Docker Compose используется для одновременного управления несколькими контейнерами, входящими в состав приложения. Он позволяет хранить все настройки проекта в одном контейнере, что позволяет потом беспроблемно использовать те же настройки проекта на другом сервере. docker-compose.yml позволяет настраивать и документировать все зависимости служб приложения. В нем указываются образ, порт(который можно пробросить), окрущающие среды, томы и зависимости (если нужно). 
+
+## Описание docker-compose.yml
+Были выбраны следующие сервисы:
+
+1. Postgres
+2. Redmine
+3. Gitea
+
+В файле у каждого сервиса пробрасывается порт. Каждый сервис содержит том, который используются для хранения данных. Запуск Redmine и Gitea имеют зависимость от Postgres, чтобы они имели возможность накатить миграции и заполнить таблицы после создания базы. У каждого сервиса заполнен паарметр environment, где указываются данные для БД. 
+
+## Инструкция по запуску
+
+1. Запустить приложение Docker Hub
+2. Открыть консоль с помощью команды cd перейти к папке, где находится файл docker-compose.yml
+3. Ввести команду для поднятия контейнеров
+```
+docker compose up -d
+```
+Дожидаемся запуска сервисов:
+```
+[+] Running 3/3
+ ✔ Container yakovleva_julia_lab_1-postgres-1  Started                                                             0.5s
+ ✔ Container yakovleva_julia_lab_1-gitea-1     Started                                                             1.2s
+ ✔ Container yakovleva_julia_lab_1-redmine-1   Started                                                             1.1s
+```
+
+4. Убедиться, что сервисы успешно запущены можно по команде:
+```
+docker compose ps
+```
+Отобразится таблица с запущенными сервисами:
+```
+NAME                               IMAGE                COMMAND                  SERVICE    CREATED          STATUS         PORTS
+yakovleva_julia_lab_1-gitea-1      gitea/gitea:1.22.2   "/usr/bin/entrypoint…"   gitea      19 minutes ago   Up 6 seconds   22/tcp, 0.0.0.0:3002->3000/tcp
+yakovleva_julia_lab_1-postgres-1   postgres:16.4        "docker-entrypoint.s…"   postgres   19 minutes ago   Up 6 seconds   0.0.0.0:5433->5432/tcp
+yakovleva_julia_lab_1-redmine-1    redmine:latest       "/docker-entrypoint.…"   redmine    19 minutes ago   Up 6 seconds   0.0.0.0:3003->3000/tcp
+```
+
+Также можно посомтреть логи каждого севриса при вводе команды:
+```
+docker compose logs -ft (название сервиса)
+```
+-ft необходим для того, чтобы читать логи сервиса в реальном времени 
+
+## Видео
+[Видео](https://disk.yandex.ru/i/Ds2f4xO8vQ8XPA) работоспособности.

yakovleva_julia_lab_1/docker-compose.yml

@@ -0,0 +1,45 @@
+services:
+  postgres:
+    image: postgres:16.4
+    ports:
+      - "5433:5432"
+    environment:
+      POSTGRES_USER: redmine
+      POSTGRES_PASSWORD: redminepass
+      POSTGRES_DB: redmine
+    volumes:
+      - ./postgres_data:/var/lib/postgresql/data  # Volume для хранения данных PostgreSQL
+    restart: always
+
+  redmine:
+    image: redmine:latest
+    ports:
+      - "3003:3000"
+    volumes:
+      - ./redmine_data:/usr/src/redmine/files  # Volume для хранения данных Redmine
+    environment:
+      REDMINE_DB_POSTGRES: postgres  # Имя сервиса базы данных
+      REDMINE_DB_USERNAME: redmine
+      REDMINE_DB_PASSWORD: redminepass
+      REDMINE_DB_DATABASE: redmine
+    depends_on:
+      - postgres
+    restart: always
+
+  gitea:
+    image: gitea/gitea:1.22.2
+    ports:
+      - "3002:3000"  # Проброс порта для доступа к Gitea
+    volumes:
+      - ./gitea_data:/data  # Volume для хранения данных Gitea
+    environment:
+      - USER_UID=1000
+      - USER_GID=1000
+      - GITEA__database__DB_TYPE=postgres
+      - GITEA__database__HOST=postgres:5432
+      - GITEA__database__NAME=gitea
+      - GITEA__database__USER=gitea
+      - GITEA__database__PASSWD=gitea_password
+    depends_on:
+      - postgres
+    restart: always