舒孝元博客

[TOC]

## 安装

` composer global require deployer/deployer `

安装完成后，再命令行输入 `dep` 能看到如下内容表示成功（如果没有，自己手动添加环境变量或软链接）

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/Articles/20220926/20220926222621.png)

### 说在前面的话
因为 deployer 是一个基于 ssh 协议的，所以在服务器上最好专门建一个账号来部署，你直接用 root 也是可以的，嘿嘿嘿

- 接下来都是在服务器上建立账号的操作，如果你用 root 用户，这部分可以直接跳过

1. 新建 deployer 账号 `adduser deployer` 设置密码 `passwd  ********
1. 将 deployer 用户加入 Nginx 用户组 `usermod -aG nginx deployer`
1. 设置 deployer 用户权限分别设置为创建文件 644 与目录 755
```
su deployer
echo "umask 022" >> ~/.bashrc
```
1. 将 depoloyer 用户加到 sudoers 中
```
vim /etc/sudoers
# 添加下面一条命令后保存退出
deployer ALL=(ALL) NOPASSWD: ALL
```
1. 设置项目目录权限 `sudo chown deployer:nginx /www` 和 `chmod g+s /www`
1. 确保 PHP、npm、Nginx、composer 等命令能在 deployer 用户下能使用

## 配置 git 权限
如果你的 git 仓库不是公开的，那么最好添加 ssh 公钥来克隆代码
```
su deployer # 切换用户
ssh-keygen -t rsa -b 4096 -C "deployer" # 这里的 -C 是指定备注
cat ~/.ssh/id_rsa.pub # 显示公钥
```
将公钥配置到 GitHub，gitlab，gitee等处

## 服务器免密登录--在自己本地开发机上操作
在本地部署的时候，如果不想每次输入密码，可以本地设置 ssh 免密登录
1. 生成 deployer 专用密钥 `ssh-keygen -t rsa -b 4096 -f  ~/.ssh/deployerkey`
1. 拷贝公钥到目标服务器，（还是在本地操作）` ssh-copy-id -i  ~/.ssh/deployerkey.pub deployer@106.15.238.9` 输入相应的密码即可，如下图所示
1. 测试是否能免密登陆 `ssh deployer@106.15.238.9 -i ~/.ssh/deployerkey`

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191031/20191031141318.png)

如果出现以下错误： `WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!` 说明是你服务器的指纹已经更改，可能是该主机重装系统了，解决办法是进入 ` ~/.ssh` 目录，找到 `known_hosts` 文件，打开，删除前面的 IP 即可

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191107/20191107183627.png)

## 准备工作搞完，开始部署

## 初始化配置文件

输入 `dep init` 看到如下图所示，我们是 laravel 项目，选择 1 就可以了，选择 1 之后是确认项目 git 地址，如果无误直接回车即可(也有说不能使用 https，要使用 ssh，等我试验成功后告诉你们 )，回车之后会出现一个是否同意收集数据，帮助他们改善的。这个无所谓，看你心情，最后有个确定，输入 yes 即可，然后在项目的根目录就会多一个 `deploy.php` 的文件，接下来就要准备配置里面的东西了

![](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191030/20191030182518.png)

## 配置文件准备完毕，开始部署

输入：`dep deploy -vvv`，正常情况下应该会看到如下所示，看到放回成功之后就表示 OK 了，如果你用的 Windows 系统的话，很遗憾，会报错，我也不知道怎么解决，找了好久没找到解决方案，如果你有，请告知我一下，万分感谢

![图一](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191124/20191124142416.png "图一")
![图二](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191124/20191124142456.png "图二")

## 部署成功后服务器上的目录结构和注意事项
目录结构图如下：
![图三](https://shuxiaoyuan-201812.oss-cn-shanghai.aliyuncs.com/sxy_Blog/20191124/20191124143611.png "图三")

目录结构说明：
- current ： 是到最新版本的符号链接， Nginx 就应该指向这个目录下的 public 目录（注）
- .dep ： 包含用于部署程序的特殊元数据（发行日志，deploy.log 文件等）
- releases ： 包含 Laravel 应用程序的部署版本
- shared ： 包含 .env 、 storage 等，它将与每个发行版符号链接

> 注：如果 web 服务器采用的是 Nginx + php-fpm 的话，请一定要注意权限问题，php-fpm 默认用户和用户组都是 Apache ，比如我的服务器上面就将 php-fpm 的用户和用户组修改成了 deployer:nginx ，还有需要重启 php-fpm ，可以在配置文件里面设置

## 附录一：注意事项
- 第一次部署，因为 `.env` 文件的问题，可能会导致数据库迁移失败，可以在配置文件里面定义上传你的 `.env` 文件或者是通过其他机制
- 需要重启 php-fpm 也可以在配置文件里面设置
- 发现自动 `composer install` 的时候 `require-dev` 里面的包没有安装，可以在配置文件里面手动再次执行一遍
- 会执行 `php artisan config:cache` 所以最好在控制器中使用 `env('APP_NAME')` 会返回 null ，具体看文档
- 可以查看整个部署过程，你会明白很多东西的

## 附录二：我的项目配置
```
<?php

namespace Deployer;

require 'recipe/laravel.php';

// 项目名
set('application', 'laravel_dev');

// 项目仓库地址，不要使用https
set('repository', 'git@gitee.com:shuxiaoyuan/laravel.git');

// 这是个啥，还不懂
set('git_tty', true);

// 分享文件即目录，通常也不用改，默认包含了 storage 目录
add('shared_files', []);
add('shared_dirs', []);

// 可写目录，一般不用改
add('writable_dirs', []);

// 保存最近五次部署，这样的话回滚最多也只能回滚到前 5 个版本
set('keep_releases', 5);

// 目标主机配置，这个里面是重头戏
host('106.15.238.9')    //这里填写目标服务器的 IP 或者域名
	// 指定用户
	->user('deployer')

// 指定公钥的位置，这个是你本机的那个密钥，免密登录的那个
    ->identityFile('~/.ssh/deployerkey')

// 指定项目部署到服务器上的哪个目录
    ->set('deploy_path', '/www/laravel_dev');

// 自定义任务：重启 php-fpm 服务
task('reload:php-fpm', function () {
    run('sudo systemctl restart php-fpm');
});
after('deploy', 'reload:php-fpm');

// 将本地的 env 文件上传到服务器的 shared 目录下
//task('upload', function () {
//    upload('.env', '{{shared_path}}/.env');
//});
// after('deploy', 'upload');

// 如果部署失败，自动解除部署锁定状态，以免影响下次执行
after('deploy:failed', 'deploy:unlock');

// 执行数据库迁移，建议删掉，迁移虽好，但毕竟高风险，只推荐用于开发环境。
before('deploy:symlink', 'artisan:migrate');

```

Deployer部署