Социальная сеть для любителей Кулинарии: «Foodgram»

Описание

«Продуктовый помощник» (Проект Яндекс.Практикум) Сайт является - базой кулинарных рецептов. Пользователи могут создавать свои рецепты, читать рецепты других пользователей, подписываться на интересных авторов, добавлять лучшие рецепты в избранное, а также создавать список покупок и загружать его в txt формате. Также присутствует файл docker-compose, позволяющий, быстро развернуть контейнер базы данных (PostgreSQL), контейнер проекта django + gunicorn и контейнер nginx.

Стек технологий

Kак запустить

Клонируем проект:

git clone https://github.com/94R1K/foodgram-project-react.git

Для добавления файла .env с настройками базы данных на сервер необходимо:

Установить соединение с сервером по протоколу ssh:

ssh username@server_address

Где username - имя пользователя, под которым будет выполнено подключение к серверу. server_address - IP-адрес сервера или доменное имя.

Например:

ssh [email protected]

В домашней директории проекта создать папку app/:

mkdir app

В ней создать папку fodgram-project/:

mkdir app/foodgram-project

В ней создать файл .env:

sudo touch app/foodgram-project/.env

Выполнить следующую команду:

sudo nano app/foodgram-project/.env

Пример добавляемых настроек:

• DB_ENGINE=django.db.backends.postgresql
• DB_NAME=postgres
• POSTGRES_USER=postgres
• POSTGRES_PASSWORD=postgres
• DB_HOST=postgres
• DB_PORT=5432

Также необходимо добавить Action secrets в репозитории на GitHub в разделе settings -> Secrets:

• DOCKER_PASSWORD - пароль от DockerHub;
• DOCKER_USERNAME - имя пользователя на DockerHub;
• HOST - ip-адрес сервера;
• SSH_KEY - приватный ssh ключ (публичный должен быть на сервере).

Опционально:

• TELEGRAM_TO - id своего телеграм-аккаунта (можно узнать у @userinfobot, команда /start)
• TELEGRAM_TOKEN - токен бота (получить токен можно у @BotFather, /token, имя бота)

Проверка работоспособности

Теперь если внести любые изменения в проект и выполнить:

git add .
git commit -m "..."
git push

Команда git push является триггером workflow проекта.
При выполнении команды git push запустится набор блоков команд jobs.

Последовательно будут выполнены следующие блоки:

tests - тестирование проекта на соответствие PEP8 и тестам pytest.

build_and_push_to_docker_hub - при успешном прохождении тестов собирается образ (image) для docker контейнера и отправлятеся в DockerHub

deploy - после отправки образа на DockerHub начинается деплой проекта на сервере. Происходит копирование следующих файлов с репозитория на сервер:

docker-compose.yaml, необходимый для сборки трех контейнеров:

• postgres - контейнер базы данных;
• web - контейнер Django приложения + wsgi-сервер gunicorn;
• nginx - веб-сервер.

nginx/default.conf - файл кофигурации nginx сервера

static_backend/ - папка со статическими файлами проекта

После копирования, происходит установка docker и docker-compose на сервере и начинается сборка и запуск контейнеров.

send_message - после сборки и запуска контейнеров происходит отправка сообщения в телеграм об успешном окончании workflow.

После выполнения вышеуказанных процедур необходимо установить соединение с сервером:

ssh username@server_address

Отобразить список работающих контейнеров:

sudo docker container ls

В списке контейнеров копировать CONTAINER ID контейнера username/foodgram-backend:latest (username - имя пользователя на DockerHub):

CONTAINER ID	IMAGE	COMMAND	CREATED	STATUS	PORTS	NAMES
8021345d9138	nginx:1.19.3	"/docker-entrypoint.…"	7 minutes ago	Exited (0) 2 minutes ago		username_nginx_1
d3eb395676c6	username/foodgram_backend:latest	"/entrypoint.sh /bin…"	7 minutes ago	Exited (137) 2 minutes ago		username_backend_1
2a0bf05071ba	postgres:12.4	"docker-entrypoint.s…"	8 minutes ago	Exited (137) 2 minutes ago		dfadeev-zld_db_1
7caa47e8ad7e	username/foodgram_frontend:v1.0	"docker-entrypoint.s…"	8 minutes ago	Exited (0) 7 minutes ago		username_frontend_1

Выполнить создание суперпользователя:

sudo docker exec -it d3eb395676c6 python manage.py createsuperuser

Для остановки и удаления контейнеров и образов на сервере:

sudo docker stop $(sudo docker ps -a -q) && sudo docker rm $(sudo docker ps -a -q) && sudo docker rmi $(sudo docker images -q)

Об авторе

Лошкарев Ярослав Эдуардович
Python-разработчик (Backend)
Россия, г. Москва
E-mail: [email protected]