建立私有 Docker Registry

-

前言

該如何自架 docker registry 呢? docker registry 可以幫助我們做什麼事情呢? docker registry 是可以將我們打包好的 docker image，放置到 docker registry 上面，在我們開始要佈署服務時，從 docker registry 拉取我們打包好的 image 進行佈署，也就是說 docker registry 是我們存放 images 的倉庫，今天我們將教大家如何自架 docker registry，建造我們的私有倉庫。

準備主機

準備一台主機，先在本機安裝 docker engine 和 docker compose，接著安裝 apache2-utils 和 mkcert，我們要使用 apache2-utils 來控管伺服器內部存取身分，Docker Registry 支援帳密登入，前提要啟用 TLS HTTPS 連線，並使用 htpasswd 工具設定雜湊密碼檔，且安裝 mkcert 建立 TLS 憑證，以下安裝指令

sudo apt-get install apache2-utils mkcert

建立 /var/registry/certs 路徑，並切換到此路徑

sudo mkdir -p /var/registry/certs

cd /var/registry/certs

接著在/var/registry/certs 路徑，建立 TSL 憑證

sudo mkcert -install

    |_ The local CA is already installed in the system trust store! 👍

sudo mkcert localhost

    |_ Created a new certificate valid for the following names 📜

    |_ - "localhost"

    |_

    |_ The certificate is at "./localhost.pem" and the key at "./localhost-key.pem" ✅

    |_ 

    |_ It will expire on 5 January 2026 🗓

ls *.pem

    |_ localhost-key.pem    localhost.pem

建立 /var/registry/auth 路徑，並切換此路徑

sudo mkdir -p /var/registry/auth

cd /var/registry/auth

接著在 /var/registry/auth 路徑，建立帳號密碼

sudo htpasswd -Bbn user 123456 | sudo tee ./htpasswd > /dev/null

ls -l htpasswd

    |_ -rw-r--r-- 1 root root 67 Oct  5 02:47 htpasswd

cat htpasswd

    |_ user:$2y$05$g/sNIT/FM4rWtEIDvjTLEuuj3wGWAwxzgQgcVRK0vC/6KVr6uRNtu

準備 Docker Compose 安裝 registry 以及 docker registry browser 這兩個鏡像

version: "3"


services:

    registry:

        container_name: registry

        restart: always

        image: registry:2

        ports:

            - 5000:5000

        environment:

            REGISTRY_HTTP_TLS_CERTIFICATE: /certs/localhost.pem

            REGISTRY_HTTP_TLS_KEY: /certs/localhost-key.pem

            REGISTRY_AUTH: htpasswd

            REGISTRY_AUTH_HTPASSWD_PATH: /auth/htpasswd

            REGISTRY_AUTH_HTPASSWD_REALM: Registry Realm

            REGISTRY_STORAGE_DELETE_ENABLED: true

        volumes:

            - /var/registry/data:/var/lib/registry

            - /var/registry/certs:/certs

            - /var/registry/auth:/auth

    docker_registry_browser:

        container_name: docker_registry_browser

        restart: always

        image: klausmeyer/docker-registry-browser

        ports:

            - 8080:8080

        environment:

            DOCKER_REGISTRY_URL: https://192.168.18.35:5000

            NO_SSL_VERIFICATION: true

            TOKEN_AUTH_USER: user

            TOKEN_AUTH_PASSWORD: 123456

            ENABLE_DELETE_IMAGES: true

        volumes:

            - /var/registry/certs:/certs

registry 鏡像

registry 是 docker 推出的鏡像，可以來建造我們的私有倉庫，快速提升開發效率，減少伺服器資源負擔

registry 的 environment 設定

REGISTRY_HTTP_TLS_CERTIFICATE: 取得剛才使用 mkcert 的 localhost.pem 檔案路徑

REGISTRY_HTTP_TLS_KEY: 取得剛才使用 mkcert 的 localhost-key.pem 檔案路徑

REGISTRY_AUTH: 設定驗證 http 環境變數

REGISTRY_AUTH_HTPASSWD_PATH: 設定驗證 http 檔案路徑

REGISTRY_AUTH_HTPASSWD_REALM: 設定驗證網域名稱

