SPA 应用部署方案 ——Docker + nginx

阅读时长 8 分钟读完

概述

随着前端技术的不断发展,单页面应用程序(Single Page Application)已经成为了主流的 Web 应用程序的开发方式。在部署 SPA 应用程序时,使用 Docker 和 nginx 是一种非常优秀的选择。Docker 作为跨平台的容器化技术,可以方便地将应用程序打包成一个独立的运行环境,并提供了高度一致的部署方式;nginx 作为流行的 Web 服务器,可以提供高效的 HTTP 服务,并支持反向代理和负载均衡功能。在本文中,我们将详细介绍如何使用 Docker 和 nginx 部署 SPA 应用程序,并提供相应的示例代码。

Docker 部署

准备工作

在进行 Docker 部署之前,需要先准备好 Docker 环境。在 Linux 下,可以使用以下命令安装 Docker:

安装完成后,通过运行以下命令,可以验证 Docker 是否安装成功:

这会下载一个可执行程序并在容器中运行它,在命令行输出中应该会看到类似以下内容的信息:

打包 SPA 应用程序

在准备好 Docker 环境后,需要将 SPA 应用程序打包成一个 Docker 镜像。在进行打包之前,需要先准备好以下文件:

  • SPA 应用程序的静态资源文件
  • 一个 NGINX 配置文件(见下文)

首先,在应用程序的根目录下创建一个 Dockerfile 文件,内容如下:

-- -------------------- ---- -------
- ------- ------- -------
---- -------------------

- ------------- ------------ ---
---- - ------------
------- ------------

- ----
--- --- -------

- ------
--- --- --- -----

---- ------------

- - ----- --------------
---- ---------- ---------------------

- ---------------- ----- --------
---- -------- ------------------ ---------------------
展开代码

这个 Dockerfile 首先指定运行环境为 Node.js 10.16.0,然后将当前目录下的所有文件拷贝到 /usr/src/app 目录下,并运行 npm install 安装依赖,最后执行 npm run build 构建应用程序。接着,从 nginx:alpine 镜像中构建一个新的镜像,并将 NGINX 配置文件替换为自定义配置文件,将应用程序构建出的静态文件拷贝到 NGINX 的静态文件目录下。

同时,在应用程序的根目录下创建一个 nginx.conf 文件作为 NGINX 的配置文件,内容如下:

-- -------------------- ---- -------
---- ------
---------------- --

--------- ------------------------ -----
--- -------------------

------ -
  ------------------ -----
-

---- -
  ------- ----------------------
  ------------ -------------------------

  ---------- ---- ------------- - ------------ ------------- ---------- -
                  -------- ---------------- --------------- -
                  ------------------- -------------------------

  ---------- ------------------------- -----

  -------- ---

  ----------------- ---

  ------ -
    ------ ---
    ----------- ----------

    -------- - -
      ---- ----------------------
      ----- -----------
      --------- ---- ----- ------------
    -
  -
-
展开代码

这个配置文件首先指定了 HTTP 请求所使用的用户和进程数,并设置了访问日志的格式和位置。然后定义了一个 HTTP 服务,并指定了在监听 80 端口下的应用程序,将其配置为指向 /usr/share/nginx/html 目录(即应用程序静态资源文件所在的目录),在该目录下搜索 index.html 文件作为默认文件,并使用 try_files 配置项来重定向所有的请求到 index.html,以便 SPA 应用程序可以正确呈现。

在创建好 Dockerfile 和 nginx.conf 文件后,使用以下命令可以将其打包成一个 Docker 镜像:

这个命令会将当前目录下的所有文件打包成一个名为 my-spa-app 的 Docker 镜像。打包完成后,可以通过以下命令查看所有已创建的 Docker 镜像:

此时,在运行 Docker 镜像之前,可以先通过以下命令进行本地测试:

这个命令会在本地运行一个 Docker 容器,并将容器内的 80 端口映射到主机的 8000 端口上,可通过访问 http://localhost:8000 来查看应用程序是否正常运行。测试完成后,可以通过以下命令来停止容器:

其中,<container-id> 是容器的 ID,可在运行 docker ps 命令来获取。

部署到服务器

在完成本地测试后,可以将 Docker 镜像部署到服务器上。首先,需要将 Docker 镜像上传到一个 Docker Registry(如 Docker Hub)上。可以通过以下命令将 Docker 镜像上传到 Docker Hub:

其中,username 是你在 Docker Hub 上的用户名,tag 是当前 Docker 镜像的版本号。上传完成后,就可以在服务器上下载并运行该 Docker 镜像了。

首先,在服务器上安装 Docker 环境,并使用以下命令从 Docker Hub 上拉取该镜像:

接着,可以运行以下命令将该镜像作为容器运行起来:

这个命令会在后台运行一个 Docker 容器,并将容器的 80 端口映射到主机的 80 端口上。此时,SPA 应用程序已经部署到服务器上,并可以通过访问 http://yourdomain.com 来访问了。

Nginx 部署

如果你已经熟悉了 Docker 部署的流程,并希望使用更轻量级的方式来部署 SPA 应用程序,那么你也可以选择使用 nginx 部署。在 nginx 部署时,不需要使用 Docker 来进行打包和部署,只需要安装好 nginx 服务器,并将应用程序的静态资源文件放到 nginx 静态文件目录下,并配置 nginx.conf 文件,就可以进行部署了。在以下示例中,我们假设静态资源文件已经放到了 /var/www/my-spa-app 目录下。

首先,在服务器上安装 nginx 服务器:

安装完成后,可以通过以下命令进行验证:

如果没有显示任何错误提示,说明 nginx 已经成功安装并配置好了。接着,需要设置一些必要的配置。

首先,打开 /etc/nginx/sites-available/default 文件,并修改配置如下:

-- -------------------- ---- -------
------ -
    ------ -- ---------------
    ------ ------- ---------------

    ---- --------------------
    ----- -----------

    ----------- --

    -------- - -
        --------- ---- ----- ------------
    -
-
展开代码

在这个配置文件中,我们将监听 80 端口,同时将应用程序的静态资源文件所在的目录设为 /var/www/my-spa-app,并使用 try_files 配置项来重定向所有的请求到 index.html 上。这样的设置可以使得 SPA 应用程序在访问除根路由以外的路由时不会出现 404 错误。

保存该配置文件后,使用以下命令来重启 nginx 服务器:

接着,可以通过访问服务器的公网 IP 地址来查看应用程序是否已经部署成功。

总结

通过本文,我们详细介绍了如何使用 Docker 和 nginx 来部署 SPA 应用程序,并提供了相应的示例代码。这种部署方式具有易用性高和部署灵活性强的优点,适用于需要反复部署的应用程序或需要支持多种部署环境的应用程序。希望本文能够为前端开发者们提供一种全新的部署方式,帮助大家更加高效地进行开发和部署。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/64bfa5e69e06631ab9c29f3a

纠错
反馈

纠错反馈