Вайб-кодинг с помощью Foundation Models и подключение MCP-сервера для деплоя приложения в Container Apps

Перед началом работы

1. Подготовьте среду

1. Убедитесь, что у вас есть доступ к Foundation Models.

2. Убедитесь, что баланс в личном кабинете положительный. Если он нулевой или отрицательный — пополните баланс. Небольшое количество запросов в Foundation Models будет стоить не больше рубля, подробнее — в тарифах.

3. Подключите Foundation Models в VS Code.

   Используйте следующие параметры:

   • При создании сервисного аккаунта выберите роль внутри проекта — «Администратор пользователей» для создания контейнеров Container Apps от лица этого сервисного аккаунта в дальнейшем.

   • При создании API-ключа укажите в поле Сервисы значение Foundation Models.

   • В поле Модель в плагине VS Code выберите одну из следующих моделей:

     • zai-org/GLM-4.6

     • Qwen/Qwen3-Coder-480B-A35B-Instruct

     • openai/gpt-oss-120b

     Для решения задач этого руководства рекомендуется использовать модель zai-org/GLM-4.6.

   Чтобы увидеть полное описание моделей и стоимость токенов:

   1. Перейдите в личный кабинет.

   2. Перейдите в раздел AI Factory –> Foundation Models.

   3. В разделе Модели найдите описание, параметры и стоимость токенов для нужной модели.

   Вы можете использовать бесплатные модели, доступные в режиме Public Preview.

2. Подготовьте окружение и создайте приложения с помощью промпта

• Django 5.2.7

• Python 3.13

• База данных SQL Lite

Создай проект под названием «Рекордасьон» (по-английски — Recordacion) с использованием следующих технологий:
- Django 5.2.7
- Python 3.13
- База данных: SQLite

Создай новое виртуальное окружение и размести его в папке .venv

Внутри проекта создай два приложения:

  - recordacion — для основных настроек Django (settings, urls и т.д.) создан через startproject;
  - records — для работы с моделями создан через startapp.

Функционал: Любой пользователь может добавить свой рекорд и просматривать рекорды других.
В приложении records создай модель RecordEntry со следующими полями:

  - название
  - описание
  - картинка для preview
  - картинки (картинок может быть несколько, должна быть связь ManyToMany)
  - поля "Дата создания" и "Дата обновления" (должны заполняться автоматически)
  - модель принята администратором или нет, поле is_approved
  - связь с тем, кто принял рекорд approved_by на django user

• ./recordacion — для хранения основных настроек Django (settings, urls).

• ../records — для хранения модели рекорда.

### Создай проект под названием «Рекордасьон»
(по-английски — Recordacion) с использованием следующих технологий:
- Django 5.2.7
- Python 3.13
- База данных: SQLite

1. Создай новое виртуальное окружение и размести его в папке .venv
2. Внутри проекта создай два приложения:
    recordacion — для основных настроек Django (settings, urls и т.д.) создан через startproject;
    records — для работы с моделями создан через startapp.
    Функционал:
    Любой пользователь может добавить свой рекорд и просматривать рекорды других.
    В приложении records создай модель RecordEntry со следующими полями:
    - название
    - описание
    - картинка для preview
    - картинки (картинок может быть несколько, должна быть связь ManyToMany)
    - поля дата создания и дата обновления (должны заполняться автоматически)
    - модель принята администратором или нет is_approved
    - связь с тем кто принял рекорд approved_by на django user
3. Зарегистрируй модель RecordEntry в админке Django, чтобы можно было управлять записями через интерфейс администратора.
4. Добавь кастомную Django-команду create_admin_user, которая создаёт суперпользователя с логином admin и паролем admin. Если такой пользователь уже существует — команда должна пропустить создание.
5. Версии Python библиотек сохрани в requirements.txt.
6. Создай файл README.md с кратким описанием проекта и пошаговой инструкцией по его запуску (включая активацию виртуального окружения, миграции и запуск сервера).

