在 Synology NAS 上跑 gitlab-runner

Synology 的 NAS 基本上是以「DiskStation Manager」（DSM、官網）來做為主要的管理介面；而要安裝軟體的話，主要的方法就是透過他的「套件中心」。

由於在「套件中心」中可以直接找到 Docker 的選項，所以要安裝 Docker 基本上算是相當簡單的。

雖然 DSM 的 Docker 安裝好了之後，的確可以馬上開始使用；但是如果是像 Heresy 這邊一樣使用 GitLab 自己建立了非 https 的 Docker Registry 的話，其實理論上是要修改設定、將自己的 Docker Registry 加入「insecure-registries」的。

不過，在 DSM 的 Docker 設定介面裡面，並沒有辦法設定「insecure-registries」…

所以如果有這樣的需求的話，則是需要使用 SSH 連進去修改 Docker 的設定檔了。
（在「控制台」的「終端機 & SNMP」裡面可以開啟、設定 SSH 的相關功能）

而 Synology 的系統雖然也是 Linux，但是由於有經過他們一定程度的調整，所以相關的設定和其他系統都不大一樣，所以在設定上又得另外找方法了…

首先，Synology 系統的 Docker 設定檔放在「/var/packages/Docker/etc」，檔名也不叫做「daemon.json」、而是「dockerd.json」；所以如果要修改 Docker 的設定的話，就是要修改「/var/packages/Docker/etc/dockerd.json」這個檔案。
（似乎沒有 nano 這類的編輯器，只有 vi 就是另一個問題了…）

Heresy 這邊的設定檔是改成：

{
   "data-root": "/volume1/docker",
   "log-driver": "db",
   "registry-mirrors": [],
   "insecure-registries": [ "example.com:5100" ]
}

其中，「data-root」的修改，是讓他改把資料存在 RAID 的磁碟空間上。
而「insecure-registries」則就是要加入自己架設的 Docker Registry 路徑了。

在修改完設定檔案，則是呼叫「synoservice –restart pkgctl-Docker」這個指令、來重新啟動 Docker。

雖然 Synology NAS 採用的是 Linux 系統，也可以開啟 SSH 進去做控制，但是問題是他所採用的系統版本算是經過大幅度地客製化過的，所以和一般 Ubuntu 有相當地不同，所以也沒辦法自行下載官方的 gitlab-runner 來安裝（官方文件）。

儘管在 DSM 的 Docker 介面可以快速地建立出 Docker 版的 gitlab-runner，但是透過 DSM Docker 的介面，在設定上卻有一些限制，導致無法完成必要的設定…

所以，這邊還是需要使用 SSH、來進行手動的操作。這邊使用的指令，是：

docker run -d --name gitlab-runner --restart always 
  -v /var/run/docker.sock:/var/run/docker.sock 
  gitlab/gitlab-runner:latest

這邊的重點，是要加上 volume mapping，把 /var/run/docker.dock 對應到 gitlab-runner 的容器內，這樣他才可以操作 Docker。

而在容器跑起來之後，則是要再進去，連結到自行架設的 GitLab 網站。這邊可以先在 SSH 中執行：

docker exec -it gitlab-runner bash

以進入剛剛建立的「gitlab-runner」這個容器內，然後就可以執行「gitlab-runner register」（官方文件），一步一步完成設定了～

這邊要注意的是，「executor」的部分應該是要設定成「Docker」；而預設映像檔，也建議直接用 Docker 就好。

而由於 Docker 容器裡面還是要進行 Docker 的操作，所以這邊還需要手動修改 gitlab-runner 的設定檔；這個檔案是容器內的「/etc/gitlab-runner/config.toml」。

在裡面的 [[runners]] 下的 [runners.docker] 中，有一個「volumes」的陣列，裡面本來應該只有「“/cache”」，這邊要把 docker.sock 也加進去。

[["runners"]]
   [runners.docker]
     volumes = ["/var/run/docker.sock:/var/run/docker.sock","/cache"]

基本上大概就是像上面這樣（檔案中還有很多其他東西，這邊都省略了）。

之後，再執行「gitlab-runner restart」重新啟動 gitlab-runner 就可以了。