> 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/nuxt-on-edgegap.md).

# NuxtJS

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

### Начало работы

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

Откройте терминал в папке, где находится ваш каталог, и выполните следующую команду:

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn
```

{% endcode %}

После того как все зависимости будут установлены, убедитесь, что всё установилось правильно, выполнив эту команду:

{% code collapsedlinecount="10" %}

```
C:\Users\JohnDoe\Documents\demo-nuxt-edgegap> yarn dev
```

{% endcode %}

Если всё прошло успешно, yarn dev должен вернуть версию установленного yarn. Теперь, когда с этим покончено, мы можем рассмотреть оставшиеся требования для успешного завершения этого руководства.

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

### Контейнеризируйте своё приложение

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

Теперь вы можете скопировать и вставить в него этот скрипт, чтобы получить основные зависимости. Имейте в виду, что в результате будет создан образ размером чуть более 1 ГБ. Для целей этого руководства это нормально. Но для production-приложения вам придётся его оптимизировать:

{% code collapsedlinecount="10" %}

```dockerfile
FROM node:lts as builder

WORKDIR /app

COPY . .

RUN yarn install \
  --prefer-offline \
  --frozen-lockfile \
  --non-interactive \
  --production=false

RUN yarn build

RUN rm -rf node_modules && \
  NODE_ENV=production yarn install \
  --prefer-offline \
  --pure-lockfile \
  --non-interactive \
  --production=true

FROM node:lts

WORKDIR /app

COPY --from=builder /app  .

ENV HOST 0.0.0.0
EXPOSE 80

CMD [ "yarn", "start" ]
```

{% endcode %}

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

{% hint style="warning" %}
Для пользователей с процессором ARM (Mac M1, M2 и т. д.) см.  [отдельную страницу](broken://pages/daca8737c84d4beaaed89e5753e5368f1abf29f7).
{% endhint %}

{% code collapsedlinecount="10" %}

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

{% endcode %}

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

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

Но перед этим вам нужно отправить только что созданный 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>/demo-nuxt-edgegap:<YOUR_VERSION_NUMBER>
```

{% endcode %}

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

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

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

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

Вам нужно перейти по следующему веб-адресу и ввести свои учетные данные. После этого вы будете автоматически перенаправлены в свою панель управления. Если вы только что создали учетную запись, вы увидите возможность сразу запустить своё первое приложение. Если нет, просто перейдите на вкладку «Applications and 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» формы создания.
* Максимальное время развертывания: как упоминалось ранее в этом руководстве, наш образ NuxtJS имеет размер около 1 ГБ. Чтобы развернуть на Edgegap такой большой образ, вам нужно увеличить Maximum time to deploy примерно до 300 секунд.

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

<figure><img src="https://3845012722-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-3f94772bc292c12029b2fcf24a8e4f22df406d08%2Fnuxt-js-app-launch-1.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-7963d541fcb7a40b3733247854e0fe3e346475b9%2Fnuxt-js-app-launch-2.png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

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

Когда у вас будет 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-4963dbbc9a5be5f79c9e449038b40eb250489bba%2Fnuxt-js-app-launch-api.png?alt=media" alt=""><figcaption></figcaption></figure>

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