C. K. Wang's Blog

建立自己的 Docker Registry

Docker HubDocker 官方維護的公共倉庫。但是如果映像檔 (image) 不便公開,可能就不適合使用公共倉庫,這時候我們就需要 Docker Registry 來建立自己的私有倉庫。

Install Docker Registry

登入欲建立 Docker Registry 的遠端 Server,從 Docker Hub 拉取 Docker Registry 映像檔並啟動:

1
$ sudo docker run -d -p 5000:5000 --restart=always --name registry registry:2

這樣我們就已經在遠端 Server 上安裝好 Docker Registry 。

Install Docker Registry Frontend (Optional)

目前已有許多第三方為 Docker Registry 實現的 Web UI 介面,方便瀏覽在 registry 上的 images 。綜合目前在 Docker Hub 與 GitHub 上的 stars 數量,比較多人使用的是這套 Docker Registry Frontend ,以 AngularJS 開發的 UI 介面。其安裝方式也相當簡單:

1
2
3
4
5
6
sudo docker run \
-d \
-e ENV_DOCKER_REGISTRY_HOST=ENTER-YOUR-REGISTRY-HOST-HERE \
-e ENV_DOCKER_REGISTRY_PORT=ENTER-PORT-TO-YOUR-REGISTRY-HOST-HERE \
-p 8080:80 \
konradkleine/docker-registry-frontend:v2

完成啟動後,您可以打開瀏覽器進入 http://localhost:8080 查看 registry 狀態。

Setup for Insecure Registry

以下 IP xxx.xxx.xxx.xxx 表示我們遠端伺服器安裝 Docker Registry 的所在位址。

因為我們遠端的 Docker Registry 並沒有安裝 certificate,因此必須在本地 /etc/default/docker 加入:

1
DOCKER_OPTS="$DOCKER_OPTS --insecure-registry=xxx.xxx.xxx.xxx:5000"

然後重啟 Docker 服務:

1
$ sudo service docker restart

如果您使用 Docker for Mac ,打開應用程式找到 Preferences:

Insecure registries 列表加入 registry 位址,然後按下 Apply & Restart 等待 Docker 重啟完畢就可以了。

Test Your Docker Registry

為了測試我們建立的 Docker Registry ,我們需要從 Docker Hub 上 pull 一個 image 或自行建立 image 來做測試。此處範例我們在本地端從 Docker Hub 下載一個 ubuntu 映像檔:

1
$ sudo docker pull ubuntu

將下載後的映像檔 tag 指向我們所建立的 registry :

1
$ sudo docker tag ubuntu xxx.xxx.xxx.xxx:5000/ubuntu

上傳 image 至 自建 registry :

1
$ sudo docker push xxx.xxx.xxx.xxx:5000/ubuntu

從自建 registry 下載 image :

1
$ sudo docker pull xxx.xxx.xxx.xxx:5000/ubuntu

Docker Registry 也提供 HTTP API,例如查看 registry 上的 repositories :

1
$ curl http://xxx.xxx.xxx.xxx:5000/v2/_catalog

確認某個 image 的 tag :

1
$ curl http://xxx.xxx.xxx.xxx:5000/v2/SOME_IMAGE/tags/list

更多關於 Docker Registry 的其他用法可參閱官方文件