> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ru/docs/sample-projects/ruby-on-rails.md).

# Ruby On Rails

Разверните приложение Ruby on Rails на Edgegap и обслуживайте пользователей поблизости через глобальную периферийную сеть.

### Установка Ruby

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

Если вы работаете на машине Linux/UNIX, вы можете использовать предустановленный на вашем компьютере пакетный менеджер и установить Ruby через терминал. Вы можете обратиться к [официальной документации Ruby](https://www.ruby-lang.org/en/documentation/installation/) чтобы найти точную команду, соответствующую вашему дистрибутиву Linux/UNIX.

На компьютерах с Windows вам придется скачать [RubyInstaller](https://rubyinstaller.org) для установки Ruby.

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

{% code collapsedlinecount="10" %}

```
ruby -v
```

{% endcode %}

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

{% code collapsedlinecount="10" %}

```
gem install rails
```

{% endcode %}

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

{% code collapsedlinecount="10" %}

```
rails -v
```

{% endcode %}

### Требования

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

* [Docker Desktop](https://www.docker.com/get-started/)
* [Аккаунт на Edgegap](https://app.edgegap.com/auth/login)
* Доступ к [частному контейнерному репозиторию Edgegap](https://docs.edgegap.com/ru/learn/advanced-features/edgegap-container-registry.md) или другому реестру, например [контейнерному реестру Docker](https://hub.docker.com/)

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

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

{% code collapsedlinecount="10" %}

```
rails new edgegap-ruby-rails-demo
```

{% endcode %}

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

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

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

{% code collapsedlinecount="10" %}

```
rails generate controller HelloWorld index --skip-routes
```

{% endcode %}

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

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

{% code collapsedlinecount="10" %}

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

{% endcode %}

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-203bfc13bd043df0ca5bbc9cd9e267e456e53a9e%2Fruby-index-page.png?alt=media" alt=""><figcaption></figcaption></figure>

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

Linux:

{% code collapsedlinecount="10" %}

```sh
rails server
```

{% endcode %}

Windows:

{% code collapsedlinecount="10" %}

```sh
ruby bin/rails server
```

{% endcode %}

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

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

{% code collapsedlinecount="10" %}

```dockerfile
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"]
```

{% endcode %}

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

{% hint style="warning" %}
Для пользователей с ARM CPU (Mac M1, M2 и т. д.) добавьте `--platform linux/amd64`  опцию в команду сборки.
{% endhint %}

{% code collapsedlinecount="10" %}

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

{% endcode %}

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

{% tabs %}
{% tab title="Bash (Linux)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (Windows)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

Теперь осталось только отправить ваш образ вот так:

{% code collapsedlinecount="10" %}

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

{% endcode %}

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

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

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

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

Вам нужно будет перейти на [веб-сайт платформы Edgegap](https://console.edgegap.com/) и ввести свои учетные данные. После этого вы будете автоматически перенаправлены на свою панель управления. Если вы только что создали аккаунт, вы сразу увидите возможность запустить свое первое приложение. Если нет, просто перейдите на вкладку «Applications & Games» в меню слева на экране. Справа вы увидите возможность создать новое приложение:

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-fc4b2486acb434863c2a6fd0e3772e02bfd2e214%2Fcreate-app-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-488e9bf3f56918ab3e01c15c9364a8fe321a40b5%2Fapp-form-nuxt-js.png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-810022e4ed498eed59c957e369b76261513c0daa%2Fruby-deployment-edgegap.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-b407d8a535e2c875804fc36d55999d68b2c82121%2Fruby-deployment-edgegap-2.png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

Хотя наша веб-панель — самый удобный способ развертывания приложения, вы также можете сделать это с помощью очень простого API-запроса. Для этого вы можете использовать Postman. Важно, чтобы вы посетили панель управления, чтобы [создать API-токен](broken://pages/29b486fe8b35e1a3fd3572cfb5cf37de7fe8a4d2) через параметры вашего профиля.

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

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-902356a5acce346433cb04f870f205cc4f161e2d%2Fruby-deployment-api.png?alt=media" alt=""><figcaption></figcaption></figure>

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