1 В избранное 0 Ответвления 0

OSCHINA-MIRROR/mirrors-baserow

Клонировать/Скачать
install-on-heroku.md 15 КБ
Копировать Редактировать Web IDE Исходные данные Просмотреть построчно История
Отправлено 26.06.2025 16:02 92285f5

Установка на Heroku

Есть вопросы, проблемы или предложения по этому руководству? Задайте вопрос в нашем сообществе или внесите изменения самостоятельно на https://gitlab.com/baserow/baserow/-/tree/develop/docs .

Шаблон и кнопка для быстрой установки на Heroku находятся в бета-версии.

Heroku — это платформа как услуга, которая позволяет разработчикам создавать, запускать и управлять приложениями полностью в облаке. Мы создали шаблон, который позволяет вам легко установить Baserow на базовый динозавр Heroku. Вы также можете масштабировать установку, изменяя некоторые настройки.

Шаблон

Установить на Heroku Бета

Кнопка выше может быть использована для установки Baserow на Heroku одним кликом. Нажмите на неё и следуйте инструкциям на heroku.com для продолжения. После установки вы сможете доступ к Baserow по URL, предоставленному Heroku. Всё, установленное через шаблон, по умолчанию работает на базовом динозавре Heroku.

Бюджетирование

28 ноября 2022 года планы hobby-dev (бесплатные) на Heroku были отменены.

Это означает, что для развертывания Baserow на Heroku потребуется небольшая плата. Мы выбрали самые дешёвые и безопасные динозавры и дополнения для развертывания. Вы всегда можете обновить свои динозавры, если вашей установке потребуются больше ресурсов (см. раздел Масштабирование ниже).

  • web ($7/мес): веб-формация создает базовый динозавр, который всегда включен.
  • heroku-redis:mini ($3/мес): дополнение Redis.
  • heroku-postgresql:mini ($5/мес): дополнение Postgresql.

Встроенные шаблоны Baserow отключены по умолчанию

По умолчанию мы используем дополнение heroku-postgresql:mini, так как это самое дешёвое ($5/мес, до 10к строк) дополнение Postgres. Шаблоны Baserow требуют более 10к строк, поэтому они не загружаются по умолчанию. Если вы обновите свою базу данных Heroku для поддержки большего объёма данных и захотите загрузить шаблоны, выполните следующие действия:

  1. Войдите в Heroku и откройте ваше приложение Baserow.
  2. Нажмите "Ещё" в правом верхнем углу.
  3. Нажмите "Запустить консоль".
  4. Введите и выполните следующую команду ./baserow.sh backend-cmd manage sync_templates.

Каждый раз, когда вы обновляете своё приложение Baserow на Heroku, вам нужно будет повторить эти шаги, чтобы получить последние шаблоны Baserow.

Ошибка "Не удалось подключиться к серверу API"

Если при входе в систему или создании аккаунта у вас возникает ошибка "Не удалось подключиться к серверу API", скорее всего, вам нужно обновить переменную конфигурации BASEROW_PUBLIC_URL. Для этого перейдите на страницу настроек вашего приложения Heroku, нажмите "Показать переменные конфигурации", найдите BASEROW_PUBLIC_URL и измените значение на https://YOUR_APP_NAME.herokuapp.com. Не забудьте заменить YOUR_APP_NAME на имя вашего приложения.

Постоянное хранение файлов S3

По умолчанию загруженные файлы хранятся внутри динозавра для демонстрационных целей. Это означает, что каждый раз, когда ваш динозавр перезапускается, вы теряете все загруженные файлы. Файлы можно хранить в S3-бакете. Для этого вам нужно добавить несколько переменных конфигурации в настройки. Перейдите на страницу Настроек и нажмите "Показать переменные конфигурации". Здесь вам нужно добавить следующие переменные:

  • AWS_ACCESS_KEY_ID: Ключ доступа для вашей учетной записи AWS.
  • AWS_SECRET_ACCESS_KEY: Секретный ключ для вашей учетной записи AWS.
  • AWS_STORAGE_BUCKET_NAME: Имя вашего бакета Amazon Web Services.
  • AWS_S3_REGION_NAME Опционально: Имя региона AWS S3 (например, eu-west-1).
  • AWS_S3_ENDPOINT_URL Опционально: Пользовательский URL S3 для подключения к S3, включая схему.
  • AWS_S3_CUSTOM_DOMAIN Опционально: Ваш пользовательский домен, с которого можно скачать файлы.

Поставщики S3, отличные от AWS

