编程

使用 Deployer 简化 PHP 部署

279 2024-08-23 02:49:00

有选择是件好事,但选择太多往往比选择太少更糟糕。你有可能变得不知所措、困惑,甚至瘫痪。来了解最简单的 PHP 部署工具。

Phing、Jenkins、Capistrano、Capifony、Deploybot、PHPCI、Rocketeer、Teamcity、Envoyer.. 这份名单能持续多久?

我一直在寻找一种简单的方法来部署我自己的应用。

这是一个小项目,还没有带来任何收入。所以我只能证明有限的时间是合理的。所以我一直在寻找可以快速集成并开始部署的东西。

太多的选择可能不是好事

不要误解我的意思,选择可能是一件好事,但有时选择太多比选择太少更糟糕,因为你会变得不知所措、困惑,最终瘫痪——最终的结果是你什么都不做。

其中一些工具功能齐全,这可能会导致学习曲线较大,延迟首次部署,而另一些工具则需要付出经济代价。

我渴望找到的是一种可行的解决方案,但只需最少的时间和金钱投入就能启动和运行。理想情况下,这是一个同样用 PHP 编写的解决方案,我可以在开发过程中对其进行高度配置和定制。

方案

Deployer 是一个用 PHP 编写的开源部署管理工具。它是一个快速、模块化的 PHP 部署工具;支持回滚、原子部署、并行任务和跨多个服务器(无论是本地还是远程)的一致部署。

更重要的是,它创建了一系列版本,当前目录指向最新版本。这样,如果有任何问题,你始终可以快速回滚到早期版本。

Deployer 表现如何?

当然,从安装、配置要部署的服务器、部署任务和环境设置开始,还有一些需要学习的地方。但是部署器配置文件的编写方式很容易学习,不需要大量的配置。

如果你的需求很简单,那么你的配置文件也很简单。更重要的是,你可以从一个极简主义的配置文件开始,并随着需求的增长而构建它。

你无需太多软件

这是部署人员的另一个优点,你不需要很多基础设施即可开始。你只需要三件事:

  1. 部署的服务器: 当然,你需要准备好这些设置,以便部署到
  2. PHP 5.4: 虽然我一直鼓励使用最新版本(撰写本文时是 5.6),但 5.4 是最低支持版本
  3. Git: 你需要获取最新的代码,这些代码将受到版本控制。

其他是可选的

没错,其他所有内容都是可选的额外内容,或者可以合理地预期在您的 Linux 托管帐户中可用。

当然,在更复杂的设置中,你可能会清除和预热缓存,无论是文件系统还是 Redis 和 Memcached 等外部服务器,确保目录存在并且可写,等等。

但是,这些都可以通过操作系统上的工具合理地处理,这些工具应该已经可用。

创建部署

如果这听起来像是一个适合你的工具,那么现在就开始运行吧!让我们来看一个简单的部署器配置示例,你可以根据自己的需求使用它,并在接下来的 30 分钟内启动并运行。听起来不错吧?

假设你已经准备好了一个项目,通过在项目目录的根目录中运行 composer require deployer/deployer:~3.0 来获取部署程序的副本。

接下来,创建一个名为 deployer.php 的新文件。在其中,添加以下配置,我们将逐步完成。在我们这样做之前,最终结果将是本地和远程部署。我假设你在远程服务器上运行 Nginx。如果你正在运行 Apache,请根据需要替换它。

<?php

require 'vendor/autoload.php';
require 'recipe/composer.php';

首先,我们引入 Composer 自动生成的自动加载文件和 Composer 配方(recipe)文件。用 deployer 的话说,配方(recipe)是一组预先编写的任务,你可以使用它们,而不是自己编写。

localServer('testing')
    ->user('my_user')
    ->stage('testing')
    ->env('deploy_path', '/path/to/local/deployment/directory');

server('production', 'staging.example.com', '22')
    ->user('username')
    ->password('password')
    ->stage('production')
    ->env('deploy_path', '/path/to/remote/deployment/directory');

接下来,我们创建两个服务器配置,一个用于测试的本地服务器和一个用于生产的远程服务器。通过使用流畅的界面,设置每种情况下所需的所有选项几乎是轻而易举的。

对于本地服务器,我们指定了用户名、阶段名称和部署路径。对于远程服务器,我们指定了要连接的主机名和端口、用户名和密码、阶段名称和部署路径。

还有一系列其他选项,你可以在服务器文档中找到。

set('repository', 'https://github.com/settermjd/some.repository.git');

接下来,我们添加一些部署程序配置设置,特别是包含项目代码的 Git 存储库。你可以根据需要设置许多其他全局变量。

task('deploy:done', function () {
    write('Deploy done!');
})->desc("When deployment's completed");

task('reload:php-fpm', function () {
    run('sudo /usr/sbin/service php5-fpm reload');
})->desc('Reload PHP5 FPM');

现在我们来了解配置的核心,即部署任务。你可以看到,任务需要一个名称和一个闭包,或者如果你正在构建一个任务库,那么调用起来很方便。

第一个任务只是打印出部署已完成的消息,第二个任务重新加载 PHP5 FPM 服务。你可以在此处添加任何内容,这些内容通常可以从命令行运行。

after('deploy', 'reload:php-fpm');
after('deploy', 'deploy:done');

快完成了。现在我们来看一些事件。这些可以是之前或之后。在这里,我们连接到了部署事件,将我们的两个自定义任务设置为在部署完成后运行。在这种情况下,FPM 将重新加载,“Deploy done” 消息将打印出控制台。

task('deploy', [
    'deploy:prepare',
    'deploy:release',
    'deploy:update_code',
    'deploy:vendors',
    'deploy:symlink',
    'cleanup'
])->desc("Main deployment process");

最后一件事,我们已经准备好运行了——核心部署任务。在这个例子中,部署由一系列其他任务组成。简而言之,这将从指定的存储库中提取最新版本的代码,运行 Composer 安装,并将符号链接到最新版本。

运行部署

安装并配置所有内容后,要从命令行运行部署,请运行以下命令:

vendor/bin/dep deploy production

这将把你的应用部署到生产服务器。

总结

只需 30 分钟,你就可以运行第一个部署,只需几行 PHP 代码。没有复杂的服务器设置,没有其他服务需要配置和运行,几乎什么都没有。它与你现有的部署解决方案相比如何?