在Ubuntu上安装Drone持续集成环境

时间  2019-11-21
标签 ubuntu 安装 drone 持续 集成 环境 栏目 Ubuntu 繁體版
原文   原文链接

欢迎你们前往腾讯云+社区，获取更多腾讯海量技术实践干货哦~前端

本文由小铁匠米兰的v 发表于云+社区专栏nginx

介绍

Drone是一个流行的持续集成和交付平台。它集成了许多流行的版本控制存储库服务，如GitHub，GitLab和Bitbucket，以监视代码更改并在提交时自动构建和测试更改。git

在本教程中，咱们将演示如何为您的设置完整的Drone持续集成环境。咱们将配置受腾讯云SSL保护的Nginx做为Drone的前端。加密对Drone Web界面的请求，并容许CI服务器与源代码服务器安全地集成。github

准备

要完成本教程，您须要一台已经设置好可使用sudo命令的非root帐号的CentOS服务器，而且已开启防火墙。没有服务器的同窗能够在这里购买，不过我我的更推荐您使用免费的腾讯云开发者实验室进行试验，学会安装后在购买服务器。docker

为了加密传输的内容，您还须要SSL证书，如何设置此证书**取决于你是否拥有可解析该服务器的域名。shell

同时，您还须要提早安装好Docker、学会使用Docker Compose，并在你的服务器上安装好Nginx，学会配置SSL证书，具体教程以下：数据库

完成上述教程后，您的Drone服务器应具备：浏览器

  • sudo为管理任务配置的用户
  • 启用了UFW防火墙，阻止除端口22,80和443上的SSH，HTTP和HTTPS请求以外的全部链接。
  • 已安装Docker和Docker Compose。
  • Nginx服务器配置了由腾讯云提供的SSL证书

接下来咱们继续安装教程。安全

将程序添加到源码存储库

为了监视代码更改以触发构建和测试阶段，Drone将须要访问您的源代码存储库。Drone能够与GitHub，GitLab，Gogs，Bitbucket Cloud和Bitbucket Server集成。bash

在本教程中，咱们将重点关注与GitHub存储库的集成，其余系统应该与本教程相似。若是您使用的是其余源代码存储库，请按照上面的相应连接了解您须要的软件特定配置。

首先访问您的GitHub账户。点击右上角的用户图标，而后从下拉菜单中选择设置：

img

接下来，在屏幕左侧的“ 开发人员设置”部分中找到OAuth应用程序项：

img

在随后的页面上，单击“ 注册新应用程序”：

img

接下来，您将看到OAuth申请注册表：

img

填写如下字段（这些字段存在于GitHub上。其余存储库提供程序可能有不一样的提示）：

  • 应用程序名称：您选择用于标识集成的名称。若是您没有特殊需求，“Drone”是一个不错的选择。
  • 主页URL：您的Drone服务器的域名。在这里使用https://，由于咱们使用的是安全域。
  • 应用程序描述：Drone的简单描述及其目的。
  • 受权回调URL：这必须是https://，后跟Drone服务器的域名，后跟/authorize。若是咱们的域名是example.com，这个文件将是。https://example.com/authorize

准备好后，单击“ 注册应用程序”。

在下一页中，您将看到新应用程序的详细信息。咱们须要的两个项目是客户端ID和客户端密钥：

复制这两个值。咱们须要这些将Drone链接到咱们的GitHub账户。

拉取Drone Docker镜像并准备配置

能够在服务器上安装和配置Drone。Drone做为Docker容器分发，所以若是咱们在Docker Compose文件中使用它，它将自动下载。为了略微加快这个过程，咱们能够提早下拉镜像：

docker pull drone/drone:0.7
复制代码

Drone Docker镜像是一个统一的容器，能够经过几种不一样的方式运行。咱们将运行一个做为Drone服务器运行的容器，该服务器协调存储库访问，托管Web UI并提供API。使用具备不一样设置的相同镜像，咱们将另外一个容器做为Drone代理运行，该代理负责从配置的存储库构建和测试软件。

咱们将使用Docker Compose在Drone主机上运行这两个容器。首先建立一个配置目录来存储咱们须要的文件：

sudo mkdir /etc/drone
复制代码

接下来，咱们将在其中建立一些文件来配置咱们的服务。

为Drone建立Docker Compose文件

首先，在配置目录中建立一个Docker Compose文件：

sudo nano /etc/drone/docker-compose.yml
复制代码

咱们将Docker Compose文件格式标记为版本“3”。以后，咱们将为上述两种服务定义服务。

drone-server服务将启动侦听8000端口的主Drone服务器容器。咱们将主机的/var/lib/drone目录安装在容器内，以便Drone能够保留其数据。咱们将服务配置其自动重启，并以咱们将在/etc/drone/server.env建立的文件中定义的环境变量的形式读取更详细的配置说明。

drone-agent服务使用相同的镜像，从agent命令开始。它接收来自主Drone服务器实例的指令，所以虽然它不须要通常的网络访问，但它确实须要在Drone服务以后启动。它还须要访问Docker的套接字文件来启动容器以运行实际的构建和测试步骤。与drone-server服务同样，此服务也将自动重启并读取/etc/drone/agent.env文件中的环境以进行其余配置。

使用如下Docker Compose文件配置这两个服务。注意文件的YAML格式，由于缩进或格式化中的错误可能致使错误：

version: '3'

services:
  drone-server:
    image: drone/drone:0.7
    ports:
      - 127.0.0.1:8000:8000
    volumes:
      - /var/lib/drone:/var/lib/drone
    restart: always
    env_file:
      - /etc/drone/server.env

  drone-agent:
    image: drone/drone:0.7
    command: agent
    depends_on:
      - drone-server
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
    env_file:
      - /etc/drone/agent.env
复制代码

完成后，保存并关闭Docker Compose文件。

配置Drone服务器的环境变量文件

接下来，咱们须要为的Docker Compose文件中引用的Drone服务器的环境变量文件。

在打开文件以前，咱们应该生成一个强密钥来验证代理和服务器组件。虽然咱们的设置将在同一台服务器上同时拥有这两个组件，但随着测试基础架构的扩展，强大的密钥相当重要。在命令行上，输入如下命令生成密钥：

LC_ALL=C </dev/urandom tr -dc A-Za-z0-9 | head -c 65 && echo
复制代码

此命令临时将shell中的语言设置为有限的字符范围。 而后它从/dev/urandom获取一个随机字节流，并进一步过滤掉任何非字母数字字符。咱们将前65个字符做为关键字。

输出看起来与此相似（不要复制下面的值！生成本身的！）：

ERmA7xubDvTa8i0wYBlljc9yjT1NJPG7xOlZBwAdMAmBYL4RZE4QngxWcCLowk9KN
复制代码

复制生成的密钥以在服务器环境文件中使用。建立一个新文件/etc/drone/server.env并在文本编辑器中打开它：

sudo nano /etc/drone/server.env
复制代码

文件内，咱们定义Drone用于链接的环境变量以启动服务，链接到存储库提供程序以及设置账户受权策略。您须要先从存储库提供程序复制的值才能正确填写值。

首先，设置DRONE_HOST和DRONE_SECRET值。将DRONE_SECRET设置为您在命令行上生成的密钥。DRONE_HOST设置通知Drone其可公开访问的地址。 这应该是您的受腾讯云保护的域名，前面是https://。

# Service settings
DRONE_SECRET=secret_generated_on_command_line
DRONE_HOST=https://example.com
复制代码

接下来，咱们将配置与VCS提供程序的集成，在咱们的示例中为GitHub。适合您项目的设置可能会有所不一样，具体取决于您的需求以及GitHub资产的组织方式。

咱们将锁定咱们的Drone安装并经过将DRONE_OPEN设置为false来禁用注册。这意味着只有DRONE_ADMIN中指定的GitHub账户名才能登陆。

注意：若是您将协做者做为GitHub组织使用，最好将DRONE_OPEN设置为true并将DRONE_ADMIN替换为DRONE_ORGS。DRONE_ORGS设置容许您指定一个或多个容许其成员。Drone将限制注册属于这些组的用户。

确保DRONE_ADMIN包含您的GitHub账户名称。

而后，经过将DRONE_GITHUB设置为true来激活GitHub集成插件。当咱们注册Drone应用程序时，咱们将DRONE_GITHUB_CLIENT和DRONE_GITHUB_SECRET设置为咱们从GitHub OAuth应用程序页面复制的密钥：

# Service settings
DRONE_SECRET=secret_generated_on_command_line
DRONE_HOST=https://example.com

# Registration settings
DRONE_OPEN=false
DRONE_ADMIN=sammytheshark

# GitHub Settings
DRONE_GITHUB=true
DRONE_GITHUB_CLIENT=Client_ID_from_GitHub
DRONE_GITHUB_SECRET=Client_Secret_from_GitHub
复制代码

咱们已完成配置服务器组件。在离开以前，复制DRONE_SECRET文件中的值。配置代理时，咱们须要在下一节中设置相同的密钥。完成后保存并关闭文件。

配置Drone Agent的环境变量文件

接下来，咱们将为Drone代理组件建立一个环境文件。打开新文件以设置代理环境变量：

sudo nano /etc/drone/agent.env
复制代码

咱们只须要定义两个值。 DRONE_SECRET将匹配sever.env文件中的配置。

DRONE_SERVER设置将配置代理链接到Drone服务器组件的方式。它将以wss://协议前缀开头，表示链接将使用加密的Web套接字，后跟Drone服务器的域名，并在末尾附加/ws/broker：

DRONE_SECRET=secret_generated_on_command_line
DRONE_SERVER=wss://example.com/ws/broker
复制代码

完成后保存并关闭文件。

配置DRONE系统单元文件

如今咱们的配置文件就位，咱们能够定义一个systemd单元文件来管理Drone服务。

在/etc/systemd/system目录中打开一个新的.service文件来配置服务：

sudo nano /etc/systemd/system/drone.service
复制代码

内部粘贴如下内容：

[Unit]
Description=Drone server
After=docker.service nginx.service

[Service]
Restart=always
ExecStart=/usr/local/bin/docker-compose -f /etc/drone/docker-compose.yml up
ExecStop=/usr/local/bin/docker-compose -f /etc/drone/docker-compose.yml stop

[Install]
WantedBy=multi-user.target
复制代码

第一部分告诉systemd在Docker和Nginx可用后启动此服务。第二部分告诉系统在发生故障时自动重启服务。 而后，它使用Docker Compose和咱们以前建立的配置文件定义启动和中止Drone服务的命令。最后，最后一节定义了如何使服务在引导时启动。

完成后保存并关闭文件。

在咱们启动Drone服务以前，咱们必须配置Nginx。Drone代理须要可以链接到Drone服务器，而且链接依赖于Nginx代理。

配置Nginx到代理请求到Drone

接下来，咱们须要修改Nginx的配置以代理对Drone服务器的请求。首先找处处理腾讯云SSL的Nginx配置。经过输入如下内容在全部已启用的服务器块中搜索server_name属性：

grep -R server_name /etc/nginx/sites-enabled
复制代码
/etc/nginx/sites-enabled/default:   server_name example.com;
/etc/nginx/sites-enabled/default:   return 301 https://$server_name$request_uri;
/etc/nginx/sites-enabled/default:   server_name example.com;
/etc/nginx/sites-enabled/default:# server_name example.com;
复制代码

在上面的输出中，域名（在此实例中为example.com）正在/etc/nginx/sites-enabled/default文件中定义。 您须要编辑与您的域名关联的文件。

您可能也会看到相似这样的内容：

/etc/nginx/sites-enabled/default:   server_name _;
/etc/nginx/sites-enabled/default:   return 301 https://$server_name$request_uri;
/etc/nginx/sites-enabled/default:   server_name _;
/etc/nginx/sites-enabled/default:# server_name example.com;
复制代码

在上面的输出中，server_name _; 表示用做后备机制的服务器块。“_”主机说明符是无效的主机，所以它永远不会匹配。

在配置中，这些配置与listen指令配对，后者设置default_server选项，以便当请求的主机与其余的服务器块不匹配时，将充当默认值。若是找不到与您的域名匹配的server_name定义，则应使用定义这些回退块的文件。

在文本编辑器中打开与您的域最相关的文件：

sudo nano /etc/nginx/sites-enabled/default 
复制代码

在内部，咱们将首先在现有server块以外添加两个部分：

upstream drone {
    server 127.0.0.1:8000;
}

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

server {
    . . .
复制代码

第一个块配置一个名为drone的上游请求，咱们能够在其中代理请求。server指令定义了如何链接到咱们的Drone服务，该服务将在端口8000上运行。

第二个块根据$connection_upgrade变量的值设置一个名为$http_upgrade的用户定义变量，Nginx在收到“Upgrade”HTTP标头时设置该变量。若是收到Upgrade头，Nginx将设置$connection_upgrade变量进行升级。若是没有，它将设置为关闭。 这些变量容许咱们在代理WebSocket请求时设置正确的标头。

接下来，找到包含listen 443指令的服务器块。 使用如下指令替换内容。确保注释掉或删除该块中的任何现有配置以免冲突：

. . .
server {
    listen 443 ssl;
    . . .
    location / {
        # try_files $uri $uri/ =404;
        proxy_pass http://drone;

        include proxy_params;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;

        proxy_redirect off;
        proxy_http_version 1.1;
        proxy_buffering off;
        chunked_transfer_encoding off;
        proxy_read_timeout 86400;
    }
    . . .
}

复制代码

proxy_pass行告诉Nginx将此块以外的全部流量传递给咱们以前定义的上游。接下来，咱们在proxy_params文件中包含一些代理头定义，并根据以前的地图设置添加其余头。而后，咱们调整一些其余特定于代理的设置，以确保WebSocket代理正常工做，并确保咱们的组件能够有效地进行通讯。

完成保存并关闭文件后。

测试并从新启动Nginx和Drone

咱们的配置现已完成。咱们只需启动或重启咱们的服务便可实现配置。

首先，检查Nginx配置是否存在语法错误：

sudo nginx -t
复制代码
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
复制代码

若是输出指示存在配置问题，请返回并再次检查Nginx配置。从新启动Nginx：

sudo systemctl restart nginx
复制代码

如今Nginx可用于代理和服务器之间的代理请求，咱们能够启动Drone：

sudo systemctl start drone
复制代码

检查以确保服务可以成功启动：

sudo systemctl status drone
复制代码
● drone.service - Drone server
   Loaded: loaded (/etc/systemd/system/drone.service; disabled; vendor preset: enabled)
   Active: active (running) since Fri 2017-06-09 21:56:33 UTC; 2min 58s ago
 Main PID: 15225 (docker-compose)
    Tasks: 5
   Memory: 37.7M
      CPU: 1.544s
   CGroup: /system.slice/drone.service
           ├─15225 /usr/local/bin/docker-compose -f /etc/drone/docker-compose.yml up
           └─15228 /usr/local/bin/docker-compose -f /etc/drone/docker-compose.yml up

. . .
Jun 09 21:56:35 drone docker-compose[15225]: drone-agent_1   | pipeline: request next execution
复制代码

若是服务被标记为active (running)而且日志中没有错误，则Drone已启动并正在运行。

若是遇到问题，能够输入如下命令检查Nginx日志：

sudo less /var/log/nginx/error.log
复制代码

您能够经过输入如下内容来检查Drone日志：

sudo journalctl -u drone
复制代码

若是一切正常运行，请经过输入如下内容启用Drone：

sudo systemctl enable drone
复制代码

在Docker和Nginx服务可用后，Drone服务将启动。

登陆Drone以受权访问您的存储库

如今Drone已启动并运行，咱们能够登陆Web界面并受权应用程序使用咱们的GitHub账户。

在Web浏览器中访问服务器的域名以查看Drone Web界面：

https://example.com
复制代码

在您第一次访问时，系统将提示您登陆：

img

单击登陆使用您的GitHub账户向Drone进行身份验证。若是您当前未登陆GitHub，将首先指示您登陆GitHub。

以后，系统将提示您容许Drone访问您的GitHub账户：

img

查看请求的权限并进行任何调整后，单击受权用户名按钮以受权Drone。

您将被重定向回您的Drone服务器：

img

如今，您能够激活和配置存储库以自动测试代码。

结论

在本教程中，咱们将Drone设置为GitHub项目的持续集成和交付服务器。咱们将Drone设为处理身份验证并侦听来自咱们的存储库的更改。咱们还配置了一个能够运行测试和管理容器的Drone代理。咱们还将Nginx配置为安全的反向代理。若是以为自建太麻烦，不要着急，腾讯云CCI持续集成服务即将开放，云持续集成（Cloud Continuous Integration，CCI）为开发者提供支持多语言，多终端的持续集成服务，包含定时/手动启动构建、查看构建结果及日志、支持快速分发交付、可扩展的自动化测试等功能，为项目的持续集成体系提供上游基础服务，提高项目研发效率。 更多Linux教程请前往腾讯云+社区学习更多知识。

参考文献：《How To Install and Configure Drone on Ubuntu 16.04》

问答

Angular2如何处理http响应？

相关阅读

HTTP/2之服务器推送(Server Push)最佳实践

如何备份你的MySQL数据库

MySQL 8.0 版本功能变动介绍

云学院 · 课程推荐 | 腾讯高级工程师，带你快速入门机器学习

此文已由做者受权腾讯云+社区发布，原文连接：cloud.tencent.com/developer/a…

搜索关注公众号「云加社区」，第一时间获取技术干货，关注后回复1024 送你一份技术课程大礼包！

海量技术实践经验，尽在云加社区！

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程