部署学习日志

要注册账户，请访问 https://platform.sh 并单击 "免费试用" 按钮。目前，Platform.sh 有一个免费层，不需要信用卡。在试用期内，您可以使用最少的资源部署应用程序，这样您就可以在使用付费托管计划之前在实时部署中测试您的项目。

要在 Platform.sh 上部署和管理项目，您需要命令行界面 (CLI) 中提供的工具。要安装最新版本的 CLI，请访问 https://docs.platform.sh/development/cli.xhtml ，并按照操作系统的说明进行操作。

在大多数系统中，您可以通过在终端运行以下命令来安装 CLI：

运行该命令后，您需要打开一个新的终端窗口，然后才能使用 CLI。

你还需要安装一个额外的软件包，即 platformshconfig。该软件包可帮助检测项目是在本地系统上运行，还是在 Platform.sh 服务器上运行。在活动的虚拟环境中，发出以下命令：

当项目在实时服务器上运行时，我们将使用该软件包修改项目设置。

远程服务器需要知道 Learning Log 依赖于哪些软件包，因此我们将使用 pip 生成一个文件，列出这些软件包。同样，在活动的虚拟环境中，发出以下命令：

freeze 命令会让 pip 将项目中当前安装的所有软件包名称写入 requirements.txt 文件。打开该文件可查看项目中安装的软件包和版本号：

