容器化 Bun 应用程序

先决条件

• 您拥有 Git 客户端。本节中的示例使用基于命令行的 Git 客户端，但您可以使用任何客户端。

概述

长期以来，Node.js 一直是服务器端 JavaScript 应用程序的事实标准运行时。近年来，生态系统中出现了许多新的替代运行时，包括 Bun 网站。与 Node.js 一样，Bun 是一个 JavaScript 运行时。Bun 是一个相对轻量级的运行时，旨在快速且高效。

为什么使用 Docker 开发 Bun 应用程序？拥有多种运行时可供选择固然很棒。但随着运行时数量的增加，在不同环境中一致地管理不同的运行时及其依赖项变得具有挑战性。这正是 Docker 的用武之地。按需创建和销毁容器是管理不同运行时及其依赖项的绝佳方式。此外，由于它是一个相当新的运行时，为 Bun 建立一致的开发环境可能具有挑战性。Docker 可以帮助您为 Bun 建立一致的开发环境。

获取示例应用程序

克隆示例应用程序以供本指南使用。打开终端，切换到您想要工作的目录，然后运行以下命令来克隆存储库：

$ git clone https://github.com/dockersamples/bun-docker.git && cd bun-docker

现在，您的 bun-docker 目录中应包含以下内容。

├── bun-docker/
│ ├── compose.yml
│ ├── Dockerfile
│ ├── LICENSE
│ ├── server.js
│ └── README.md

创建 Dockerfile

在创建 Dockerfile 之前，您需要选择一个基础镜像。您可以使用 Bun Docker 官方镜像 或来自 Hardened Image 目录 的 Docker Hardened Image (DHI)。

选择 DHI 的优势在于它提供了生产就绪、轻量级且安全的镜像。更多信息，请参阅 Docker Hardened Images。

# 使用 DHI Bun 镜像作为基础镜像
FROM dhi.io/bun:1

# 设置容器中的工作目录
WORKDIR /app

# 将当前目录的内容复制到容器中的 /app
COPY . .

# 暴露 API 将监听的端口
EXPOSE 3000

# 在容器启动时运行服务器
CMD ["bun", "server.js"]

# 使用官方的 Bun 镜像
FROM oven/bun:latest

# 设置容器中的工作目录
WORKDIR /app

# 将当前目录的内容复制到容器中的 /app
COPY . .

# 暴露 API 将监听的端口
EXPOSE 3000

# 在容器启动时运行服务器
CMD ["bun", "server.js"]

除了指定基础镜像之外，Dockerfile 还：

• 将容器中的工作目录设置为 /app。
• 将当前目录的内容复制到容器中的 /app 目录。
• 暴露 API 正在监听请求的端口 3000。
• 最后，在容器启动时使用命令 bun server.js 启动服务器。

运行应用程序

在 bun-docker 目录中，在终端中运行以下命令。

$ docker compose up --build

打开浏览器，在 http://localhost:3000 查看应用程序。您将在浏览器中看到消息 {"Status" : "OK"}。

在终端中，按 ctrl+c 停止应用程序。

在后台运行应用程序

您可以通过添加 -d 选项在终端后台运行应用程序。在 bun-docker 目录中，在终端中运行以下命令。

$ docker compose up --build -d

打开浏览器，在 http://localhost:3000 查看应用程序。

在终端中，运行以下命令停止应用程序。

$ docker compose down

总结

在本节中，您学习了如何使用 Docker 容器化并运行您的 Bun 应用程序。

相关信息：

• Dockerfile 参考
• .dockerignore 文件
• Docker Compose 概述
• Compose 文件参考
• Docker Hardened Images

下一步

在下一节中，您将学习如何使用容器开发您的应用程序。