3. Создайте модель RecordEntry и зарегистрируйте ее в Django-админке с помощью промпта

Зарегистрируй модель RecordEntry в админке Django, чтобы можно было управлять записями через интерфейс администратора.

4. Создайте пользователя admin с помощью промпта

Добавь кастомную Django-команду create_admin_user, которая создаёт суперпользователя с логином admin и паролем admin.
Если такой пользователь уже существует, команда должна пропустить создание.

5. Сохраните версии Python-библиотек и создайте документацию по проекту c помощью промпта

Версии Python библиотек сохрани в requirements.txt

Создай файл README.md с кратким описанием проекта и пошаговой инструкцией по его запуску (включая активацию виртуального окружения, миграции и запуск сервера).

6. Проверьте работоспособность Django-приложения

1. Запустите сервер с помощью команды:

   python manage.py runserver
   
   

2. Используйте адрес 127.0.0.1:8000/admin для проверки работоспособности приложения.

   Отобразится окно входа в панель администратора.

7. Создайте фронтенд-приложение с помощью промпта

### Реализуй три страницы в records.views

1. Главная страница
Маршрут: GET /

Отображает только одобренные (is_approved=True) пользовательские рекорды.
Рекорды упорядочены по возрастанию даты создания — самый новый должен находиться в начале списка.
Для каждого рекорда показывай:
- Название
- Картинку из Preview (если есть)
- Дату создания
Рекорды отображай по 3 на одной строчке.

Добавь фильтр:
- по названию
- выбор сортировки по дате
- добавь пагинацию по 10 рекордов
- кнопку сброса фильтрафии


2. Страница добавления рекорда
Маршрут: GET /records и POST /records

Форма для создания нового RecordEntry с полями:
- Название
- Описание
- Картинка для preview
- Несколько картинок для поста
После успешной отправки формы отобрази сообщение:
«Ваш рекорд успешно добавлен и будет рассмотрен администратором в ближайшее время.»
Не перенаправляй пользователя — просто покажи это сообщение на той же странице.

3. Страница отдельного рекорда
Маршрут: GET /records/<record_id>

Отображает все данные конкретного рекорда:
- Название
- Описание
- Все прикрепленные изображения (без изображения с preview)
- Дату создания

Требования к оформлению всех страниц:
Используй наследование шаблонов (base.html → дочерние шаблоны).
Все стили должны находиться в одном CSS-файле (например, static/css/style.css).

Используй формулу цветов:
60% основной цвет, 30% акцентный цвет, 10% яркий цвет
Цветовая палитра:
Основной акцент - персик/терракота #FFF9F5
Фон - очень светлый кремовый #4B3F72
Текст - мягкий тёмно-фиолетовый #FF6F61
Дополнительно (для UI-состояний):
Hover на кнопке: #FF5C4D (чуть темнее акцента)
Disabled-состояние: #E0D9D0 (светло-бежевый, на фоне кремового)
Тени / разделители: rgba(75, 63, 114, 0.1) — полупрозрачный оттенок основного текстового цвета
Кнопки должны быть одинаковыми по высоте.
Стиль должен быть чистым, современным и напоминать немного сайт Книги рекордов Гиннеса.

8. Проверьте работоспособность фронтенд-приложения

1. Используйте адрес localhost:8000 для проверки работоспособности приложения. Отобразится домашняя страница со строкой поиска рекордов и кнопкой Добавить рекорд.

2. Добавьте запись о рекорде через сайт.

3. Перейдите по адресу 127.0.0.1:8000/admin, войдите с логином и паролем admin/admin и подтвердите добавленную запись.

   

4. Проверьте по адресу localhost:8000, что запись отобразилась в списке рекордов.

9. Заполните админку записями с помощью промпта

1. Скопируйте в репозиторий с проектом папку init-data. Используйте новое контекстное окно модели.