REGISTRY_STORAGE_DELETE_ENABLED: 啟用 registry 倉庫可被刪除

docker registry browser 鏡像

docker registry browser 是我個人推薦的一個鏡像，可以用來查看 docker registry 裡面有那些鏡像，並且提供刪除鏡像功能

docker registry browser 的 environment 設定

DOCKER_REGISTRY_URL: 設定 docker registry 位置

NO_SSL_VERIFICATION: 設定是否啟用 SSL 驗證

TOKEN_AUTH_USER: 設定 docker registry 登入使用者名稱

TOKEN_AUTH_PASSWORD: 設定 docker registry 登入密碼

ENABLE_DELETE_IMAGES: 設定是否啟用鏡像刪除按鈕

檢查 docker registry 是否運作正常

當安裝完 docker registry 後，在瀏覽器輸入我們鏡像倉庫網址: https://{自己的 ip}:{自己設定的 port}/v2，然後會要求輸入帳號密碼，輸入剛才我們設定的帳號密碼

登入完成後會進入一個空物件話面代表成功

再來輸入 https://{自己的 ip}:{自己設定的 port}/v2/_catalog，這可以看自己有上傳那些鏡像，目前當然是沒有

檢查 docker registry browser 是否運作正常

安裝完 docker registry browser 輸入 http://{自己 ip}:{自己設定的 port}，來檢查 docker registry browser 是否正常，然後會要求輸入帳號密碼，輸入剛才我們設定的帳號密碼

登入完成後會進入一個 docker registry browser 畫面，會更清楚裡面有哪些 image，現在是還沒有任何 image 的狀態

實際操作上傳 docker registry 倉庫

在所有服務建置完成後，我們來實際上傳 image 到我們的倉庫，首先先抓取 nginx 的 alpine 版本

docker pull nginx:alpine

接著我們對這個 image 給一個新的 tag 名子

docker tag 192.168.18.35:5000/nginx:alpine

接著先登入我們的 docker registry，輸入以下指令後，會要求我們輸入帳號密碼，也就是先前我們設定的帳號密碼

docker login 192.168.18.35:5000

登入成功後，再來上傳我們的 image

docker push 192.168.18.35:5000/nginx:alpine

如果上傳出現以下訊息

The push refers to repository [192.168.18.35:5000/nginx]

Get "https://192.168.18.35:5000/v2/": tls: failed to verify certificate: x509: cannot validate certificate for 192.168.44.136 because it doesn't contain any IP SANs

如果是 linux 在本機 /etc/docker/ 底下建立 daemon.json 檔案，建立以下內容

{

       "group": "dockerroot",

       "insecure-registries": [

               "192.168.44.136:5000"

        ],

        "live-restore": true

}

如果是 windows 直接在 docker desktop 新增相同內容

最後再輸入一次剛才的 docker push 即可上傳成功，然後在瀏覽器打開 docker registry browser 即可看到 nginx alpine 版本



留言

發佈留言

此網誌的熱門文章

Gitlab CI/CD 之 Group Runner

-
圖片
前言 上次我們教到 GitLab CI/CD 的 artifacts，今天我們要來講一個叫做 Group Runner，什麼是 Group Runner 我們今天待會會講道。 Gitlab Runner 類型 我們可以看到官網文件，Gitlab 提供了三種 Runner 類型，第一種叫 Shared runners，第二種叫 Group runners，第三種叫  Project runners Shared runners: 也就是我們之前看到 Gitlab 提供的那些 Runner Project runners: 也就是這個 Runner 設定只能在某一個專案跑 Group runners: 也就是說我會開一個群組，如果有些專案是在這群組的，可以共用這些群組上的 Runner 創建群組 接下來我們來創建一個群組，將我們的專案加入進群組，並且創建一個 Group runner，讓我們的專案可以使用群組上的 Runner，首先先點回去到 Gitlab 首頁->點擊 Groups->然後再點擊 New group 接下來在點擊 Create group 進去 接下來取名好群組名稱後，按下 Create group 按鈕，就可以成功建立群組 建立 Group Runner 接下來我們進到 develop 這個目錄裡面有個 Build->Runner 的最右手邊這裡就有我們的註冊 Group runner 之 token 接下來我們來建立 Group Runner，建立方法和之前建立 Project runners 很像再次教大家使用 gitlab-runner，首先先輸入以下指令 gitlab-runner register 在來這裡輸入我們要註冊的 Gitlab 網址 Runtime platform                                    arch=amd64 os=linux pid=96 revision=853330f9 version=16.5.0 Running in system-m
閱讀更多

