• 前言
  • 一、docker-compose 安装
  • (1)在线安装(不推荐,我试过直接使用官方的安装方法,下载非常慢,不太建议使用在线安装)
  • (2)离线安装(推荐)
  • 二、Harbor 安装
  • 下载离线安装包
  • 安装包上传到服务器,我这里安装的路径是: /home/lenjor/harbor
  • 配置HTTPS证书
  • 1. 生成证书颁发机构证书
  • 2. 生成服务器证书
  • 3. 把证书配置到Harbor和Docker
  • 配置 harbor.yml
  • 重启Docker Engine
  • 运行安装程序脚本
  • 浏览器打开配置的 hostname 就能打开harbor的登陆页了
  • 另外一台虚拟机使用docker login命令登陆 我们的仓库
  • 再次登陆,推送镜像到仓库
  • Harbor仓库查看推送结果
  • 从Harbor的仓库中拉取镜像
  • 三、常用操作命令

前言

Harbor官方文档: https://docs.docker.com/compose/install/

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_推送

如图所示,harbor 需要依赖docker,docker-compose,openssl, 本文将介绍这些内容的安装和配置

一、docker-compose 安装

Harbor依赖于 docker-compose ,所以要先安装 docker-compose

docker-compose官方文档: https://docs.docker.com/compose/install/

(1)在线安装(不推荐,我试过直接使用官方的安装方法,下载非常慢,不太建议使用在线安装)

# 在线下载最新的稳定版docker-compose,建议打开官方文档直接拷贝官方的链接,不然就自己去GitHub看一下最新的docker-compose的版本,替换一下
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.28.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# Apply executable permissions to the binary:
$ sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 测试是否安装成功,输出版本信息则代表安装成功
$ docker-compose --version

(2)离线安装(推荐)

docker-compose Github地址: https://github.com/docker/compose/releases

选择下载 docker-compose-Linux-x86_64 版本

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_docker_02

把下载好的安装包上传到服务器,进入上传的安装包目录,然后执行操作

# 先进入上传的docker-compose安装包目录,然后执行如下命令将其移动到 `/usr/local/bin`,并改名为“docker-compose”。
$ sudo mv docker-compose-Linux-x86_64 /usr/local/bin/docker-compose

# 添加可执行权限
$ sudo chmod +x /usr/local/bin/docker-compose

# 创建软链接
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

# 测试是否安装成功,输出版本信息则代表安装成功
$ docker-compose --version

二、Harbor 安装

Harbor官方文档: https://docs.docker.com/compose/install/

官方的文档提供两种安装形式:在线下载安装和离线安装,在线安装因为国内网络不是特别好,这里推荐使用离线安装的形式

下载离线安装包

Harbor Github 地址:https://github.com/goharbor/harbor/releases

选择对应的安装包下载 harbor-offline-installer-{version}.tgz , {version} 为版本号

安装包上传到服务器,我这里安装的路径是: /home/lenjor/harbor

# 进入安装的路径,解压安装包
$ tar -xvf harbor-offline-installer-v2.2.0-rc1.tgz
# 复制一份配置文件模板 harbor.yml.tmpl , 并命名为 harbor.yml
$ sudo cp harbor.yml.tmpl harbor.yml

解压以后将看到以下的文件,我这里的已经完成了配置文件的复制操作

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_docker_03

配置HTTPS证书

官方操作说明文档地址:https://goharbor.io/docs/2.0.0/install-config/configure-https/

1. 生成证书颁发机构证书

# 生成CA证书私钥
$ openssl genrsa -out ca.key 4096
# 生成CA证书,记得以下的所有命令,都要替换成自己的域名,或者ip地址
$ openssl req -x509 -new -nodes -sha512 -days 3650 \
 -subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=yourdomain.com" \
 -key ca.key \
 -out ca.crt

2. 生成服务器证书

# 1)生成私钥
$ openssl genrsa -out yourdomain.com.key 4096
# 2)生成证书签名请求(CSR)
$ openssl req -sha512 -new \
    -subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=yourdomain.com" \
    -key yourdomain.com.key \
    -out yourdomain.com.csr

# 3)生成一个x509 v3扩展文件,这里有个坑,如果是域名配置的,就直接把授信域名配置到下面的列表

## 这个是域名的方式的命令,把授信的域名加到列表里
$ cat > v3.ext <<-EOF
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
extendedKeyUsage = serverAuth
subjectAltName = @alt_names

[alt_names]
DNS.1=yourdomain.com
DNS.2=yourdomain
DNS.3=hostname
EOF


## 这个是IP的方式,直接把后面的域名列表删掉,添加上自己的IP地址(注意 IP: 是有用的,不能删)
$ cat > v3.ext <<-EOF
authorityKeyIdentifier=keyid,issuer
basicConstraints=CA:FALSE
keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment
extendedKeyUsage = serverAuth
subjectAltName = IP:192.168.56.105