2. Используйте промпт:

   Заполни рекорды (EntryRecords)
   
   Создай django manage.py команду fill_records, которая добавит первые записи Используя данные из prompts/init-data/data.json
   Если рекорд с таким именем уже существует, его можно пропустить.
   
   

3. Запустите итоговую команду.

4. Откройте адрес localhost:8000 и проверьте, что рекорды отображаются.

   

5. При ошибках, например, если не отображаются изображения, в том же контекстном окне AI-модель введите промпт:

   Не работает отображение картинок, поправь
   
   

6. После отработки команды повторно откройте адрес localhost:8000 и проверьте, что рекорды отображаются корректно.

10. Создайте Docker-файл с приложением с помощью промпта

• .dockerignore — чтобы исключить из сборки статичные папки для хранения данных.

• Переменные окружения: ALLOWED_HOSTS, CONTAINER_APP_NAME (заполняется сервисом Container Apps), CSRF_TRUSTED_ORIGINS (необходимо для отправки формы).

• FILE_UPLOAD_PERMISSIONS — настройка, необходимая для подключения в дальнейшем Object Storage.

• Непривилегированный пользователь с UID 1000 для работы в непривилегированном режиме. По умолчанию контейнеры в Container Apps запускаются от имени пользователя с идентификатором (UID) 1000.

• Точка входа, в которой указаны команды при запуске контейнера.

### Создай Docker-образ
на основе официального образа python:3.13.9-bookworm (Debian Bookworm) со следующими требованиями:

1. Зависимости и игнорирование файлов
Добавь файл requirements.txt с необходимыми Python-зависимостями (включая Django 5.2.7).
Создай файл .dockerignore и исключи из сборки:
```
db/
media/
staticfiles/
.venv/
```

2. Расположение базы данных
Настрой проект так, чтобы файл SQLite (db.sqlite3) сохранялся в папке ./db (в корне проекта).
Обнови settings.py, указав путь к базе данных:
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': BASE_DIR / 'db' / 'db.sqlite3',
    }
}

3. Настройки для запуска в Cloud.ru Container Apps
Добавь в settings.py следующие параметры:

```python
import os

CONTAINER_APP_NAME = os.environ.get("CONTAINER_NAME", "-")  # будет установлен средой Cloud.ru Container Apps

ALLOWED_HOSTS = [
    f'{CONTAINER_APP_NAME}.containerapps.ru',
    f'{CONTAINER_APP_NAME}.internal.containers.cloud.ru',
    'localhost',
    '127.0.0.1',
]

CSRF_TRUSTED_ORIGINS = [
    f'https://{CONTAINER_APP_NAME}.containerapps.ru',
    f'https://{CONTAINER_APP_NAME}.internal.containers.cloud.ru',
]

# Django пытается изменить права доступа к загруженным файлам — отключаем это поведение
FILE_UPLOAD_PERMISSIONS = None
```

4. Пользователь и права доступа
В Dockerfile создай непривилегированного пользователя с UID 1000.
Предоставь этому пользователю права на запись в папки:
./db (для базы данных)
./media (для загружаемых изображений)

5. В Dockerfile добавь
RUN python manage.py collectstatic --noinput
ENTRYPOINT entrypoint.sh
в котором:
- запусти миграции
- запусти django команду для создания admin пользователя create_admin_user
- запусти django команду fill_records
CMD добавь запуск runserver

6. Добавь в Readme.md способ запуска приложения через Docker

11. Зарегистрируйте в плагине MCP-сервер для передачи промптов в Container Apps и Artifact Registry

1. Перед началом работы с AI-агентом для взаимодействия с MCP-сервером установите последнюю версию Golang с официального сайта.

2. Выполните команду по установке AI-агента по работе с MCP-сервером:

   go install github.com/Nick1994209/cloudru-containerapps-mcp/cmd/cloudru-containerapps-mcp@latest
   
   

3. Перейдите в сервисный аккаунт, созданный на этапе подготовки среды.

4. Перейдите в раздел Ключи доступа.

5. Нажмите Создать ключ.

