咱也刚接触Harbor,在x86上部署倒是没什么问题,在arm上部署还是费了一些事的,趟了一些小坑,基本填平,小白学习中,请多指教。
1. 安装docker-compose环境
安装docker-compose
cd /root/k8s/docker-compose/ cp ./docker-compose-linux-aarch64 ./docker-compose mv docker-compose /usr/local/bin/ chmod +x /usr/local/bin/docker-compose docker-compose -v //查看版本
2.harbor离线安装准备
准备harbor离线包及部分镜像包
ps:harbor-arm安装包也是找了好久的,官方的包貌似更适配x86架构,在百度茫茫博客中找到了一个arm架构的包,倒也不是完全适配的,又后续替换了redis,补充了trivy,才算是齐备的harbor-arm安装包啦~
言归正传~Harbor有两种部署方式:http和https,经过尝试已知http方式只能部署harbor,无法登陆harbor仓库,对于我而言,并不能解决我的问题,安装方式也极其简单,此处不再进行记录;https方式可以实现仓库登陆,但是配置过程更加复杂,但是没有办法,我也只能采用这种方式。
哒哒哒哒~拿到安装包的第一步当然是解压看看里面的内容!
3.Https方式部署
默认情况下,Harbor不附带证书。要配置HTTPS,必须创建SSL证书。可以使用由受信任的第三方CA签名的证书,也可以使用自签名证书。本节介绍如何使用OpenSSL创建CA,以及如何使用CA签署服务器证书和客户端证书。您可以使用其他CA提供程序,例如Let’s Encrypt。
可以以registry.harbor.com域名为例进行配置,也可以直接使用IP地址代替域名配置https,但在生成证书时有两处配置稍有不同。
官方文档:https://goharbor.io/docs/2.0.0/install-config/configure-https/
在生产环境中,您应该从CA获得证书。在测试或开发环境中,您可以生成自己的CA。要生成CA证书,请运行以下命令。
3.1 生成CA证书私钥
#创建目录保存证书(可选) mkdir -p /root/harbor/ssl cd /root/harbor/ssl openssl genrsa -out ca.key 4096
3.2 生成CA证书
调整-subj选项中的值以反映您的组织。如果使用FQDN连接Harbor主机,则必须将其指定为通用名称(CN)属性。 openssl req -x509 -new -nodes -sha512 -days 3650 \ -subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=registry.harbor.com" \ -key ca.key \ -out ca.crt 如果使用IP地址,需要在执行以上命令前执行以下操作: cd /root openssl rand -writerand .rnd cd - 生成服务器证书 证书通常包含一个.crt文件和一个.key文件,例如yourdomain.com.crt和yourdomain.com.key。 1、生成私钥。 openssl genrsa -out registry.harbor.com.key 4096 2、生成证书签名请求(CSR)。 调整-subj选项中的值以反映您的组织。如果使用FQDN连接Harbor主机,则必须将其指定为通用名称(CN)属性,并在密钥和CSR文件名中使用它。 openssl req -sha512 -new \ -subj "/C=CN/ST=Beijing/L=Beijing/O=example/OU=Personal/CN=registry.harbor.com" \ -key registry.harbor.com.key \ -out registry.harbor.com.csr
3.3 生成一个x509 v3扩展文件
无论您使用FQDN还是IP地址连接到Harbor主机,都必须创建此文件,以便可以为您的Harbor主机生成符合主题备用名称(SAN)和x509 v3的证书扩展要求。替换DNS条目以反映您的域。 cat > v3.ext <<-EOF authorityKeyIdentifier=keyid,issuer basicConstraints=CA:FALSE keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment extendedKeyUsage = serverAuth subjectAltName = @alt_names [alt_names] DNS.1=registry.harbor.com DNS.2=registry.harbor DNS.3=harbor EOF 如果使用ip,需要使用如下方式进行创建: cat > v3.ext <<-EOF authorityKeyIdentifier=keyid,issuer basicConstraints=CA:FALSE keyUsage = digitalSignature, nonRepudiation, keyEncipherment, dataEncipherment extendedKeyUsage = serverAuth subjectAltName = IP:192.168.93.9 EOF
3.4 使用该v3.ext文件为您的Harbor主机生成证书
将yourdomain.comCRS和CRT文件名中的替换为Harbor主机名。 openssl x509 -req -sha512 -days 3650 \ -extfile v3.ext \ -CA ca.crt -CAkey ca.key -CAcreateserial \ -in registry.harbor.com.csr \ -out registry.harbor.com.crt 提供证书给Harbor和Docker 生成后ca.crt,yourdomain.com.crt和yourdomain.com.key文件,必须将它们提供给harbor和docker,和重新配置harbor使用它们。 1、将服务器证书和密钥复制到Harbor主机上的certficates文件夹中。 mkdir -p /data/cert cp registry.harbor.com.crt /data/cert/ cp registry.harbor.com.key /data/cert/ 2、转换yourdomain.com.crt为yourdomain.com.cert,供Docker使用。 Docker守护程序将.crt文件解释为CA证书,并将.cert文件解释为客户端证书。 openssl x509 -inform PEM -in registry.harbor.com.crt -out registry.harbor.com.cert 3、将服务器证书,密钥和CA文件复制到Harbor主机上的Docker证书文件夹中。您必须首先创建适当的文件夹。 mkdir -p /etc/docker/certs.d/registry.harbor.com/ cp registry.harbor.com.cert /etc/docker/certs.d/registry.harbor.com/ cp registry.harbor.com.key /etc/docker/certs.d/registry.harbor.com/ cp ca.crt /etc/docker/certs.d/registry.harbor.com/ 如果将默认nginx端口443映射到其他端口,请创建文件夹/etc/docker/certs.d/yourdomain.com:port或/etc/docker/certs.d/harbor_IP:port。(省略)
3.4 重新启动Docker Engine
systemctl restart docker
4. 修改harbor.yml配置文件
跳转到harbor所在的目录,没有所谓的harbor.yml,但是有harbor.yml.tmpl,那就cp出harbor.yml,并修改文件中的hostname及https下的证书路径:
cd /root/k8s/harbor230/harbor 并 cp harbor.yml.tmpl harbor.yml #只需修改hostname及https下的证书路径即可,其他保持默认 [root@harbor harbor]# vi harbor.yml # Configuration file of Harbor # The IP address or hostname to access admin UI and registry service. # DO NOT use localhost or 127.0.0.1, because Harbor needs to be accessed by external clients. hostname: registry.harbor.com # http related config http: # port for http, default is 80. If https enabled, this port will redirect to https port port: 80 # https related config https: # https port for harbor, default is 443 port: 443 # The path of cert and key files for nginx certificate: /data/cert/registry.harbor.com.crt private_key: /data/cert/registry.harbor.com.key ...
5. 执行harbor部署
./install.sh --with-trivy
因为我这边的需求要实现镜像扫描,所以我是安装了扫描器的:trivy,安装包需要特地下载一下的。
6. 查看harbor安装情况
#在harbor文件夹下使用docker-compose命令,也是在实践过程中发现docker-compose要在docker-compose所在的目录下才能使用,也不知道是我的问题还是它的问题。 docker-compose ps
7. redis一直处于restarting
#如果redis一直是restarting的状态: [root@harbor230 ~]# docker load < trivy-adapter-photon_v2.3.4.tar [root@harbor230 ~]# docker load < redis.tar #加载新下载的redis-arm的镜像包 #将之前harbor安装包自带的redis容器删除掉,并将新下载的redis重新打上标签,使用新的redis镜像包 docker rmi -f goharbor/redis-python:v2.3.4的镜像ID docker stop 正在运行的容器ID docker rm 正在运行的容器id docker rmi -f goharbor/redis-python:v2.3.4的镜像ID docker tag redis:latest goharbor/redis-python:v2.3.4 #重启harbor组件镜像包: docker-compose down -v docker-compose up -d
8. hosts中配置harbor域名
#在hosts文件加入以下内容 192.168.0.190 registry.harbor.com #hosts是系统文件,修改后,需要重启主机 reboot
9. 在控制台登录harbor
docker login registry.harbor.com Username: admin Password: Harbor12345 WARNING! Your password will be stored unencrypted in /root/.docker/config.json. Configure a credential helper to remove this warning. See https://docs.docker.com/engine/reference/commandline/login/#credentials-store Login Succeeded
至此,harbor算是可以使用啦~~~在网页端通过域名或地址访问就好啦
~~地址访问:https://192.168.0.190:443
~~域名访问:应该是需要给浏览器配置一下ca证书
某些浏览器可能会显示警告,指出证书颁发机构(CA)未知。使用不是来自受信任的第三方CA的自签名CA时,会发生这种情况。可以将CA导入浏览器以删除警告。
注意,这里的CA证书位于harbor节点/root/harbor/ssl/ca.crt。
以chrome浏览器导入证书为例,搜索栏输入以下内容,下拉选择管理证书,选择受信任的证书颁发机构,然后导入ca.crt重启浏览器使用域名访问即可。
chrome://settings/security