Подключение к существующему репозиторию
Если у вас уже есть приложение, которое вы хотите развернуть в Amvera, но оно уже использует другой репозиторий git (GitHub, Bitbucket или что-то другое), можно привязать дополнительный remote к вашему репозиторию.
Если вы не знакомы с принципом работы с Git, рекомендуем ознакомиться со статьей. Она позволит вам понять, как создавать Git-репозиторий и вносить в него изменения, что упростит работу с нашим сервисом.
Инструкции по подключению указаны на странице проекта.
Откройте командную строку и перейдите в корневую папку проекта вашего приложения. Выполните указанные команды:
git remote add amvera https://git.amvera.ru/<имя-пользователя>/<транслитерированное-имя-проекта>
git push amvera master
На запрос пользователя и пароля укажите имя пользователя и пароль вашей учетной записи Amvera.
Чтобы началась сборка, у вас должен быть файл amvera.yml или amvera.yaml и/или Dockerfile в одном из следующих мест относительно корня вашего репозитория:
- amvera/Dockerfile
- Dockerfile
- docker/Dockerfile
- deploy/Dockerfile
- deployment/Dockerfile
Если amvera.yml и/или Dockerfile не найден ни в одном из указанных мест, сборка не удастся.
За процессом сборки можно наблюдать на странице проекта на вкладке логов сборки:
В случае успешного развертывания вы увидите статус "Успешно развернуто":
В случае, если во время сборки произошла ошибка, вы увидите статус "Сборка завершилась с ошибкой".
Причину ошибки обычно можно найти в логах сборки.
Запущенные инстансы вашего проекта при ошибке сборки не останавливаются и продолжат работать.
Пример порядка команд
- Вызываем терминал в IDE, где открыто приложение, или открываем папку проекта в терминале.
- Инициализируем локальный гит репозиторий командой (если он не инициализирован)
git init
- Добавим удаленный репозиторий нашего проекта (url вашего репозитория будет отличаться. Во избежание синтаксических ошибок скопируйте ссылку на втором шаге создания проекта)
git remote add amvera https://git.amvera.ru/Ваш_Ник/Имя_проекта
Важно:
Если вы задавали конфигурацию в интерфейсе, не забудьте сделать git pull (git pull amvera master) для синхронизации репозиториев. Если вы не хотите синхронизировать репозитории, то создайте yaml по ссылке, добавьте его в корень репозитория перед певым push. При этом не добавляйте/задавайте конфигурацию в интерфейсе. Задание конфигурации и добавление файлов в интерфейсе создает коммит, после которого нужно синхронизировать репозитории при работе через git.
- Добавим файлы и сделаем первый коммит.
git add .
git commit -m ‘init’
- Запушим наш код в репозиторий проекта
git push amvera master
- Когда вы хотите сделать обновление проекта (вы обновили код/конфигурацию/зависимости), выполните команды:
git add .
git commit -m "Описание сделанных изменений"
git push amvera master
Возможные ошибки
Если у вас основная ветка называется не master, а, например, main, при выполнении команды git push amvera master вы столкнетесь с ошибкой.
В таком случае выполните команду:
git push amvera имя_основной_ветки:master
Так, например, если ваша основная ветка называется main, команда будет выглядеть следующим образом:
git push amvera main:master
Если вы не знаете как называется основная ветка в вашем репозитории, узнать это можно, выполнив следующую команду (если вы не знаете как называется ваша основная ветка, вы скорее всего на ней находитесь):
git branch --show-current