Swift5.3-Vapor4教程(二)

Heroku是一种流行的托管解决方案,可简化Web和云应用程序的部署.支持多种语言和多种数据库. 设置方法有很多(浏览器中设置,终端设置等等我们只简单介绍一种.文章最后再介绍一下vapor heroku命令)
注意:无论是哪一种部署请无比检查好项目文件确保项目中包含LinuxMain.swift文件.如果没有需要自己创建一个.

文件名

LinuxMain.swift

文件内容

import XCTest
@testable import MonoGeneratorTests

XCTMain([
     testCase(GeneratorTests.allTests),
])

最终的样式

image.png

设置Heroku

如果你还没有Heroku账户,点击这里注册一个.

安装CLI

有了Heroku帐户后，请安装Heroku CLI工具。在macOS上安装的最简单方法是通过Homebrew。在终端中，输入：

brew install heroku/brew/heroku

登录

安装了Heroku CLI后，您需要登录到您的帐户。在终端中，输入：

heroku login

按照提示输入您的电子邮件和密码。登录后，可以通过检查whoami以确保其输出正确的电子邮件来验证成功。使用以下命令：

heroku auth:whoami

到此为止,我们已经完成了Heroku在系统上的所有设置.接下来进行项目的创建和使用.

创建第一个应用程序(第一种方式)

在浏览器中访问heroku.com来创建第一个应用程序.打开heroku.com应该已经进入dashboard.heroku.com. 如果没有,清重新登录并重试.在dashboard页面右上角有一个按钮New. 点击并选择Create new app

image.png

输入应用名称

在下一个屏幕上，选择部署区域和唯一的应用程序名称。如果您不想选择应用程序的名称，请将该字段保留为空白，Heroku会自动生成一个唯一的标记来为您标识应用程序。无论您是创建名称，还是Heroku为您分配名称，请记下名称；您将在以后配置应用程序时使用它。

点击创建应用

image.png

应用创建完成之后,接下来就是把本地项目部署到Heroku

Git

Heroku使用Git部署您的应用程序，因此您需要将项目放入Git存储库(如果尚未安装)。首先，确定您的应用程序是否已具有Git存储库。为此，请在终端中输入以下命令：

git rev-parse --is-inside-work-tree

如果输出到ture.如果不是 需要初始化一个git储存库.如果是请直接跳过初始化.

初始化Git

如果需要将Git添加到项目中,请在终端输入以下命令:

git init

Branch

Heroku部署master分支。确保您在此分支上，并且已合并要部署的所有更改。
要查看您当前的分支，请在终端中输入以下内容：

git branch

输出将类似于以下内容。旁边带有星号的分支是当前分支：

* master
  commander
  other-branches

如果您当前不在master上，请输入以下命令切换到master：

git checkout master

提交变更

确保所有更改都在您的master分支中并已提交。您可以通过输入以下命令进行验证。如果看到任何输出，则表示您尚未提交更改。

git status --porcelain

如果您有未提交的更改，请输入以下命令以提交更改：

git add .
git commit -m "Jianshu Vapor Description"

这样可以确保您的项目在本地存储库中。

与Heroku连接

Heroku需要在Git存储库上配置另一个远程服务器。在终端中输入以下命令，jianshuvapor是我创建的项目名(自己创建的项目自行更改)：

heroku git:remote -a jianshuvapor

设置Buildpack

Heroku使用一种称为Buildpack的东西来提供部署应用程序时的配方。蒸气社区当前提供了一个为蒸气应用设计的Buildpack。要为您的应用程序设置Buildpack，请在终端中输入以下内容：

heroku buildpacks:set https://github.com/vapor-community/heroku-buildpack

Swift Version File

既然已经设置了Buildpack，Heroku需要几个配置文件。其中第一个是.swift-version。Buildpack使用它来确定要为项目安装哪个Swift版本。在终端中输入以下命令：

echo "5.3" > .swift-version

程序文件Procfile

一旦在Heroku上构建了应用程序，Heroku需要知道要运行哪种类型的流程以及如何运行它。为了确定这一点，它利用了一个名为Procfile的特殊文件。输入以下命令来创建您的Procfile：

echo "web: Run serve --env production" \
  "--hostname 0.0.0.0 --port \$PORT" > Procfile

部署到Heroku

现在您可以将应用程序部署到Heroku。将主分支推送到Heroku远程服务器，然后等待所有内容构建。这可能需要一段时间，尤其是在大型应用程序上。

要开始，请在终端中输入以下内容：

git push heroku master

一切部署完成后，Heroku会通知您应用程序的状态。Heroku通常在完成构建后会自动启动您的应用程序。万一没有发生这种情况，请在终端中输入以下内容以启动您的应用程序：

heroku ps:scale web=1

通过访问应用程序URL打开应用程序，如浏览器中Heroku仪表板的“设置”标签中所示。您还可以通过在终端中输入以下内容，在浏览器中打开网站：

heroku open

到此属于详细的介绍已经结束

接下来介绍一下vapor heroku命令(第二种方式)

注意两种方式的前面的步骤相同:验证LinuxMain.swift文件、安装CLI、注册登录Heroku.
上述过程完成之后
使用终端进入工程文件目录并直接在终端使用vapor heroku命令
配置Heroku中程序的环境:

vapor heroku init

第一步选择国家

image.png

第二步选择部署环境

image.png

第三步选择Swift的版本号

image.png

第四步是否使用默认的Buildpack

image.png

这里我们需要手动配置一个buildpack包
所以输入n 然后会需要输入包地址如下

image.png

https://github.com/vapor-community/heroku-buildpack

终端接下来提醒是否提交更改?如图直接输入y提交即可

image.png

是否直接部署?如图 输入y选择部署

image.png

其中vapor heroku命令中除了vapor heroku init之外还有一个手动推送的命令vapor heroku push.以后的使用过程中每次更改后手动推送命令还是比较多的.

由于使用这种方式默认创建的项目名称是随机的.下面附上更改项目名称的命令:

heroku apps:rename newname