6. Скопируйте в надежное место KeyID (логин) и Key Secret (пароль).

7. Скопируйте значения KeyID (логин) и Key Secret (пароль), а также project ID своего проекта в json-файл.

   Вы можете узнать projectId своего проекта, открыв cloud.console.ru:

   https://console.cloud.ru/spa/svp?customerId=&projectId=<***********>
   
   

   Используйте следующий JSON-файл, дополнив своими значениями:

   {
     "mcpServers": {
       "cloudru-containerapps-mcp": {
         "command": "cloudru-containerapps-mcp",
         "args": [],
         "env": {
           "CLOUDRU_KEY_ID": "********",
           "CLOUDRU_KEY_SECRET": "********",
           "CLOUDRU_PROJECT_ID": "********",
         },
         "alwaysAllow": [
           "cloudru_containerapps_description",
           "cloudru_get_containerapp",
           "cloudru_get_list_containerapps",
           "cloudru_start_containerapp",
           "cloudru_get_list_docker_registries"
         ],
         "timeout": 900,
         "disabledTools": []
       }
     }
   }
   
   

8. В плагине, который вы добавили в VS Code на этапе подготовки среды, перейдите в раздел MCP Servers и добавьте json-файл по кнопке Edit Global MCP.

   

   В разделе MCP Servers отобразится добавленный MCP-агент и набор команд.

9. Запустите AI-агент:

   cloudru-containerapps-mcp
   
   

12. Выполните деплой приложения с помощью промпта

1. Последовательно выполните промпты, заменив название реестра на свое значение:

   ### Деплой приложения в Cloud.ru Evolution Container Apps
   
   Выполни MCP команду и создай в Cloud.ru реестр, где будет храниться Docker image с приложением recordacion
   реестр называется = <ваше_название_реестра>
   
   

   Сделай docker build and push в Cloud.ru Artifact Registry используя
   название реестра = <ваше_название_реестра>
   название репозитория = recordacion
   название тэга = v0.0.1
   
   

   Убедитесь, что в личном кабинете в сервисе Artifact Registry отображается реестр с указанным именем и в нем содержится репозиторий recordacion.

2. Выполните промпт для создания контейнерного приложения:

   Создай ContainerApps используя
   название контейнер аппа = recordacion
   докер образ возьми из предыдущего шага
   включи автодеплой, тэг паттерн "*"
   установи время простоя в 30 минут
   включи автодеплой, тэг паттерн "*"
   cpu = 0.5
   
   

   Если название recordacion уже занято, укажите ваше название.

   Убедитесь, что в личном кабинете в сервисе Container Apps отображается контейнерное приложение <ваше_название_контейнерного_приложения> и статус ревизии изменился на «Выполняется».

3. Не меняя контекстное окно, используйте промпт:

   Получи публичный адрес приложения
   
   

   Получи логи приложения
   
   

   Если команда не вернула логи или публичный URL-адрес приложения, попробуйте ещё раз спустя 10–15 секунд.

   Так как включена опция Автоматическое развертывание, при каждой загрузке в Artifact Registry новой версии образа (например, с помощью промпта) на стороне Container Apps будет автоматически создаваться новая ревизия контейнера на базе обновленной версии образа.

13. Проверьте работоспособность приложения в Container Apps

14. Создайте бакеты в Object Storage для хранения данных

1. Создайте бакеты в Object Storage, как описано в Шаге 7 практического руководства по развертыванию django-приложения.

   Используйте следующие пути для монтирования

   • /app/db — для тома базы данных;

   • /app/media — для тома загружаемых изображений.

   

2. Примонтируйте созданные бакеты, как указано в Шаге 8 практического руководства по развертыванию django-приложения.

   Теперь при каждом новом деплое Django-приложения данные не будут теряться, сохраняясь в постоянных томах Object Storage.

15. (Опционально) Синхронизируйте файлы из БД с папкой, смонтированной для контейнера, с помощью промпта