Learning Log 已经依赖于七个不同软件包的特定版本，因此它需要一个匹配的环境才能在远程服务器上正常运行。(我们手动安装了其中三个软件包，另外四个是作为这些软件包的依赖项自动安装的）。

当我们部署学习日志时，Platform.sh 会安装 requirements.txt 中列出的所有软件包，创建一个与我们本地使用的软件包相同的环境。正因为如此，我们可以确信部署后的项目会像在本地系统上一样正常运行。当你开始在系统上构建和维护多个项目时，这种管理项目的方法至关重要。

实时服务器需要两个额外的软件包。这些软件包用于在生产环境中为项目提供服务，因为在生产环境中可能会有许多用户同时提出请求。

在保存 requirements.txt 的同一目录下，新建一个名为 requirements_remote.txt 的文件。添加以下两个软件包：

gunicorn 软件包会响应远程服务器收到的请求；它取代了我们在本地使用的开发服务器。需要使用 psycopg2 软件包来让 Django 管理 Platform.sh 使用的 Postgres 数据库。Postgres 是一个开源数据库，非常适合生产应用程序。

每个托管平台都需要一些配置，项目才能在其服务器上正常运行。在本节中，我们将添加三个配置文件：

这些都是 YAML（YAML 不是标记语言）文件。YAML 是一种专为编写配置文件而设计的语言，人类和计算机都能轻松读取。您可以手动编写或修改典型的 YAML 文件，但计算机也可以读取并明确解释该文件。

YAML 文件非常适合部署配置，因为它能让你很好地控制部署过程中发生的事情。

现在，我们需要在 settings.py 的末尾添加一个部分，以修改 Platform.sh 环境的一些设置。将此代码添加到 settings.py 的末尾：

我们通常将导入语句放在模块的开头，但在这种情况下，将所有远程特定设置放在一个部分会很有帮助。这里我们从 platformshconfig ❶ 中导入 Config，它有助于确定远程服务器上的设置。只有当 config.is_valid_platform() 方法返回 True ❷，表明设置正在 Platform.sh 服务器上使用时，我们才修改设置。

我们修改 ALLOWED_HOSTS，以允许项目由 .platformsh.site ❸ 结尾的主机提供服务。所有部署到免费层的项目都将使用该主机。如果在部署的应用程序目录❹ 中加载设置，我们会设置 STATIC_ROOT，以便正确提供静态文件。我们还在远程服务器 ❺ 上设置了更安全的 SECRET_KEY。

最后，我们配置生产数据库 ❻。只有在构建过程结束、项目正在运行时，才会设置该数据库。这里的所有内容都是让 Django 与 Platform.sh 为项目设置的 Postgres 服务器进行对话所必需的。

正如第 17 章所述，Git 是一种版本控制程序，每次成功实现一个新功能时，都能为项目中的代码拍摄快照。例如，在开发新功能时不小心引入了一个 Bug，如果出了什么问题，你可以很容易地返回到上次的项目快照。每个快照称为一次提交。

使用 Git，您可以尝试实现新功能，而不必担心会破坏您的项目。在部署到实时服务器时，需要确保部署的是项目的工作版本。要了解有关 Git 和版本控制的更多信息，请参阅附录 D。

此时，Learning Log 项目仍在本地系统上运行，并已配置为可在远程服务器上正常运行。我们将使用 Platform.sh CLI 在服务器上创建一个新项目，然后将项目推送到远程服务器。

确保在终端中的 learning_log/ 目录下，发出以下命令：

该命令将打开一个浏览器标签页，在此登录。登录后，可以关闭浏览器标签页并返回终端。如果系统提示创建 SSH 配置文件❶，请输入 Y，以便稍后连接远程服务器。

现在我们将创建一个项目。输出内容很多，因此我们将分段查看创建过程。首先发出创建命令：

第一个提示询问项目的名称 ❶，因此我们使用 ll_project。下一个提示询问我们希望服务器位于哪个地区 ❷。选择离你最近的服务器；对我来说，就是 us-3.platform.sh。对于其他提示，你可以接受默认值：最低开发计划的服务器❸，项目的三个环境❹，以及整个项目的 5GB 存储空间❺。

还有三个提示需要回答：

一个 Git 仓库可以有多个分支；Platform.sh 会询问我们项目的默认分支是否为 main ❶。然后它会询问我们是否要将本地项目的仓库连接到远程仓库 ❷。最后，我们会被告知，如果在免费试用期❸ 之后继续运行该项目，每月将花费约 10 美元。如果你还没有输入信用卡，就不必担心这笔费用。如果您在没有添加信用卡的情况下超过了免费试用期的限制，Platform.sh 会简单地暂停您的项目。

在看到项目的实时版本之前，最后一步是将代码推送到远程服务器。为此，请执行以下命令：

当你发出 platform push 命令时，系统会再次要求你确认是否要推送项目 ❶。如果这是你第一次连接网站 ❷，你可能还会看到一条关于 Platform.sh 真实性的信息。在每个提示下输入 Y，就会看到大量输出滚动显示。这些输出结果一开始可能会让人一头雾水，但如果出了什么问题，这些输出结果在故障排除过程中会非常有用。如果略微浏览一下输出，就会发现 Platform.sh 安装了必要的软件包、收集了静态文件、应用了迁移并为项目设置了 URL。

推送完成后，就可以打开项目了：

platform url 命令会列出与已部署项目相关联的 URL；你可以选择多个 URL，这些 URL 对你的项目都有效。选择其中一个，你的项目就会在新的浏览器标签页中打开！这看起来就像我们在本地运行的项目一样，但你可以将此 URL 分享给世界上的任何人，他们都可以访问并使用你的项目。

现在，我们将通过创建超级用户来完善部署，就像在本地所做的那样。我们还将把 DEBUG 设置改为 False，这样错误信息就不会向用户显示任何可能用于攻击服务器的额外信息，从而使项目更加安全。

在第 19 章中，我们配置了学习日志，如果用户请求不属于自己的主题或条目，学习日志会返回 404 错误。现在你也看到了 500 服务器错误。

404 错误通常意味着你的 Django 代码是正确的，但请求的对象不存在。500 错误通常意味着您编写的代码有误，例如 views.py 中的函数出错。Django 目前会在这两种情况下返回相同的通用错误页面，但我们可以编写自己的 404 和 500 错误页面模板，使其与学习日志的整体外观相匹配。这些模板属于根模板目录。

在首次推送到实时服务器后，你可能想进一步开发学习日志，或者想开发自己的项目进行部署。在这样做时，更新项目的流程相当一致。

首先，你要对本地项目进行必要的修改。如果改动后产生了新文件，则使用 git add 命令将这些文件添加到 Git 仓库（确保在命令末尾加上圆点）。任何需要迁移数据库的改动都需要这条命令，因为每次迁移都会生成一个新的迁移文件。

其次，使用 git commit -am "commit message" 将更改提交到版本库。然后使用 platform push 命令将更改推送到 Platform.sh。访问您的实时项目，确保您希望看到的更改已经生效。

在此过程中很容易出错，所以出错时不要惊讶。如果代码无法运行，请检查您所做的工作，并尝试找出错误所在。如果找不到错误或不知道如何纠正，请参考附录 C 中的求助建议。不要羞于寻求帮助：每个人都是通过提出与你可能提出的相同的问题来学习构建项目的，因此有人会很乐意帮助你。解决出现的每一个问题都有助于稳步提高你的技能，直到你能构建出有意义、可靠的项目，并能回答其他人的问题。

对同一个项目或一系列小项目进行多次部署，以掌握部署的窍门，是一种很好的做法。但你需要知道如何删除已部署的项目。此外，Platform.sh 还限制了免费托管项目的数量，你也不想让实践项目弄乱你的账户。

您可以使用 CLI 删除项目：

系统会要求您确认是否要采取这一破坏性操作。按照提示操作，你的项目就会被删除。

命令 platform create 还为本地 Git 仓库提供了 Platform.sh 服务器上远程仓库的引用。你也可以从命令行中删除这个远程仓库：

git remote 命令会列出与当前版本库关联的所有远程 URL 的名称。git remote remove remote_name 命令会从本地版本库中删除这些远程 URL。

你也可以登录 Platform.sh 网站，访问 http s://console.platform.sh 上的控制面板来删除项目资源。此页面列出了所有活动项目。单击项目框中的三个点，然后单击编辑计划。这是项目的定价页面；单击页面底部的删除项目按钮，您将看到一个确认页面，可以在此完成删除操作。即使你使用 CLI 删除了项目，最好还是熟悉一下你部署的任何托管提供商的仪表板。

在本章中，您将学习如何使用 Bootstrap 库和 django-bootstrap5 应用程序为您的项目打造简洁而专业的外观。有了 Bootstrap，您选择的样式几乎可以在人们访问项目时使用的任何设备上一致运行。

您了解了 Bootstrap 的模板，并使用导航栏静态模板为学习日志创建了简单的外观和感觉。你使用了跳线来突出主页的信息，并学会了如何统一网站中所有页面的样式。

在项目的最后一部分，你们学习了如何将项目部署到远程服务器上，以便任何人都能访问。你创建了一个 Platform.sh 账户，并安装了一些有助于管理部署过程的工具。你使用 Git 将工作项目提交到版本库，然后将版本库推送到 Platform.sh 上的远程服务器。最后，你学会了通过在实时服务器上设置 DEBUG = False 来开始保护应用程序的安全。你还制作了自定义错误页面，这样就能很好地处理不可避免的错误。

现在，您已经完成了学习日志，可以开始构建自己的项目了。从简单的开始，在增加复杂性之前确保项目能正常运行。祝你学习愉快，项目顺利！