[原] php + Laravel 实现部署自动化

Posted 2021-04-27 虞城工作室

所谓自动化部署， 我的理解就是在用户保证代码质量的前提下, 将代码能够快速的自动部署到目标服务器上的一种手段.

实现原理

本地推送代码 -> 代码库 -> webhook 通知服务端 -> 自动拉取代码库代码

生成并且部署公钥

具体步骤参照 配置SSH公钥

1) 生成公钥

# 使用给定的 email 生成 public/private rsa 密钥# 如果使用非默认地址需要配置 .ssh/config$ ssh-keygen -t rsa -b 4096 -C "[e-mail]"复制代码

2) 在 coding 中添加公钥

输出部署公玥

$ cat coding.pub复制代码

在git 管理端部分部署公钥

3) 配置 config 文件

编辑 ~/.ssh/config 文件

Host git.coding.net
User [e-mail]
PreferredAuthentications publickey
IdentityFile ~/.ssh/coding_rsa  // 生成的非默认地址的公钥存放点复制代码

4) 测试是否可以链接到 [e-mail] 服务器

# 注意 git.coding.net 接入到 CDN 上所以会解析多个不同的 host ip $ ssh -T [e-mail]
The authenticity of host 'git.coding.net (123.59.85.184)' can't be established. RSA key fingerprint is 98:ab:2b:30:60:00:82:86:bb:85:db:87:22:c4:4f:b1. Are you sure you want to continue connecting (yes/no)? # 这里我们根据提示输入 yes Warning: Permanently added 'git.coding.net,123.59.85.184' (RSA) to the list of known hosts. Coding 提示: Hello duoli, You've connected to Coding.net via SSH. This is a deploy key.

duoli，你好，你已经通过 SSH 协议认证 Coding.net 服务，这是一个部署公钥复制代码

设置 webhook

让代码库接收到通知的时候通知服务端接收代码更新.

这种 webhook 的方式来接收可以部署的请求, 这里的请求使用的是 post 方法

php 接收部署

因为 php 脚本代码执行的时候会可能有服务的中断(例如执行时间), 不一定符合实际, 所以计划使用脚本来调用.

收到请求 -> 存入队列 -> 脚本监听处理队列

由于使用 laravel 框架, 收到通知之后, 存入队列, 因为队列使用的是命令行监听, 所以命令行执行的时候不会出现中断情况.

在此之前需要配置运行代码的用户有权限能够访问到 git 的服务器. 也就是如果你的代码以 www-data 运行, 需要使用 www-data 的角色来访问 [e-mail] 服务器. 否则也不能实现部署, 原因是 密钥不符合而无权限获取内容.

1) 队列代码 设置 app/Jobs

<?php 
namespace App\Jobs;

use Illuminate\Contracts\Bus\SelfHandling;
use Illuminate\Contracts\Queue\ShouldQueue;
use Symfony\Component\Process\Process;

class WebDeploy extends Job implements SelfHandling, ShouldQueue
{

	private $shellPath;

	/**
	 * Create a new job instance.
	 */
	public function __construct()
	{		$this->shellPath = dirname(dirname(__DIR__));
	}

	/**
	 * Execute the job.
	 * @return void
	 */
	public function handle()
	{		if (!env('LM_DEPLOY_BRANCH')) {			echo 'ERR > ' . 'No branch Set'."\n";
		}		$shell   = "/bin/bash " . base_path('resources/shell/deploy.sh') . ' ' . base_path() . ' ' . env('LM_DEPLOY_BRANCH', 'master');		$process = new Process($shell);		$process->start();		$process->wait(function ($type, $buffer) {			if (Process::ERR === $type) {				echo 'ERR > ' . $buffer;
			}			else {				echo 'OUT > ' . $buffer;
			}
		});
	}
}复制代码

2) 触发队列

dispatch(new WebDeploy());复制代码

3) 部署 shell 脚本

#!/bin/bashaim_path=$1branch=$2cd ${aim_path}echo $PWD/usr/bin/git pull origin ${branch} >/dev/null 2>&1if [ $? -eq 0 ];thenecho "OK"else
   /usr/bin/git fetch -f
   /usr/bin/git reset --hard
   /usr/bin/git pull origin ${branch}fi复制代码

4) 使用supervisor 来监听队列执行, 监听队列任务

文件位置 /etc/supervisord.d/project.ini

[program:project_name]process_name=%(program_name)s_%(process_num)02dcommand=php /path/to/project/artisan queue:work  --sleep=3 --tries=3 --daemonautostart=trueautorestart=trueuser=apachenumprocs=1redirect_stderr=truestdout_logfile=/webdata/logs/project.logenvironment=QUEUE_DRIVER=database复制代码

注意要点

之前和同事研究自动化部署花费很长时间, 对于PHP能否胜任这个功能还是存在一点疑惑的, 之前在局域网进行部署的时候能够实现代码的部署, 但是在其余时间测试的时候则均是失败. 本次换了这种方式找到了一种方式来运行脚本. 理论上不会存在执行不成功的时候, 直到看到了如下的报错:

OUT > /webdata/www/sour-lemon.com
ERR > Could not create directory '/usr/share/httpd/.ssh'.
ERR > Host key verification failed.
ERR > fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists.复制代码

因为当前 shell 运行的用户是 apache , 所以在调用的时候会以 apache 的身份去调用这个请求, 故而出现了 Could not create directory '/usr/share/httpd/.ssh', 所以就考虑用 apache 权限去设置 ssh 的自动化部署.

由于 apache 用户是处于不允许登陆状态, 需要首先允许其登录, 然后再设置相应的 ssh key.

更改文件 /etc/passwd 允许用户登录

# 之前是 /sbin/nologinapache:x:48:48:Apache:/usr/share/httpd:/bin/bash复制代码

然后再切换到 apache 用户来进行 ssh key 设定, 这样经过测试, 通过.

参考文章

• Github 访问时出现Permission denied (public key)

• 配置SSH公钥

• gist.github.com/jexchan/235…

• www.freebsd.org/cgi/man.cgi…

• help.github.com/articles/er…

• callmepeanut.blog.51cto.com/7756998/130…

• www.huamanshu.com/walle.html

• walle-web.io/

• github.com/meolu/walle…

• www.phptesting.org/install-php…