# 4)为你的Harbor主机生成证书
$ openssl x509 -req -sha512 -days 3650 \
    -extfile v3.ext \
    -CA ca.crt -CAkey ca.key -CAcreateserial \
    -in yourdomain.com.csr \
    -out yourdomain.com.crt

3. 把证书配置到Harbor和Docker

# 将服务器证书和密钥复制到Harbor主机上的certficates文件夹中, 需要先创建文件夹
$ mkdir /data/cert/ 
$ cp yourdomain.com.crt /data/cert/
$ cp yourdomain.com.key /data/cert/


# 转换yourdomain.com.crt为yourdomain.com.cert,供Docker使用
$ openssl x509 -inform PEM -in yourdomain.com.crt -out yourdomain.com.cert

# 将服务器证书,密钥和CA文件复制到Harbor主机上的Docker证书文件夹中。 敲黑板重点!!必须首先创建适当的文件夹。
$ mkdir -p /etc/docker/certs.d/yourdomain.com/
$ cp yourdomain.com.cert /etc/docker/certs.d/yourdomain.com/
$ cp yourdomain.com.key /etc/docker/certs.d/yourdomain.com/
$ cp ca.crt /etc/docker/certs.d/yourdomain.com/

配置 harbor.yml

官方文档地址: https://goharbor.io/docs/2.0.0/install-config/configure-yml-file/

# 配置 hostname
hostname: harbor.lenjor.com

# 打开https注释,配置证书地址,如果是按照官方文档操作的,证书就在 /data/cert/ 目录下
https:
  # https port for harbor, default is 443
  port: 443
  # The path of cert and key files for nginx
  certificate: /data/cert/harbor.lenjor.com.crt
  private_key: /data/cert/harbor.lenjor.com.key


# 修改Harbor admin账号的登陆密码
harbor_admin_password: Lenjor123.

# 修改Mysql数据库密码
database:
  # The password for the root user of Harbor DB. Change this before any production use.
  password: Lenjor123.

重启Docker Engine

systemctl restart docker

运行安装程序脚本

# 执行 .prepare 脚本
$ ./prepare

# 执行安装脚本
$ ./install.sh

浏览器打开配置的 hostname 就能打开harbor的登陆页了

网页提示的不安全,是因为没有安装证书,把之前生成的 ca.crt 这证书安装到浏览器,添加信任即可,但是Chrome检测到签发的时间过长也会提示不安全,暂时忽略吧

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_推送_04

输入登陆密码登陆,然后创建一个新的项目,我这里新建的是 k8s 项目

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_docker_05

查看一下仓库命令,拷贝一下标记tag的命令,在另外一台机器打一个镜像tag

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_安装包_06

# 对hello-world的镜像打一个tag
$ docker tag hello-world:latest harbor.lenjor.com/k8s/k8s-hello-world:v1.0

另外一台虚拟机使用docker login命令登陆 我们的仓库

# 登陆docker,这里换成自己harbor配置的hostname (ip,或者域名),输入账号和密码登陆
$ docker login harbor.lenjor.com

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_docker_07

这里会因为证书没有不是受信任的证书,提示报错,解决方法是

# 编辑docker配置文件
$ vi /etc/docker/daemon.json

# 在json文件中加入自己的域名或者ip,添加仓库授信
{  
   "insecure-registries":["私库地址/域名"]
}

# 保存退出以后重启docker再登陆就不会报错了
$ systemctl daemon-reload
$ systemctl restart docker

再次登陆,推送镜像到仓库

# 登陆docker,这里换成自己harbor配置的hostname (ip,或者域名),输入账号和密码登陆
$ docker login harbor.lenjor.com

# 从harbor仓库的命令页拷贝一下推送命令,然后修改成自己要推送的镜像,如我刚刚打了一个 k8s-hello-world:v1.0 镜像
$ docker push harbor.lenjor.com/k8s/k8s-hello-world:v1.0

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_推送_08

Harbor仓库查看推送结果

可以看到,我们的仓库已经是有我们刚刚推送上去的镜像了

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_安装包_09

从Harbor的仓库中拉取镜像

# 先把本地的hello-world镜像删除
$ docker rmi harbor.lenjor.com/k8s/k8s-hello-world:v1.0
# 查看删除是否成功
$ docker images

# 从私有仓库拉取镜像
$ docker pull harbor.lenjor.com/k8s/k8s-hello-world:v1.0

k8s containerd使用本地镜像 k8s搭建私有镜像仓库_docker_10

三、常用操作命令

# 停止harbor,在harbor的安装目录执行
$ sudo docker-compose stop

# 启动harbor,在harbor的安装目录执行
$ sudo docker-compose start

# 重新配置harbor,在harbor的安装目录执行
$ sudo docker-compose down -v
$ vim harbor.yml
$ sudo prepare
$ sudo docker-compose up -d

# 删除Harbor的容器,同时将镜像数据和Harbor的数据库文件保留在文件系统中:
$ sudo docker-compose down -v

# 删除Harbor的数据库和镜像数据以进行重新安装:
$ rm -r /data/database
$ rm -r /data/registry