{"id":20645042,"url":"https://github.com/romanow/openshift-homework1","last_synced_at":"2025-04-16T02:10:50.670Z","repository":{"id":37682881,"uuid":"402430947","full_name":"Romanow/openshift-homework1","owner":"Romanow","description":null,"archived":false,"fork":false,"pushed_at":"2022-08-24T09:40:54.000Z","size":11,"stargazers_count":2,"open_issues_count":13,"forks_count":35,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-29T04:02:28.635Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Romanow.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-09-02T13:28:52.000Z","updated_at":"2023-02-25T19:14:30.000Z","dependencies_parsed_at":"2022-09-15T10:02:20.887Z","dependency_job_id":null,"html_url":"https://github.com/Romanow/openshift-homework1","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Romanow%2Fopenshift-homework1","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Romanow%2Fopenshift-homework1/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Romanow%2Fopenshift-homework1/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Romanow%2Fopenshift-homework1/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Romanow","download_url":"https://codeload.github.com/Romanow/openshift-homework1/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249183106,"owners_count":21226142,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-16T16:18:31.247Z","updated_at":"2025-04-16T02:10:50.646Z","avatar_url":"https://github.com/Romanow.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Домашнее задание #1: Docker\n\n## Формулировка\n\nВ рамках первого домашнего задания, требуется для приложения TODO List собрать backend и frontend части и запустить их в\ndocker.\n\n* Приложение реализует простейший TODO list:\n    * добавить заметку;\n    * удалить заметку;\n    * вывести все заметки.\n* Backend написан на `Kotlin` + `Spring`, frontend написан на `Typescript` + `React/Redux`.\n* Backend запускается на порту 8080, профиль `docker`.\n* Backend для хранения данных использует PostgreSQL 13.\n* Frontend мапится наружу на порт 3000, запросы к backend пробрасываются через `proxy_pass http://backend-service:8080`.\n\n## Требования\n\n* Для успешного выполнения задания нужно установить на host машину:\n    * git;\n    * OpenJDK 11;\n    * Docker.\n* Код backend'а и frontend'а хранится в отдельных репозиториях, они подключаются через Git Modules.\n* Нужно реализовать двухэтапную сборку приложений, сборку контейнеров описать в\n  файлах [backend.Dockerfile](backend.Dockerfile) и [frontend.Dockerfile](frontend.Dockerfile).\n* В файле [test.sh](test.sh) дописать необходимые шаги:\n    * `createNetworks`;\n    * `createVolume`;\n    * `runPostgres`;\n    * `runBackend`;\n    * `runFrontend`.\n* Для хранения данных в Postgres нужно создать Volume.\n* Внешний маппинг портов:\n    * backend 8080:8080;\n    * frontend 3000:80.\n* Нужно создать две _разных_ сети (`driver=bridge`):\n    * для взаимодействия между backend и PostgreSQL;\n    * для взаимодействия backend и frontend (для этой сети указать alias для контейнера backend `backend-service`, т.к.\n      nginx обращается через proxy_pass к `http://backend-service:8080`).\n* Docker compose использовать нельзя, все ресурсы описываются через docker.\n* Контейнеры называть `backend`, `frontend`, `postgres`.\n* В результате реализации всех описанных выше шагов, должна быть возможность работать TODO list с `localhost:3000`, т.е.\n  можно открыть страницу в браузере и проверить работу.\n* Для автоматизированной проверки работоспособности выполняется запрос из контейнера frontend в контейнер backend по\n  имени сервиса.\n\n## Пояснения\n\n* Для сборки затяните `backend-todo-list` и `backend-todo-list` с помощью\n  команды `git submodule update --init --recursive`.\n* Backend нужно запустить с профилем `docker`. Для этого требуется внутрь контейнера пробросить переменную\n  среды `SPRING_PROFILES_ACTIVE=docker`.\n* Для очистки ресурсов можно использовать [cleanup.sh](cleanup.sh), он удаляет контейнеры, сети, volumes.\n* Для backend нужно в Postgres создать БД `todo_list` и пользователя `program`:`test`. Здесь можно использовать два\n  варианта решения:\n    * Можно создать пользователя и БД с помощью переменных среды `POSTGRES_*` при старте\n      контейнера [Postgres](https://hub.docker.com/_/postgres). Это рабочий вариант, но созданный пользователь будет\n      иметь права SUPERUSER, что плохо с точки зрения безопасности.\n    * Обычно для работы с приложением создают отдельного пользователя. В образе Postgres есть возможность использовать\n      скрипты инициализации для _первого страта контейнера_ (блок Initialization scripts\n      в [документации](https://hub.docker.com/_/postgres)). В backend есть пример такого запуска контейнера Postgres с\n      помощью [docker-compose.yml](backend/docker-compose.yml): при старте контейнера создается пользователь с правами\n      SUPERUSER, а в `10-create-user-and-db.sql` создается отдельная БД и пользователь для нее. Это нужно, чтобы\n      программа работала с пользателем, ограниченным в правах.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromanow%2Fopenshift-homework1","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fromanow%2Fopenshift-homework1","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fromanow%2Fopenshift-homework1/lists"}