Также можно использовать поставщиков S3, отличных от AWS, например Digital Ocean. Ниже приведены примерные настройки для подключения к Digital Ocean Spaces.

  • AWS_ACCESS_KEY_ID: Ключ API пространства.
  • AWS_SECRET_ACCESS_KEY: Секретный ключ API пространства.
  • AWS_STORAGE_BUCKET_NAME: Имя вашего пространства.
  • AWS_S3_REGION_NAME: Имя региона пространств Digital Ocean (например, ams3).
  • AWS_S3_ENDPOINT_URL: (например, https://ams3.digitaloceanspaces.com).
  • AWS_S3_CUSTOM_DOMAIN: (например, name-of-your-space.ams3.digitaloceanspaces.com).

Масштабирование

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

Работники на динозавре

Для экономии ресурсов каждый динозавр по умолчанию имеет только одного работника. Если вы обновляете до стандартного 2x динозавра, вы можете увеличить количество работников до 2. Это можно сделать через Переменные конфигурации в Настройках. На странице настроек нажмите "Показать переменные конфигурации", найдите переменную "BASEROW_AMOUNT_OF_WORKERS" и установите значение 2.

Вы можете приблизительно оценить количество работников на основе доступной оперативной памяти вашего типа динозавра. Каждому работнику требуется около 512 МБ оперативной памяти, поэтому стандартный x1 динозавр должен иметь одного работника, стандартный x2 может иметь 2 работников, а производительный M может иметь 4.

Postgres

По умолчанию мы используем дополнение heroku-postgresql:mini, так как оно поддерживает 10к строк за $5/мес. Если вам нужны больше строк, вам нужно обновить это дополнение.

Redis

По умолчанию мы используем дополнение heroku-redis:mini, так как оно поддерживает 20 соединений за $3/мес. Если вы масштабируете установку, вам потребуется больше соединений, что означает, что вам нужно обновить это дополнение. Чтобы приблизительно оценить количество необходимых соединений, вы можете использовать формулу DYNO COUNT * BASEROW_AMOUNT_OF_WORKERS * 15.

Пользовательский домен

Если вы добавили пользовательский домен, вам нужно изменить переменную конфигурации на странице настроек. Перейдите на страницу Настроек и нажмите "Показать переменные конфигурации". Здесь вам нужно установить значение BASEROW_PUBLIC_URL и добавить свой собственный URL. Если ваш домен — baserow-test.com, то значение должно быть https://baserow-test.com. Если у вас нет пользовательского домена, это значение может быть пустым.

Переменные окружения

  • SECRET_KEY: Уникальная строка, используемая для генерации секретов.
  • BASEROW_JWT_SIGNING_KEY: Уникальная строка, используемая для подписи JWT-токенов.
  • BASEROW_PUBLIC_URL: Публичный URL вашего приложения Baserow на Heroku. Если пусто, используется URL по умолчанию приложения Heroku, но если он отличается, его необходимо изменить. (например, https://baserow-test.com).
  • BASEROW_AMOUNT_OF_WORKERS: Количество работников на динозавре.
  • AWS_ACCESS_KEY_ID: Ключ API пространства.
  • AWS_SECRET_ACCESS_KEY: Секретный ключ API пространства.
  • AWS_STORAGE_BUCKET_NAME: Имя вашего пространства.
  • AWS_S3_REGION_NAME: Имя региона пространств Digital Ocean (например, ams3).
  • AWS_S3_ENDPOINT_URL: Пользовательский URL S3 для подключения к S3, включая схему.
  • AWS_S3_CUSTOM_DOMAIN: Ваш пользовательский домен, с которого можно скачать файлы.

Домены конструктора приложений

Baserow имеет конструктор приложений, который позволяет развернуть приложение на конкретном домене. Поскольку Heroku имеет обратный прокси-сервер, который маршрутизирует домен к правильному динозавру, развернутое приложение автоматически не доступно на выбранном домене.

Чтобы это работало, вам нужно добавить доменное имя в настройки приложения. Это можно сделать, перейдя в настройки вашего приложения Baserow, затем прокрутите до раздела Домены, нажмите Добавить домен, и затем добавьте домен, на который вы опубликовали приложение в Baserow. Убедитесь, что домен соответствует полному доменному имени в Baserow.

Обновление

Когда выходит новая версия Baserow, вы, вероятно, захотите обновиться. К сожалению, через веб-интерфейс невозможно обновиться из публичного репозитория, поэтому вам нужно сделать это через командную строку. Если у вас не установлен heroku-cli, вы можете следовать инструкциям здесь https://devcenter.heroku.com/articles/heroku-cli. После установки cli вам вероятно потребуется выполнить heroku login, чтобы аутентифицироваться с вашей учетной записью.

Убедитесь, что вы перешли в пустую директорию и затем выполните команды ниже. Не забудьте заменить YOUR_APP_NAME на имя вашего приложения Heroku.

$ git clone --branch master https://gitlab.com/baserow/baserow.git
$ cd baserow
$ git remote add heroku https://git.heroku.com/YOUR_APP_NAME.git
$ git push -f heroku master

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

$ cd ../
$ rm -rf baserow

Опубликовать ( 0 )

Вы можете оставить комментарий после Вход в систему

1
https://api.gitlife.ru/oschina-mirror/mirrors-baserow.git
git@api.gitlife.ru:oschina-mirror/mirrors-baserow.git
oschina-mirror
mirrors-baserow
mirrors-baserow
develop