这个自动部署,真是把人折腾的不行,我看其他人搞好容易,结果,我这边麻烦得很。最后总结,主要原因还会因为对 docker 不熟悉造成的,网上的很多记录,只能参考一点点,摸索了一整天,终于实现了,下来重复一下整个流程,一方面记录一下,另一方面,希望有同样需求的朋友参考:
Part 1. 环境描述
通过 docker compose 安装 LNMP 环境;
git 线上用的是 coding.net
Part 2. 正确流程
以下操作都在服务器环境进行
1. 进入安装 php 的 docker 容器
1.1 ssh 登录服务器
ssh root@192.168.0.0
// @ 后的 ip 是你云服务器外部 ip
1.2 进入安装 php 的 docker 容器
docker exec -it php /bin/bash
// php:是你自己的容器 name
2. 切换用户
刚才登陆是用 root 登陆的,但 php 运行时的用户是 www-data,因此需要切换用户为 www-data
su - www-data
3. 生成配对公钥
一定要在 www-data 用户下生成公钥
ssh-keygen -t rsa -C account@email.com
// 一路回车就好,不要设置密码,否则操作 git 时会要求填写账号密码,没法自动部署
// account@email.com 是你的 coding 邮箱账号
4. 复制公钥
参考上图,找到公钥位置
cd /var/www/.ssh/id_rsa
// 你会看到两个文件:
// id_rsa:私钥,存在的服务器上,请求时自动验证;
// id_rsa.pub:公钥,将内容配置到 git 仓库(coding.net)
// 查看 id_rsa.pub,复制其中的全部内容
cat id_rsa.pub
5. 部署公钥
此操作在 coding.net 上
1)配置公钥
6. 确认公钥配置正确
ssh -T git@e.coding.net
看到以下内容,表示公钥部署成功
7. 部署 webhook 文件
1)编写 webhook.php
我是用 php ,因此 webhook 就是 PHP 文件,我的命名是 webhook.php ,你可以自定义。这里主要用到的是 php 的 shell_exec() / exec() 函数,该函数是在 php 里执行 linux 系统的 shell 脚本(我的是 /bin/bash 解释器)。以下是简单的 webhook.php 代码:
<?php
// 因为我的 webhook.php 文件,是放在项目里的,因此无须是用 cd 切换目录,直接执行拉取即可。
// 2>&1:是用来输入执行返回结果的
// 因为我只有 git pull 这一条执行项目,因此,使用了 exec(),没有使用 shell_exec()
$res = exec('git pull 2>&1');
// 打印结果
print $res;
?>
注:将 webhook.php 文件放到服务器上,你项目的地址(流程应该在 git clone 你的项目后,再复制到项目目录)
2)配置 webhook
8. 首次拉取文件
1)找到 git 地址,clone 项目到服务器
2) 进入项目上级目录
git clone git@e.coding.net:……
9. 测试自动部署
可以试着本地 git push 项目了,顺利的话,就能自动部署。如果没能成功,继续往下看,看看下面的问题详解能否解决问题。
Part 3. 遇到的问题
1. git not found(git:command not found)
这个问题,就是对 docker 不理解的一个表现,这个提示很明确没有找到 git 命令,因为我的 git 是装在服务器层面的,而不是装在 docker 容器里的,所以,很长时间,没想明白(明明装了 git 为啥提示没有)。
解决办法:就是在 php 容器的 docker 里装一次 git 。
apt-get update
apt-get install git
2. Please make sure you have the correct access rights and the repository exists.
这个人问题是在装上 git 后,git pull 拉代码时出错的,这个就是公钥配对的问题。
返回可能只返回:the repository exists
解决办法:重新部署公钥
- 删除 coding 上的 公钥
- 删除 .ssh 下的 id_rsa id_rsa.pub known_hosts 三个文件
- 再次执行上面的 第 5 步
3. git pull fatal: unpack-objects failed
// 报错如下
remote: Counting objects: 100, done
remote: Finding sources: 100% (77/77)
remote: Total 77 (delta 20), reused 60 (delta 20)
error: insufficient permission for adding an object to repository database .git/objects
fatal: failed to write object
fatal: unpack-objects failed
这是个 .git 文件夹的归属权限问题
解决办法:给用户 .git 文件夹赋予更高的权限
chown -R www-data [projectDir]
4. www-data 权限不够
将你的项目文件开启更高权限,让 www-data 访问
chmod 777 .git