README

将您的应用程序部署到远程位置的一种简单方法。

要求

• October CMS 2.1.20 或更高版本
• PHP openssl 扩展
• PHP eval 函数

安装

php artisan plugin:install rainlab.deploy

为什么需要此插件？

此插件有助于在您的远程服务器（生产、测试等）无法使用 composer 或 shell 访问受限的情况下，例如共享主机。

工作原理

Deploy 插件通过在您的本地开发环境与您的托管服务器之间创建安全通道来工作。然后，插件、主题和核心文件被压缩并安全地发送到您的服务器，并在远程安装。这种方法类似于更新网关，但文件是推送到服务器的。

升级较旧的 October CMS 版本

您可以使用此插件作为将您的网站升级到 October CMS 更新版本的解决方案，例如，如果您想将 v1 网站升级到 v2。在执行这些步骤之前，始终备份整个网站。

1. 在本地计算机上安装或升级到最新的 October CMS 版本
2. 将 Beacon 文件部署到要升级的旧网站
3. Deploy 插件将在其第一次部署期间尝试升级网站

如果您需要在此过程中获得支持，请随时向帮助台发送电子邮件。

文档

在开始之前，您应该在您的托管管理器中设置一个新的站点，并理想情况下有一个空数据库。您也可以将这些说明应用于现有网站，包括 October CMS 的旧版本，但是，请确保您已备份整个站点以防止出现错误。

为了安全起见，deploy 插件永远不会删除文件。它只会覆盖并创建新文件。如果您需要删除某些内容，您应该直接在服务器上操作。

控制面板设置

安装此插件后，转到 October CMS 控制面板的“设置”>“Deploy”，然后单击“创建服务器”。

1. 输入您站点的 Web 地址（例如：https://mycpanelwebsite.tld/）
2. 生成一个新的 RSA 私钥，或输入现有的一个以设置现有服务器
3. 下载 Beacon ZIP 文件

Beacon 部署

在您的 Beacon ZIP 文件中，您应该注意以下文件

• index.php
• bootstrap/app.php
• bootstrap/autoload.php
• bootstrap/beacon.php

您可以将这些文件上传到任何位置，它们将成为 October CMS 部署的目标。您可以使用 FTP 或托管控制面板中的文件管理器。

重要：上传文件的目录必须由您的 Web 服务器可写（例如：apache 的权限 755）。

运行第一次部署

一旦您已将 Beacon 部署到远程服务器并设置好本地服务器，就是时候执行您的第一次部署了。

诊断 Beacon 响应

有时您可能会看到一个错误，表示找不到有效的 beacon 响应。

首先尝试点击“检查信标”链接，以确保信标处于激活状态，如果显示为不可达，请尝试下载信标文件并将它们再次上传到您的服务器。

您可以通过捕获服务器或信标的原始响应来执行更高级的故障排除。要捕获信标的原始响应，请执行以下操作。

1. 将?debug=1添加到后端URL的末尾。
2. 再次点击“检查信标”或执行部署操作。
3. 检查storage/logs中的日志文件，以查看服务器响应了什么。

这应该可以提供一些关于为什么响应不被接受的见解。

使用.deployignore忽略文件

有时您可能不希望某些文件被部署，例如插件和主题中使用的node_modules目录。这可以通过在插件或主题的基础目录中创建一个.deployignore文件来实现。此文件的行为与.gitignore文件相同，您可以在其中配置Git以忽略您不希望检入的文件。

以下.deployignore文件将排除node_modules目录

node_modules/

该文件必须位于主题或插件的基础目录中。例如

• themes/demo/.deployignore
• plugins/acme/demo/.deployignore

许可证

此插件是October CMS平台的官方扩展，如果您拥有平台许可证，则可以免费使用。有关详细信息，请参阅EULA许可证。