# Dockin-Installer

**Repository Path**: WeBankOS/Dockin-Installer

## Basic Information

- **Project Name**: Dockin-Installer
- **Description**: Production-grade highly available container platform
- **Primary Language**: Shell
- **License**: Apache-2.0
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-02-21
- **Last Updated**: 2025-08-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dockin Installer - Dockin Platform Installer

[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)

[English](README.md) | 中文

Dockin平台安装器，快速部署高可用kubernetes集群、ETCD集群，生产级参数调优。

**更多Dockin组件请访问 [https://github.com/WeBankFinTech/Dockin](https://github.com/WeBankFinTech/Dockin)**

![Architecture](docs/images/dockin.png)

## Features

* **0.1.0**
    * 支持ETCD高可用离线部署
    * 支持Kubernetes高可用离线部署
    * 支持Docker离线部署
    * 关闭kernel memory accounting
    * 全链路支持HTTPS
    * 10年证书签名
    * 支持CNI网络

## Installation

### Minimum Requirements

* **OS**
  * centos ≥  7 
  * kernel ≥ 3.10

## QuickStart

### 下载release包
### 注意：下面的步骤是基于Release包的，直接clone源码无法成功执行Install
### 为方便国内下载，release包已上传一份致腾讯云
```
https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/Dockin/dockin-etcd_0.1.1_dist.tar.gz
https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/Dockin/dockin-docker_0.1.1_dist.tar.gz
https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/Dockin/dockin-worker_0.1.1_dist.tar.gz
https://osp-1257653870.cos.ap-guangzhou.myqcloud.com/Dockin/dockin-master_0.1.1_dist.tar.gz
```

- 在[release页](https://github.com/WeBankFinTech/Dockin-Installer/releases/)下载对应的release包 


### 安装ETCD

- 解压至目录：dockin-etcd
- 默认部署路径：/data/app/dockin-etcd
- 证书生成路径：/data/app/dockin-etcd/conf
- 配置：conf/install.properties
- 默认端口：5379
- 命令

```
修改配置文件 vi conf/install.properties
按格式填写参数：server_list=(ip1 ip2 ip3)
安装完成后，请将 /data/app/dockin-etcd/conf/*.pem 拷贝到其他etcd节点，再重启etcd
```

```
sudo ./install.sh 
```

### 安装Docker

- 解压至目录：dockin-docker
- 配置文件：无
- 命令

```
cd dockin-docker
sudo ./install.sh

```

### 安装WORKER组件
#### 注意1：WORKER组件在Master节点和Worker节点上都需要安装，对于Master节点上安装Worker组件，token和master参数可以不需要填写。
#### 注意2：如果没有vip，可以直接填写服务器的IP，下同

- 解压至目录：dockin-worker
- 配置：conf/install.properties

```
#本机IP
ip=

# 加入集群的token，通过master的脚本产生
token=

# Master ApiServer IP/VIP
master=
```

- 命令

```
cd dockin-worker
# 若非master节点master_node参数需要改成false
sudo ./install.sh install v1.16.6 master_node=true

```


### 安装K8S Master

#### 注意1：安装Master之前请确认你已经在Master节点上安装了Worker
#### 注意2：如果没有vip，可以直接填写服务器的IP，下同

- 解压至目录：dockin-master
- 配置：conf/install.properties

```
# master HA VIP
master_vip=

# masterIP and VIP
master_ip_list=

# local IP
local_ip=

# etcd list, eg: https://ip1:port1,https://ip2:port2,https://ip3:port3; 
# 请注意dockin-etcd的端口是5379
etcd_list=
```

- 拷贝ETCD证书

```
1. 创建目录：/etc/kubernetes/pki/etcd/
2. 拷贝文件 ca.pem client.pem client-key.pem
# 以上文件从ETCD节点/data/app/dockin-etcd/conf路径下获取
```

- 命令

```
cd dockin-master
# 如果不是第一个节点，请将first_node设置成false
sudo ./install.sh install v1.16.6 first_node=true
```

### 增加Worker节点

```
1. 执行脚本 common/node-manager/create-node-join-token.sh，获取token
2. 使用上面安装Worker的步骤，注意修改参数master_node=false
```

### 使用外部负载均衡器（Master高可用）

使用云厂商提供的LB、自建haproxy、自建nginx都可以接入apiserver，作为高可用负载均衡器