Docker 之如何安裝 Docker 容器

-
圖片
前言 上次我們講到 Docker 的功用與好處，今天我們要在講解，如何安裝 Docker 這個容器，讓我們在之後的教學應用更好的實作與練習，現在讓我們開始吧 Docker Engine 與 Docker Desktop 首先在講解怎麼安裝 Docker 時，我們先講解 Docker Engine 跟 Docker Desktop 有甚麼不一樣，Docker Engine 是 Docker 最核心的部分，只要在電腦安裝了這個引擎，就可以馬上體驗 Docker，但是由於在操作 Docker 時，幾乎是命令介面，所以 Docker 後來有出 Docker Desktop，提供 UI 介面，盡可能貼近使用者操作，不過還是有很多事情是不能透過 Docker Desktop 去操作的 Docker 安裝環境選擇 如果你的電腦是一般練習的電腦，例如: 桌機、筆電，且作業系統是桌面型作業系統，那就可安裝 Docker Desktop，即可幫助你直接安裝好 Docker Engine，有完善的 UI 介面，如果你想自己灌一台伺服器等級的虛擬機，例如: 安裝 Ubuntu Server，那即可安裝好 Docker Engine 就可以體驗 Docker，不建議在虛擬機上安裝例如像 Ubuntu Desktop，裡面又安裝 Docker Desktop ，因為可能會有資源不夠的問題，現在如何安裝 Docker Engine 及 Docker Desktop 安裝 Docker Desktop 在這裡我們已 Windows 為範例，在我的文章最下面提供 Docker 官網下載網站，如果你的作業系統是 Windows 作業系統，就下載 Windows 版本 Docker Desktop，並依照安裝指示操作，即可完成安裝 以下是安裝玩後的 Docker Desktop 樣子，即可開始體驗 Docker 安裝 Docker Engine 如果你的作業系統是屬於伺服器等級的作業系統那只要安裝 Docker Engine 就好，在文章最下方會提供 Docker 官網安裝 Docker Engine 文獻，而下圖是以 Ubuntu 為例子的文獻，按照官網說明指令輸入，相信不會太困難
閱讀更多

Docker 之初體驗

-
圖片
前言 大家好在先前我們講了什麼是 Docker，Docker 好處有什麼以及怎麼安裝 Docker，今天我們要來開始初體驗 Docker 容器，使用後您會發現 Docker 非常的方便快速 Docker Hub 介紹 首先在開始學怎麼抓取 Docker Image 之前，我們要先來介紹 Docker Hub 這個平台，這是 Docker 為我們提供的一個雲端平台，他是可以讓我們存放 Docker Image 的這麼一個服務，可以透過他抓取我們想要的 Docker Image，也可以將我們所做的 Docker Image 存放到這個平台 查看 Nginx Image 接下來我們開始來準備抓取 Docker Image 工作準備，首先先在搜尋輸入 Nginx 查詢 Image，可以看到第一個就是了，請點進去 確認 Docker Image 版號 點進去 Nginx 裡面的頁面後，這裡會有一些關於這個 Image 的資訊，我們點擊如下圖，按下 Tags，並搜尋 alpine 的版本 往下捲動，我們要去抓如下圖 alpine 的版本 抓取 Nginx Docker Image 與佈署 確認好本版本後，我們開始抓取 Image 並佈署，輸入以下指令抓取 Image docker pull nginx:alpine 抓取完 Image 後，開始試著佈署 Nginx，輸入以下指令，即可開始佈署 docker run -d -p 80:80 nginx:alpine 在這時候打開瀏覽器，可以看到我們 Nginx 啟動成功 補充 為何我們抓取 Image 時，要特別抓 alpine 版本 ? 因為 alpine 是所以 linux 當中最小的系統，抓取速度快
閱讀更多