drone它是一种持续集成的工具，可以利用强大的云原生管道引擎自动化其施工、测试和发布工作流； 简单来说：类似写shell只是脚本内容不同； 其它jenkins、gitlab-cicd；

• linux系统
• docker

gitlab点击此处详细安装步骤；本次使用的gitlab-ce是docker hub2022年5月最新版仓库：

• 如果hostname没做DNS请使用域名分析IP地址(不写端口，默认80)。例子:192.168.200.30 注意：hostname不包括端口，否则gitlab无法启动；

export GITLAB_HOME=/mydata/gitlab docker run --detach \   --hostname "192.168.200.30" \   --publish 1443:443 --publish 80:80 --publish 1022:22 \   --name gitlab \   --restart always \   --volume $GITLAB_HOME/config:/etc/gitlab \   --volume $GITLAB_HOME/logs:/var/log/gitlab \   --volume $GITLAB_HOME/data:/var/opt/gitlab \   gitlab/gitlab-ce:latest 

• 报错信息(以下步骤):下图是因为gitlab的hostname填写的域名（gitlab.admin.com），结果Drone流水线clone(克隆)代码连接报错:

除了修改上图中的问题gitlab主机名（hostname）还可以修改drone-runner默认clone(克隆)地址解决方案。如下代码（这里看不懂也没关系。请继续往下看，以后再解释。）：

Drone需要安装部署docker-server（Drone 与流行的源代码控制管理提供商无缝集成) WEB界面和docker-runner守护过程执行器

• 创建一个共享密钥，用于drone-runner和drone-server两者之间的通信：

[root@master drone]# openssl rand -hex 16 8172cd9155d16593d4f6a445b70ed6e

• 部署drone-server：

docker run \
  --volume=/var/lib/drone:/data \
  --env=DRONE_GITLAB_SERVER=http://192.168.200.30/ \ #GitLab 服务器 url，默认https://github.com
  --env=DRONE_GITLAB_CLIENT_ID=56ef91f20270b6f945f722e2b93e2e9eacad65f0b5edcad997d4842df47cc5a8 \ #GitLab oauth 客户端 ID（必填项）
  --env=DRONE_GITLAB_CLIENT_SECRET=159ab07250d7b02f171408a1a6e21f506295b33b5174c211b7dcb59b548e05a3 \ #GitLab oauth 客户端密码 （必填项）
  --env=DRONE_RPC_SECRET=8172cd9155d16593d4f6a445b70e2d6e\  #验证服务器和运行器之间的 rpc 连接（drone-server和drone-runner连接时必填项）
  --env=DRONE_SERVER_HOST=192.168.200.30:82 \ #供drone服务主机名或 IP 地址 （必填项）
  --env=DRONE_SERVER_PROTO=http \  #drone服务使用的协议 （必填项）
  --publish=82:80 \
  --publish=443:443 \
  --restart=always \
  --detach=true \
  --name=drone \
  --env=DRONE_USER_CREATE=username:root,admin:true \  #Drone管理员用户创建 
  drone/drone:2

 * drone启动参数很多，下面解释下：
	+ DRONE_GITLAB_SERVER： GitLab 服务器 url，默认https://github.com
	+ DRONE_GITLAB_CLIENT_ID： GitLab oauth 客户端 ID（必填项）
	+ DRONE_GITLAB_CLIENT_SECRET： GitLab oauth 客户端密码 （必填项）
	+ DRONE_RPC_SECRET： 验证服务器和运行器之间的 rpc 连接（drone-server和drone-runner连接时必填项）
	+ DRONE_SERVER_HOST： 提供drone服务主机名或 IP 地址 （必填项）
	+ DRONE_SERVER_PROTO： drone服务使用的协议 （必填项）
	+ DRONE_USER_CREATE： Drone管理员用户创建

