Деплой приложения Gin

Чтобы развернуть приложение, созданное на Gin, перейдите в раздел Apps и кликните на кнопку «Создать».

Пример Gin-приложения для деплоя можно найти на Гитхабе. Также у нас есть туториал с примером развертывания приложения Gin в Apps.

Шаг 1. Выбор приложения

В пункте «Тип» перейдите на вкладку Backend и выберите Go — Gin.

Шаг 2. Репозиторий

Вы можете подключить репозиторий:

• Из своего аккаунта GitHub, GitLab или BitBucket. Кликните на название платформы, авторизуйтесь и выберите нужный репозиторий. Если вы уже авторизованы, панель сразу покажет доступные репозитории.

• По URL, указав ссылку на репозиторий, созданный на любой платформе. Кликните «Подключите git-репозиторий по URL» (либо «Добавить аккаунт» → «Подключите git-репозиторий по URL») и укажите Git URL репозитория. Если репозиторий приватный, введите реквизиты доступа.

Подробнее о подключении репозиториев — здесь.

Шаг 3. Выбор ветки и коммита

1. Выберите ветку для деплоя.

2. По умолчанию мы включаем опцию «Сборка по последнему выполненному коммиту». В этом случае сервис Apps выполнит деплой по самому актуальному коммиту, а в дальнейшем будет автоматически пересобирать приложение при добавлении новых коммитов в репозиторий. 

При необходимости вы сможете отключить автодеплой в дальнейшем.

Если вы хотите выбрать конкретный коммит вручную — отключите эту опцию.

Шаг 4. Выбор сервера

Приложение Gin должно быть развернуто на отдельном облачном сервере. Выберите регион размещения сервера и его конфигурацию. 

В дальнейшем, если потребуется, вы сможете перейти на более мощный тариф.

Шаг 5. Настройка параметров сборки

Сервис автоматически определит команду сборки и директорию сборки для вашего проекта, поэтому в большинстве случаев параметры можно оставить без изменений. Также будут установлены зависимости, определенные в файле go.mod.

Для сборки проекта на Gin мы по умолчанию выполним следующее:

DEBIAN_FRONTEND=noninteractive add-apt-repository -y ppa:longsleep/golang-backports && DEBIAN_FRONTEND=noninteractive apt-get install -y golang-go --fix-missing

Однако, если для работы вашего проекта требуются дополнительные модули, вы можете ввести дополнительные команды сборки (можно объединять команды через &&). Например, если требуется установить определенные драйверы, добавьте в команду сборки:

apt install имя_пакета

На этом этапе вы также можете задать переменные, если это требуется. 

В качестве команды запуска будет использоваться:

go run main.go

Где main.go — основной файла проекта, который инициализирует запуск приложения. Убедитесь, что файл называется именно так.

У вас будет возможность внести изменения в любые из этих параметров в дальнейшем и перезапустить деплой с новыми настройками, если потребуется.

Шаг 6. Деплой

Нажмите «Запустить деплой». Как только процесс начнется, вы увидите лог деплоя на вкладке «Деплой».

Как правило, он содержит всю необходимую информацию для устранения возможных ошибок. Если что-то пойдет не так, например, из-за наличия ошибок в коде, в логе будут выведены уведомления о них с уточнением причины проблемы. 

При первом развертывании проекта установка сервера может занять некоторое время. Как только процесс завершится, статус приложения обновится, а запись о завершении будет выведена в логе.

Готово! Ваш проект развернут и готов к работе.

В дальнейшем Apps будет отслеживать обновления в репозитории и, если включен автодеплой, автоматически перезапускать проект с новыми изменениями.

IP-адрес приложения и бесплатный технический домен, привязанный к нему по умолчанию, можно найти на вкладе «Дашборд». Приложение будет доступно по 443 порту; порт 80 также открыт.

Привязать собственный домен можно по нашей инструкции.