运行 NodeJS 应用

在 Amphitheatre 上运行应用程序基本上就是找出如何将其打包为可部署的镜像。一旦打包 好，就可以部署到 Amphitheatre 平台。

示例应用程序

我们的示例将是一个使用 Node 和 Express 的基本 "Hello World" 示例。

您可以从 GitHub 存储库 获取示例的代码。只需运行 git clone https://github.com/amphitheatre-app/amp-example-nodejs 来获取本地副本。以下是所 有的代码：

'use strict';

const express = require('express')
const app = express()

app.use(express.static('public'));
app.get('/hello', (req, res) => res.send('Hello World'))

const port = 3000
app.listen(port, () => console.log(`Example app listening on port ${port}!`))

我们将称此文件为 index.js，然后运行 npm init 和 npm install express --save 以获得基本的 Node 设置。

运行应用程序

运行 node index.js 来启动应用程序

$ node index.js
Example app listening on port 3000!

然后连接到 http://localhost:3000/hello，以确认您有一个可工作的 Node 应用程序。 现在，将其打包以供 Amphitheatre 使用。

安装 Amphitheatre

我们已准备好开始使用 Amphitheatre，这意味着我们需要 amp，我们的 CLI 应用程序， 用于管理在 Amphitheatre 上的应用程序。如果您已经安装了它，请继续。如果没有，请转 到 我们的安装指南。

初始化 Character

要在 Amphitheatre 上启动应用程序，请在源代码所在的目录中运行 amp init。这将通 过检查您的源代码来为您创建和配置一个 Character，然后提示您部署。

$ amp init

Scanning source code
 Detected NodeJS app
 Using the following build configuration
         Builder: heroku/buildpacks:20
Wrote config file .amp.toml
Your Character is ready. run with `amp run`
...

首先，此命令会扫描您的源代码，以确定如何构建部署镜像，以及识别应用程序所需的任何 其他配置，如密钥和暴露的端口。

在扫描源代码并打印结果后，amp 会为您创建一个 Character，并将配置写入 .amp.toml 文件。然后，您将被提示构建和部署您的 character。一旦完成，您的应用程 序将在 Amphitheatre 上运行。

在 .amp.toml 中

.amp.toml 文件现在包含了部署您的 Character 的默认配置。如果我们查看 .amp.toml 文件，我们可以在其中看到它：

name = "amp-example-nodejs"
version = "0.0.1"
authors = ["Eguo Wang <wangeguo@gmail.com>"]
edition = "v1"
description = "一个简单的 NodeJS 示例应用程序"
readme = "README.md"
homepage = "https://github.com/amphitheatre-app/amp-example-nodejs"
repository = "https://github.com/amphitheatre-app/amp-example-nodejs"
license = "Apache-2.0"
license-file = "LICENSE"
keywords = ["example", "nodejs", "getting-started"]
categories = ["example"]

amp 命令将始终引用当前目录中的此文件（如果存在），特别是以开始的角色名称值。该 名称将用于标识 Amphitheatre 平台上的角色。文件的其余部分包含部署角色时要应用的设 置。

配置 Buildpack

Heroku Nodejs Buildpack 允许通过环境变量进行一些定制。这些可以通过 Docker 构建 参数 传 递到构建中。

部署到 Amphitheatre

要部署您的 Character，只需运行：

amp run

这将查找我们的 .amp.toml 文件，并从中获取 Character 名称 amp-example-nodejs。然后，amp 将开始部署我们的 Character 到 Amphitheatre 平台。完成后，amp 会将您返回到命令行。

到达目的地

您已成功构建并部署了您的第一个 NodeJS 应用程序到 Amphitheatre。