1. Используйте промпт:

   ### Добавь синхронизацию db файлов из одной папки в другую
   
   1. добавь скрипт background-sync-folders.sh
   ```bash
   #!/bin/bash
   
   # === Проверка аргументов ===
   if [ "$#" -ne 2 ]; then
       echo "Передан только 1 или меньше аргументов, скрипт не будет синхронизировать данные"
       echo "Использование: $0 <SOURCE_DIR> <TARGET_DIR>"
       exit 0
   fi
   
   SOURCE_DIR="$1"
   TARGET_DIR="$2"
   
   # === Вспомогательная функция: есть ли обычные файлы в директории? ===
   has_files() {
       local dir="$1"
       [ -d "$dir" ] || return 1
       for f in "$dir"/*; do
           [ -e "$f" ] && [ -f "$f" ] && return 0
       done
       return 1
   }
   
   # === Функция однократной синхронизации: SOURCE → TARGET ===
   sync_once() {
       local src="$1"
       local tgt="$2"
       for f in "$src"/*; do
           [ -e "$f" ] || continue
           if [ -f "$f" ]; then
               cp "$f" "$tgt/"
           fi
       done
   }
   
   # === Инициализация ===
   mkdir -p "$SOURCE_DIR" "$TARGET_DIR"
   
   if ! has_files "$SOURCE_DIR"; then
       if has_files "$TARGET_DIR"; then
           echo "SOURCE_DIR=$SOURCE_DIR пуста — копирую из TARGET_DIR=$TARGET_DIR..."
           sync_once "$TARGET_DIR" "$SOURCE_DIR"
           echo "Данные в SOURCE_DIR=$SOURCE_DIR восстановлены."
       else
           echo "Обе директории пусты."
       fi
   else
       echo "SOURCE_DIR=$SOURCE_DIR содержит данные — используем как источник."
   fi
   
   # === Запуск бесконечной синхронизации в фоне ===
   (
       while true; do
           sync_once "$SOURCE_DIR" "$TARGET_DIR"
           sleep 5
       done
   ) &
   
   echo "Скрипт завершил инициализацию. Синхронизация запущена в фоновом режиме: файлы копируются каждые 5 секунд из SOURCE_DIR=$SOURCE_DIR в TARGET_DIR=$TARGET_DIR."
   ```
   Добавьте этот скрипт в ./entrypoint.sh и запустите его до выполнения миграций: `./entrypoint.sh /app/db "$MOUNTED_DB_FOLDER"`
   
   Также включите в ./entrypoint.sh проверку: если директория /app/db/ пуста или не содержит файлов, автоматически выполните следующие Django-команды:
   - migrate
   - create_admin_user
   - fill_records
   
   После создания скрипта background-sync-folders.sh и правок в ./entrypoint.sh
   Выполни docker build and push в Cloud.ru Artifact Registry используя
   название реестра = <ваше_название_реестра>
   название репозитория = recordacion
   название тэга = v0.0.2
   
   

   Где <ваше_название_реестра> — название реестра, заданное на Шаге 12.

2. Создайте новую ревизию контейнера, изменив следующие параметры:

   • добавьте переменную MOUNTED_DB_FOLDER=/synced/db;

     

   • в подключенном бакете замените путь до бакета с базой данных с /app/db на /synced/db.

     

Результат

• подключать Foundation Models в VS Code;

• вайб-кодить Django-приложение для публикации фотографий с помощью промптов к Foundation Models;

• использовать Foundation Models для отладки и тестирования приложений в VS Code;

• подключать MCP-сервер для автоматизации сборки и публикации Docker-образа приложения в Artifact Registry

• с помощью AI-агента обращаться к MCP-серверу, чтобы деплоить контейнерное приложение в Container Apps одной командой;

• добавлять постоянный том Object Storage, который позволяет сохранить ваши данные, когда запросы к приложению не поступают;

• синхронизировать временную базу данных с томом Object Storage при работе контейнерного приложения.