mirror of https://github.com/easzlab/kubeasz.git
更新harbor文档
jmgao
parent
f697d49c86
commit
bd84affb6b
|
|
@ -12,6 +12,7 @@
|
|||
- name: harbor服务器证书安装
|
||||
copy: src={{ base_dir }}/roles/prepare/files/ca.pem dest=/etc/docker/certs.d/{{ HARBOR_DOMAIN }}/ca.crt
|
||||
|
||||
# 如果你的环境中有dns服务器，可以跳过hosts文件设置
|
||||
- name: 增加harbor的hosts解析
|
||||
shell: "sed -i '/{{ HARBOR_DOMAIN }}/d' /etc/hosts && \
|
||||
echo {{ HARBOR_IP }} {{ HARBOR_DOMAIN }} >> /etc/hosts"
|
||||
|
|
|
|||
|
|
@ -0,0 +1,134 @@
|
|||
## harbor
|
||||
|
||||
Habor是由VMWare中国团队开源的容器镜像仓库。事实上，Habor是在Docker Registry上进行了相应的企业级扩展，从而获得了更加广泛的应用，这些新的企业级特性包括：管理用户界面，基于角色的访问控制 ，水平扩展，同步，AD/LDAP集成以及审计日志等。本文档仅说明部署单个基础harbor服务的步骤。
|
||||
|
||||
### 准备安装文件
|
||||
|
||||
1. 下载最新的 [docker-compose](https://github.com/docker/compose/releases) 二进制文件，改名后把它放到项目 `bin`目录下，后续版本会一起打包进百度云盘`k8s.xxx.tar.gz`文件中
|
||||
|
||||
``` bash
|
||||
wget https://github.com/docker/compose/releases/download/1.18.0/docker-compose-Linux-x86_64
|
||||
mv docker-compose-Linux-x86_64 /etc/ansible/bin/docker-compose
|
||||
```
|
||||
2. 下载最新的 [harbor](https://github.com/vmware/harbor/releases) 离线安装包，把它放到项目 `down` 目录下，也可以从分享的百度云盘下载
|
||||
|
||||
### 安装步骤
|
||||
|
||||
根据 `11.harbor.yml`文件，harbor节点需要以下步骤：
|
||||
|
||||
1. role `prepare` 基础系统环境准备
|
||||
1. role `docker` 安装docker
|
||||
1. role `harbor` 安装harbor
|
||||
|
||||
harbor部署完之后，集群所有运行docker的节点需要配置harbor的证书，并可以在hosts里面添加harbor的域名解析，如果你的环境中有dns服务器，可以跳过hosts文件设置
|
||||
|
||||
请在另外窗口打开 [roles/harbor/tasks/main.yml](../../roles/harbor/tasks/main.yml)，对照以下讲解
|
||||
|
||||
1. 下载docker-compose可执行文件到$PATH目录
|
||||
1. 自注册变量result判断是否已经安装harbor，避免重复安装问题
|
||||
1. 解压harbor离线安装包到指定目录
|
||||
1. 导入harbor所需 docker images
|
||||
1. 创建harbor证书和私钥(复用集群的CA证书)
|
||||
1. 修改harbor.cfg配置文件
|
||||
1. 启动harbor安装脚本
|
||||
|
||||
### 验证harbor
|
||||
|
||||
1. 在harbor节点使用`docker ps -a` 查看harbor容器组件运行情况
|
||||
1. 浏览器访问harbor节点的IP地址 `https://{{ NODE_IP }}`，使用账号 admin 和 密码 Harbor12345 (harbor.cfg 配置文件中的默认)登陆系统
|
||||
|
||||
### 管理harbor
|
||||
|
||||
+ 日志目录 `/var/log/harbor`
|
||||
+ 数据目录 `/data` ，其中最主要是 `/data/database` 和 `/data/registry` 目录，如果你要彻底重新安装harbor，删除这两个目录即可
|
||||
|
||||
先进入harbor安装目录 `cd /root/local/harbor`，常规操作如下：
|
||||
|
||||
1. 暂停harbor `docker-compose stop` : docker容器stop，并不删除容器
|
||||
2. 恢复harbor `docker-compose start` : 恢复docker容器运行
|
||||
3. 停止harbor `docker-compose down -v` : 停止并删除docker容器
|
||||
4. 启动harbor `docker-compose up -d` : 启动所有docker容器
|
||||
|
||||
修改harbor的运行配置，需要如下步骤：
|
||||
|
||||
``` bash
|
||||
# 停止 harbor
|
||||
docker-compose down -v
|
||||
# 修改配置
|
||||
vim harbor.cfg
|
||||
# 执行./prepare已更新配置到docker-compose.yml文件
|
||||
./prepare
|
||||
# 启动 harbor
|
||||
docker-compose up -d
|
||||
```
|
||||
### 在k8s集群使用harbor
|
||||
|
||||
admin用户web登陆后可以方便的创建项目，并指定项目属性(公开或者私有)；然后创建用户，并在项目`成员`选项中选择用户和权限；
|
||||
|
||||
#### 镜像上传
|
||||
|
||||
在node上使用harbor私有镜像仓库首先需要在指定目录配置harbor的CA证书，详见 `11.harbor.yml`文件。
|
||||
|
||||
使用docker客户端登陆`harbor.test.com`，然后把镜像tag成 `harbor.test.com/$项目名/$镜像名:$TAG` 之后，即可使用docker push 上传
|
||||
|
||||
``` bash
|
||||
docker login harbor.test.com
|
||||
Username:
|
||||
Password:
|
||||
Login Succeeded
|
||||
docker tag busybox:latest harbor.test.com/library/busybox:latest
|
||||
docker push harbor.test.com/library/busybox:latest
|
||||
The push refers to a repository [harbor.test.com/library/busybox]
|
||||
0271b8eebde3: Pushed
|
||||
latest: digest: sha256:91ef6c1c52b166be02645b8efee30d1ee65362024f7da41c404681561734c465 size: 527
|
||||
```
|
||||
#### k8s中使用harbor
|
||||
|
||||
1. 如果镜像保存在harbor中的公开项目中，那么只需要在yaml文件中简单指定harbor私有镜像即可，例如
|
||||
|
||||
``` bash
|
||||
apiVersion: v1
|
||||
kind: Pod
|
||||
metadata:
|
||||
name: test-busybox
|
||||
spec:
|
||||
containers:
|
||||
- name: test-busybox
|
||||
image: harbor.test.com/library/busybox:latest
|
||||
imagePullPolicy: Always
|
||||
```
|
||||
|
||||
2. 如果镜像保存在harbor中的私有项目中，那么yaml文件中使用该私有项目的镜像需要指定`imagePullSecrets`，例如
|
||||
|
||||
``` bash
|
||||
apiVersion: v1
|
||||
kind: Pod
|
||||
metadata:
|
||||
name: test-busybox
|
||||
spec:
|
||||
containers:
|
||||
- name: test-busybox
|
||||
image: harbor.test.com/xxx/busybox:latest
|
||||
imagePullPolicy: Always
|
||||
imagePullSecrets:
|
||||
- name: harborKey1
|
||||
```
|
||||
其中 `harborKey1`可以用以下两种方式生成：
|
||||
|
||||
+ 1.使用 `kubectl create secret docker-registry harborkey1 --docker-server=harbor.test.com --docker-username=admin --docker-password=Harbor12345 --docker-email=team@test.com`
|
||||
+ 2.使用yaml配置文件生成
|
||||
|
||||
``` bash
|
||||
//harborkey1.yaml
|
||||
apiVersion: v1
|
||||
kind: Secret
|
||||
metadata:
|
||||
name: harborkey1
|
||||
namespace: default
|
||||
data:
|
||||
.dockerconfigjson: {base64 -w 0 ~/.docker/config.json}
|
||||
type: kubernetes.io/dockerconfigjson
|
||||
```
|
||||
前面docker login会在~/.docker下面创建一个config.json文件保存鉴权串，这里secret yaml的.dockerconfigjson后面的数据就是那个json文件的base64编码输出（-w 0让base64输出在单行上，避免折行）
|
||||
|
||||
[前一篇]() -- [目录](index.md) -- [后一篇]()
|
||||
|
|
@ -7,6 +7,7 @@
|
|||
- 安装 [heapster](heapster.md)
|
||||
- 安装 [ingress](ingress.md)
|
||||
- 安装 efk
|
||||
- 安装 [harbor](harbor.md)
|
||||
|
||||
### 集群维护
|
||||
|
||||
|
|
@ -26,4 +27,3 @@
|
|||
|
||||
### 其他
|
||||
|
||||
- Harbor 部署
|
||||
|
|
|
|||
|
|
@ -5,7 +5,7 @@
|
|||
# result|failed 说明没有安装过harbor，下一步进行安装
|
||||
# result|succeeded 说明已经安装过harbor，下一步跳过安装
|
||||
- name: 注册变量result
|
||||
command: ls /data
|
||||
command: ls /data/registry
|
||||
register: result
|
||||
ignore_errors: True
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue