入门系列之在Ubuntu上安装Drone持续集成环境
歡迎大家前往騰訊云+社區，獲取更多騰訊海量技術實踐干貨哦~
本文由小鐵匠米蘭的v 發表于云+社區專欄
介紹
Drone是一個流行的持續集成和交付平臺。它集成了許多流行的版本控制存儲庫服務，如GitHub，GitLab和Bitbucket，以監視代碼更改并在提交時自動構建和測試更改。
在本教程中，我們將演示如何為您的設置完整的Drone持續集成環境。我們將配置受騰訊云SSL保護的Nginx作為Drone的前端。加密對Drone Web界面的請求，并允許CI服務器與源代碼服務器安全地集成。
準備
要完成本教程，您需要一臺已經設置好可以使用sudo命令的非root賬號的CentOS服務器，并且已開啟防火墻。沒有服務器的同學可以在這里購買，不過我個人更推薦您使用免費的騰訊云開發者實驗室進行試驗，學會安裝后在購買服務器。
為了加密傳輸的內容，您還需要SSL證書，如何設置此證書**取決于你是否擁有可解析該服務器的域名。
- 如果你有域名，保護你網站的最簡單方法是使用騰訊云SSL證書服務，它提供免費的可信證書。騰訊云SSL證書安裝操作指南進行設置。
- 如果你沒有域名，建議您先去這里注冊一個域名，如果你只是使用此配置進行測試或個人使用，則可以使用自簽名證書，不需要購買域名。自簽名證書提供了相同類型的加密，但沒有域名驗證公告。關于自簽名證書，你可以參考為Apache創建自簽名SSL證書和如何為Nginx創建自簽名SSL證書這兩篇文章。您需要一個附加到CI服務器的域名才能正確設置它。
同時，您還需要提前安裝好Docker、學會使用Docker Compose，并在你的服務器上安裝好Nginx，學會配置SSL證書，具體教程如下：
- 如何在Ubuntu安裝Docker
- 如何在Ubuntu安裝Docker Compose：按照教程的第二步安裝Docker Compose。
- 如何在Ubuntu安裝Nginx：在服務器上安裝Nginx。
- 如何使用Ubuntu的加密來保護Nginx：使用受信任的騰訊云SSL證書保護Nginx。
完成上述教程后，您的Drone服務器應具有：
- sudo為管理任務配置的用戶
- 啟用了UFW防火墻，阻止除端口22,80和443上的SSH，HTTP和HTTPS請求之外的所有連接。
- 已安裝Docker和Docker Compose。
- Nginx服務器配置了由騰訊云提供的SSL證書
接下來我們繼續安裝教程。
將程序添加到源碼存儲庫
為了監視代碼更改以觸發構建和測試階段，Drone將需要訪問您的源代碼存儲庫。Drone可以與GitHub，GitLab，Gogs，Bitbucket Cloud和Bitbucket Server集成。
在本教程中，我們將重點關注與GitHub存儲庫的集成，其他系統應該與本教程類似。如果您使用的是其他源代碼存儲庫，請按照上面的相應鏈接了解您需要的軟件特定配置。
首先訪問您的GitHub帳戶。點擊右上角的用戶圖標，然后從下拉菜單中選擇設置：
接下來，在屏幕左側的“ 開發人員設置”部分中找到OAuth應用程序項：
在隨后的頁面上，單擊“ 注冊新應用程序”：
接下來，您將看到OAuth申請注冊表：
填寫以下字段（這些字段存在于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.7Drone 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.7ports:- 127.0.0.1:8000:8000volumes:- /var/lib/drone:/var/lib/dronerestart: alwaysenv_file:- /etc/drone/server.envdrone-agent:image: drone/drone:0.7command: agentdepends_on:- drone-servervolumes:- /var/run/docker.sock:/var/run/docker.sockrestart: alwaysenv_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 serverLoaded: loaded (/etc/systemd/system/drone.service; disabled; vendor preset: enabled)Active: active (running) since Fri 2017-06-09 21:56:33 UTC; 2min 58s agoMain PID: 15225 (docker-compose)Tasks: 5Memory: 37.7MCPU: 1.544sCGroup: /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在您第一次訪問時，系統將提示您登錄：
單擊登錄使用您的GitHub帳戶向Drone進行身份驗證。如果您當前未登錄GitHub，將首先指示您登錄GitHub。
之后，系統將提示您允許Drone訪問您的GitHub帳戶：
查看請求的權限并進行任何調整后，單擊授權用戶名按鈕以授權Drone。
您將被重定向回您的Drone服務器：
現在，您可以激活和配置存儲庫以自動測試代碼。
結論
在本教程中，我們將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 版本功能變更介紹
云學院 · 課程推薦 | 騰訊高級工程師，帶你快速入門機器學習
此文已由作者授權騰訊云+社區發布，原文鏈接：https://cloud.tencent.com/developer/article/1180481?fromSource=waitui
搜索關注公眾號「云加社區」，第一時間獲取技術干貨，關注后回復1024 送你一份技術課程大禮包！
海量技術實踐經驗，盡在云加社區！
總結
以上是生活随笔為你收集整理的入门系列之在Ubuntu上安装Drone持续集成环境的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 人生苦短：Python里的17个“超赞操
- 下一篇： ubuntu server 16.10