一、概述

本文將詳細介紹如何在本地搭建一個 Docker 私有 Registry 倉庫，并實現(xiàn)鏡像的上傳和管理。通過私有倉庫，可以方便地在本地網(wǎng)絡中存儲和分發(fā) Docker 鏡像，提高開發(fā)和部署效率。

二、搭建步驟

（一）下載 Docker Registry 鏡像

命令：

docker pull registry

解析：

• docker pull 是 Docker 的命令，用于從 Docker Hub 下載指定的鏡像。
• registry 是 Docker 官方提供的 Registry 鏡像，用于搭建私有倉庫。
• 默認情況下，docker pull 會下載最新版本的鏡像（latest 標簽）。

（二）啟動 Docker Registry 容器

命令：

docker run -d -p 5000:5000 --restart=always --name registry registry

解析：

• -d：表示以守護進程模式運行容器（后臺運行）。
• -p 5000:5000：將容器的 5000 端口映射到宿主機的 5000 端口，用于訪問私有倉庫。
• --restart=always：設置容器在退出后自動重啟，確保倉庫服務始終可用。
• --name registry：為容器指定名稱 registry，便于后續(xù)管理。
• registry：指定使用的鏡像名稱（即之前下載的 registry 鏡像）。

驗證容器是否啟動成功：

docker ps

如果看到名為 registry 的容器正在運行，并且端口映射正確，說明啟動成功。

（三）配置 Docker 客戶端以信任私有倉庫

由于私有倉庫默認使用 HTTPS協(xié)議，Docker 客戶端需要配置為信任該倉庫。

編輯 /etc/docker/daemon.json 文件：

vim /etc/docker/daemon.json

添加以下內(nèi)容：

{
    "insecure-registries": ["192.168.65.131:5000"]
}

• insecure-registries：指定不安全的倉庫地址，允許 Docker 客戶端通過 HTTP 協(xié)議訪問該地址。

重啟 Docker 服務：

systemctl restart docker

重啟 Docker 服務后，配置生效。

（四）上傳鏡像到私有倉庫

標記鏡像：

docker tag nginx:latest 192.168.65131:5000/nginx:latest

• docker tag：用于為鏡像重新標記一個新的名稱和標簽。
• nginx:latest：本地已有的鏡像名稱和標簽。
• nginx:5000/nginx:latest：目標倉庫地址和鏡像名稱。

推送鏡像到私有倉庫：

docker push 192.168.65.131:5000/nginx:latest

• docker push：將標記后的鏡像推送到指定的倉庫地址。
• 如果推送成功，會顯示鏡像層的上傳進度和最終的摘要信息。

（五）驗證鏡像是否上傳成功

通過 API 查看倉庫中的鏡像：

curl 192.168.65.131:5000/v2/_catalog

如果返回類似以下內(nèi)容，說明鏡像已成功上傳：

三、常見問題及解決方法

（一）無法連接到私有倉庫

問題描述：

在推送或拉取鏡像時，可能會遇到以下錯誤：

Get "https://192.168.65.131:5000/v2/": dial tcp 192.168.65.131:5000: connect: connection refused

解決方法：

• 確保 /etc/docker/daemon.json 文件中正確配置了 insecure-registries。
• 確保 Docker 服務已重啟。
• 確保倉庫地址正確，且防火墻允許訪問 5000 端口。

（二）網(wǎng)絡問題導致無法解析地址

問題描述： 如果嘗試訪問 http://192.168.65.131:5000 或 https://192.168.65.131:5000/v2/ 時，可能會遇到解析失敗的問題。

解決方法：

• 檢查倉庫地址是否正確，確保 IP 地址和端口無誤。
• 確保網(wǎng)絡連接正常，可以嘗試 ping 或 curl 測試連通性。
• 如果問題仍然存在，可能是網(wǎng)絡配置或防火墻限制，建議檢查網(wǎng)絡設置或聯(lián)系網(wǎng)絡管理員。

總結(jié)

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論