Сайты и приложения

Как выложить Go-приложение в интернет

· 3 мин чтения

Коротко

Чтобы выложить Go-приложение в интернет, загрузите исходный код с файлом go.mod и слушайте порт из переменной окружения PORT — бинарь собирать самому не нужно. Netrun определяет Go по go.mod, сам скачивает зависимости, собирает проект и выдает ссылку с HTTPS. Ключи и строку подключения к базе приложение читает через os.Getenv из секретов, которые задаются в кабинете.

  • Файл go.mod в корне проекта сообщает Netrun, что это Go-приложение, и перечисляет зависимости для сборки.
  • Go-сервис должен слушать порт из переменной окружения PORT, который читается через os.Getenv("PORT").
  • Адрес вида ":"+port в Go означает «слушать на всех адресах», а сервер на "127.0.0.1" снаружи недоступен.
  • Собирать бинарь локально и ставить Go на сервер не нужно: Netrun собирает проект из исходников сам.
  • Секреты Netrun хранит зашифрованными и передает приложению как переменные окружения.

Обычно, чтобы показать миру Go-приложение, нужно арендовать сервер, собрать на нем бинарь, поставить рядом nginx как прокси, получить SSL-сертификат и следить, чтобы процесс не падал. Go удобен тем, что весь проект компилируется в один исполняемый файл, но работа вокруг сервера от этого никуда не девается.

Netrun убирает эту часть: вы загружаете исходный код, мы сами видим, что это Go, собираем проект и выдаем публичную ссылку с HTTPS (защищенное соединение, замочек в браузере). Ни сервера, ни nginx, ни ручного сертификата — ниже о том, как пройти путь от папки с кодом до рабочей ссылки.

  1. Проверьте, что в корне есть go.mod#

    Файл go.mod в корне проекта перечисляет зависимости и говорит Netrun, что перед ним Go-приложение. Папку с зависимостями (например, vendor) класть не нужно — библиотеки мы подтянем сами по go.mod при сборке.

  2. Читайте порт из переменной окружения#

    Если у вас веб-сервис, он должен слушать тот порт, который задает Netrun через переменную окружения PORT, а не прописанный в коде намертво. На практике это значит взять порт через os.Getenv("PORT") и слушать именно его — тогда мы автоматически пробросим наружу нужный адрес. Захардкоженный порт сломал бы публикацию.

  3. Загрузите код#

    Откройте Netrun и принесите проект одним из двух способов: ZIP-архивом с исходниками или импортом из GitHub-репозитория, в том числе приватного. Достаточно самого кода с go.mod — собирать бинарь у себя и ставить Go где-либо не нужно, все происходит у нас.

  4. Укажите секреты, если они есть#

    Если приложение ходит во внешний сервис или базу данных, ключи API, токены и строку подключения мы спросим при настройке. Они подставятся в переменные окружения и не будут лежать в коде — читайте их из окружения через os.Getenv так же, как порт.

  5. Дождитесь сборки и заберите ссылку#

    Netrun сам соберет проект и поднимет его. Логи и статус публикации видны в кабинете в реальном времени, так что вы сразу заметите, если что-то пошло не так. Когда все готово, вы получите публичную ссылку с HTTPS — ее можно открывать и отправлять кому угодно.

Готово: ваше Go-приложение доступно в интернете без аренды сервера и настройки SSL. На бесплатном тарифе доступен один проект, и веб-сервис на нем засыпает при простое и просыпается по запросу — первый ответ после паузы будет чуть медленнее. Если приложение должно отвечать без задержек постоянно, подойдет платный тариф с работой без простоев, а если проектов нужно больше — можно оплатить места под них. Попробовать Netrun.

Частые вопросы

Как правильно прочитать порт в Go?

Возьмите его из окружения: port := os.Getenv("PORT"), и запустите сервер через http.ListenAndServe(":"+port, handler). Запись с двоеточием без адреса означает «слушать на всех адресах» — это и нужно. Для локального запуска подставьте значение по умолчанию, если переменная пустая.

Нужно ли класть в архив папку vendor?

Нет. Зависимости подтягиваются при сборке по go.mod и go.sum, поэтому достаточно исходного кода. Следите, чтобы go.sum был актуальным: без нужных записей в нем сборка может остановиться на проверке зависимостей.

Можно ли выложить Go-программу без веб-сервера, например бота?

Да. Если программа не слушает порт, Netrun запустит ее как фоновый процесс без публичной ссылки — так работают боты и скрипты. На бесплатном тарифе такой проект работает ограниченное время, а круглосуточно — на тарифе Pro.

Почему Go-сайт иногда открывается не сразу?

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

Где Go-приложению хранить файлы и базу SQLite?

В постоянной папке /data: все, что приложение туда пишет, переживает обновление кода и перезапуск. Файлы вне /data при следующей публикации пропадают.

Запустите свой проект

Загрузите код, ответьте на пару вопросов — и получите рабочую ссылку. Есть бесплатный тариф

Попробовать Netrun
Все статьи блога