> 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/zh/docs/sample-projects/nuxt-on-edgegap.md).

# NuxtJS

将 Nuxt Web 应用部署到 Edgegap，并通过全球边缘网络在靠近用户的位置提供服务。

### 入门

Edgegap 为您提供了一个非常直观的平台，可将无服务器 Web 应用部署到您需要的任何位置。本教程将介绍部署 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 标志。

现在，您可以将此脚本复制并粘贴到其中，以获取主要依赖项。请记住，这将创建一个大小略高于 1GB 的镜像。就本教程而言，这样是可以的。但对于生产环境中的应用，您必须对其进行优化：

{% 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 CPU（Mac M1、M2 等）用户，请查看 [专门页面](broken://pages/363416186bc562ffffb244aa3f6e5106002bd8cc).
{% 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 %}

太好了！现在，你距离在 Edgegap 平台上部署你的 Nuxt 应用只差一步。

### 在 Edgegap 上部署你的应用

在 Edgegap 上部署应用有两种方式。无论哪种方式，你都需要拥有一个我们的账户，你可以点击此处链接免费创建一个。首先，我们先来介绍如何通过我们的网站部署容器化应用。

#### 通过 Edgegap 仪表板部署应用：

您需要前往以下网页地址并输入您的凭据。完成后，系统会自动将您重定向到仪表板。如果您刚刚创建了帐户，您会立即看到启动第一个应用的选项。如果没有，只需前往屏幕左侧菜单中的“Applications and games”选项卡。您会在右上角看到创建新应用的选项：

<figure><img src="https://3334189208-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://3334189208-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 镜像大小约为 1GB。要在 Edgegap 上部署这么大的镜像，您需要将最大部署时间增加到大约 300 秒。

当你用合适的信息填写完表单后，只需提交即可，然后你就可以准备部署了。只需选择区域和你希望模拟的玩家数量。

<figure><img src="https://3334189208-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://3334189208-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 应用的默认落地页。

#### 通过 Edgegap API 部署应用

虽然我们的网页仪表板是部署应用最友好的方式，但你也可以通过一个非常简单的 API 请求来完成。为此，你可以使用 Postman。重要的是，你需要访问仪表板来 [创建一个 API 令牌](broken://pages/63c51b0385ef1748b3681fe05c8bc45ccab89b94) 通过您个人资料中的选项。以下是创建 API 令牌的简单指南。

一旦你拿到 API 令牌，剩下要做的就是根据你的应用名称、版本、IP 地址、你希望部署的区域，以及当然还有作为授权参数一部分的令牌来构造一个部署请求。你可以在我们的文档中看到完整请求的样子。

发送请求后，你应该会在命令行中看到响应，或者在 Postman 中看到类似这样的内容：

<figure><img src="https://3334189208-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”选项卡查看正在运行的活动部署。