• 部署drone-runner

  docker run --detach \  
  --volume=/var/run/docker.sock:/var/run/docker.sock \
  --env=DRONE_RPC_PROTO=http \  #用于连接 Drone 服务器的协议
  --env=DRONE_RPC_HOST=192.168.200.30:82 \ #提供 Drone 服务器的主机名
  --env=DRONE_RPC_SECRET=8172cd9155d16593d4f6a445b70e2d6e \  #用于向 Drone 服务器进行身份验证的共享密钥
  --env=DRONE_RUNNER_CAPACITY=2 \   #限制运行器可以执行的并发管道的数量
  --env=DRONE_RUNNER_NAME=test-runner \   #设置runner的名字
  --publish=3000:3000 \
  --restart=always \
  --name=runner \
  drone/drone-runner-docker:1

 * drone-runner启动参数很多，下面解释下：
	+ DRONE_RPC_PROTO： 用于连接 Drone 服务器的协议
	+ DRONE_RPC_HOST： 提供 Drone 服务器的主机名
	+ DRONE_RPC_SECRET： 用于向 Drone 服务器进行身份验证的共享密钥
	+ DRONE_RUNNER_CAPACITY： 限制运行器可以执行的并发管道的数量
	+ DRONE_RUNNER_NAME： 设置runner的名字

• 验证drone-runner是否连接上drone-server（successfully pinged the remote server）：

[root@master drone]# docker logs -ft runner
2022-05-10T05:21:02.637256271Z time="2022-05-10T05:21:02Z" level=info msg="starting the server" addr=":3000"
2022-05-10T05:21:02.640121666Z time="2022-05-10T05:21:02Z" level=info msg="successfully pinged the remote server"
2022-05-10T05:21:02.640157924Z time="2022-05-10T05:21:02Z" level=info msg="polling the remote server" arch=amd64 capacity=2 endpoint="http://192.168.200.30:82" kind=pipeline os=linux type=docker

• 浏览器访问drone-server Web界面(http://192.168.200.30:82)，点击继续：

• 点解继续后，会跳转到这个Application URL地址（http://192.168.200.30:82/login）gitlab给Drone（Application）授权：

• 注册drone用户：

• 点击Drone右上角SYNC（同步），进入我们的test仓库下激活存储库，发现错误（这个错误我们需要打开gitlab的出入站请求）

• 回到gitlab，点击Admin-->settings：

• 打开出站请求，并打开允许web hooks（挂钩） 和服务向本地网络发出请求：

• 回到drone，test仓库再一次激活（成功），并开启Trusted特权容器(docker-runner在使用docker执行器时，类似使用root权限)

注意：这里还有一个问题，如果出现没有Trusted选项的情况，需要在启动运行drone-server服务是添加：--env=DRONE_USER_CREATE=username:root,admin:true

• 在gitlab依次点击，创建.drone.yml文件：
• .drone.yml文件内容（写的比较简单，主要了解流水线操作流程），如下：

kind: pipeline
type: docker
name: default

steps:
- name: greeting
  image: alpine
  commands:
  - echo hello
  - echo world

.drone.yml文件属性解释：

• kind：定义了对象的种类，此示例定义了一个pipeline（管道）对象；
• type：定义pipeline（管道）的类型，此示例定义了一个 Docker 管道，其中每个管道步骤都在 Docker 容器内执行；
• name：定义了pipeline（管道）的名称；
• steps：定义了一系列串行执行的pipeline（管道）步骤，出现一个步骤失败，立即退出； * name：定义管道步骤的名称； * image：定义了一个执行 shell 命令的 Docker 镜像； * commands：在docker容器内执行shell命令；

• 在自己项目下（test）点击：settings-->webhooks:
• 这里不需要再次创建webhooks（挂钩），Drone连接后会自动创建一个默认的webhooks：
• 回到drone会看到,我们编写的流水线文件被自动触发（之后gitlab仓库代码更新或上传新代码都会自动触发）.drone.yml：
• 点击我们的流水线，可以查看流水线详细步骤、步骤的状态和步骤的logs：

我这里的.drone.yml文件写的比较简单，主要时了解过程入门。如果需要练习可以试着部署自己的项目； 最后请各位注意三个我在学习gitlab+drone遇到的问题：

下列小括号‘()’中是解决方法；

• clone克隆地址连接不上（修改默认clone克隆）
• 没有Trusted选项，启动drone-server时添加(--env=DRONE_USER_CREATE=username:root,admin:true)
• .drone.yml文件中sed命令报错：sed: -e expression #1, char 34: unknown option to s (改成感叹号!或者| 分割，如：sed -i ‘s! 源内容 ! 替换内容 !g’ )

https://docs.drone.io/