Ruby On Rails

Установка Ruby

Edgegap предлагает очень интуитивную платформу для развёртывания бессерверного веб-приложения там, где вам нужно. В этом руководстве мы рассмотрим шаги по развертыванию Ruby on Rails. Прежде чем проверять что-либо ещё, убедитесь, что Ruby установлен.

Если вы используете машину с Linux/UNIX, вы можете воспользоваться предустановленным менеджером пакетов на вашей системе и установить Ruby через терминал. Вы можете обратиться к официальной документации Ruby чтобы найти точную команду, соответствующую вашему дистрибутиву Linux/UNIX.

На машинах Windows вам потребуется скачать RubyInstaller чтобы получить Ruby.

После завершения установки вы можете проверить, что Ruby установлен правильно, с помощью следующей команды:

ruby -v

Теперь, когда Ruby установлен, вам, разумеется, нужно установить Rails. Это довольно просто и делается одной командой:

gem install rails

Вы легко можете подтвердить, что Rails установлен корректно аналогичным образом, как мы проверяли установку Ruby.

rails -v

Требования

Чтобы следовать этому руководству, кроме Ruby и Ruby on Rails вам потребуется следующее:

• Docker Desktop

• Учётная запись на Edgegap

• Доступ к приватному реестру контейнеров Edgegap или другому реестру, например реестру контейнеров Docker

Начало работы с Ruby on Rails

Чтобы начать работу с Ruby on Rails, вам нужно создать папку для нового проекта и выполнить в ней следующую команду:

rails new edgegap-ruby-rails-demo

После завершения установки вам нужно будет изменить файл routes.rb, который находится в папке config. Ваш файл маршрутов должен содержать следующее:

Rails.application.routes.draw do
  root 'hello_world#index'
end

Вы можете заметить, что в проекте в папке views нет страницы «hello_world». Вы можете легко сгенерировать её вместе с соответствующим контроллером. Сначала убедитесь, что вы находитесь в папке, созданной Rails, когда вы выполнили rails new команду.

Если вы используете дистрибутив Linux, используйте следующую команду, чтобы создать контроллер HelloWorld:

rails generate controller HelloWorld index --skip-routes

Опция skip-routes гарантирует, что эта команда не сгенерирует новый маршрут для этого контроллера, что и нужно, так как мы уже создали маршрут вручную.

Для Windows вам нужно будет добавить несколько ключевых слов в команду следующим образом:

ruby bin/rails generate controller HelloWorld index –skip-routes

После успешного выполнения команды вы увидите страницу HelloWorld в папке views. Возможно, вам придётся исправить синтаксис HTML, чтобы получить корректный раздел перед развертыванием. Файл должен выглядеть так:

Единственный оставшийся шаг для завершения вашего проекта — запустить ваше приложение Ruby on Rails локально. Снова команда для этого отличается между Linux и Windows следующим образом:

Linux:

rails server

Windows:

ruby bin/rails server

Контейнеризация вашего приложения

Контейнеризация большинства приложений проста. Нужно создать Dockerfile, а затем запустить его в Docker, чтобы создать образ. Visual Studio Code — хорошая платформа для создания Dockerfile, поскольку по умолчанию она не добавляет расширение к каждому новому файлу, который мы создаём. Именно это нам и нужно. Просто создайте новый файл и назовите его Dockerfile. Рядом с ним появится маленький логотип Docker. Теперь вы можете скопировать и вставить в него этот скрипт, чтобы получить основные зависимости. Образ, который создаст этот Dockerfile, будет занимать около 700 МБ. Конечно, вы можете оптимизировать его, но контейнер такого размера будет работать очень плавно на Edgegap:

FROM ruby:3-alpine
WORKDIR /app
COPY . .
RUN apk add --no-cache build-base tzdata nodejs yarn sqlite-dev postgresql-dev mysql-dev
RUN gem install bundler
RUN bundle install
ENV RAILS_ENV=production
RUN bundle exec rails assets:precompile
EXPOSE 3000
CMD ["rails", "server", "-b", "0.0.0.0"]

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

Для пользователей с ARM CPU (Mac M1, M2 и др.) см. специальную страницу.

docker build -t registry.edgegap.com/<YOUR_REPO>/ruby-rails-demo:<YOUR_VERSION_NUMBER> .

Предпочтительнее указывать номер версии в соответствии с семантическим версионированием, но если вы не планируете обновлять сборку на Edgegap после первого развертывания, вы можете полностью опустить номер версии. Но прежде чем это сделать, вам нужно отправить (push) только что созданный образ Docker в выбранный вами реестр образов. Помните, что мы предлагаем приватные репозитории через Edgegap Registry, которые предоставляют ряд преимуществ в области безопасности, которых у вас не будет при использовании стандартного реестра Docker. Чтобы отправить образ в наш реестр, вам сначала нужно войти с вашими учётными данными, используя эту команду:

docker login registry.edgegap.com

Теперь остаётся только отправить ваш образ следующим образом:

docker push registry.edgegap.com/<YOUR_REPO>/ruby-rails-demo:<YOUR_VERSION_NUMBER>

Отлично! Теперь вы на шаг ближе к развертыванию вашего Nuxt-приложения на платформе Edgegap.

Разверните ваше приложение на Edgegap

Существует два способа развернуть приложение на Edgegap. Для обоих вам потребуется учётная запись у нас, которую вы можете создать бесплатно, кликнув по ссылке прямо здесь. Сначала рассмотрим, как развернуть контейнеризированное приложение через наш веб-сайт.

Развёртывание приложения через панель управления Edgegap

Вам нужно перейти на веб-сайт платформы Edgegap и ввести ваши учётные данные. После этого вы будете автоматически перенаправлены на свою панель управления. Если вы только что создали аккаунт, вы увидите опцию запустить ваше первое приложение сразу. В противном случае просто перейдите в вкладку «Applications & Games» в меню слева на экране. Вы увидите опцию создания нового приложения в правом верхнем углу:

После того как вы нажмёте на неё, появится следующая форма:

Вам следует заполнить все обязательные поля, и после этого есть несколько вещей, которые вам нужно изменить по сравнению со значениями по умолчанию:

• Номер порта: этому приложению необходимо открыть порт 3000, поэтому добавьте его в разделе «ports» формы создания. Снимите флажок проверки порта.

После того как вы закончите заполнение формы с соответствующей информацией, просто отправьте её, и вы будете готовы к развертыванию. Просто выберите регион и количество игроков, которое вы хотите эмулировать.

После того как вы закончите заполнение формы с соответствующей информацией, просто отправьте её, и вы будете готовы к развертыванию. Просто выберите регион и количество игроков, которое вы хотите эмулировать.

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

Это откроет новую вкладку, где вы найдете страницу по умолчанию вашего Nuxt-приложения.

Развёртывание приложения через API Edgegap

Хотя наша веб-панель — самый удобный способ развертывания приложения, вы также можете сделать это через очень простой API-запрос. Для этого вы можете использовать Postman. Важно посетить панель управления, чтобы создать API-токен через опции в вашем профиле.

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

После отправки запроса вы должны увидеть ответ в командной строке или в Postman, который будет выглядеть так:

Это всё, что требуется для развертывания приложения через CLI. Чтобы подтвердить, что ваше приложение развернуто, вы можете снова перейти на панель управления и увидеть активное развертывание в работе, нажав на вкладку «Active deployments».