# Kafka 云平台部署手册

[TOC]

---

## 1、安装包列表

|软件包|包名称|备注说明|软件包md5|
|---|---|---|---|
|kafka| kafka_2.12-1.1.0-d-100.tgz| kafkav1.1安装包| cc78b2ab0c02f0b34faf4e967a9b5c1d|


## 2、安装顺序

1. 安装`kafka-manager`
2. 安装`zookeeper`
3. 安装`kafka`
4. 安装`kafka-service-discovery`

---

### 2.1、安装kafka-manager

#### 2.1.1、环境要求

- **`java-8`**，要求预先安装`JDK8`

#### 2.1.2、安装步骤

1. 解压`kafka-manager-2.0.0.tar.gz`
```
$ tar -xvzf kafka-manager-2.0.0.tar.gz
x kafka-manager/
x kafka-manager/application.yml
x kafka-manager/create_mysql_table.sql
x kafka-manager/kafka-manager-web-2.0.0-SNAPSHOT.jar
$
```

2. 初始化`mysql`库&表
```
mysql库可以任意指定，只需要和kafka-manager的配置文件里面一致即可。

mysql -uXXXX -pXXX -h XXX.XXX.XXX.XXX -PXXXX < ./create_mysql_table.sql
```

3. 修改配置文件`application.yml`

```
修改mysql配置

spring:
  application:
    name: kafkamanager
  datasource:
    kafka-manager:
      jdbc-url: jdbc:mysql://{mysql_addr}:{mysql_port}/{mysql_db}?characterEncoding=UTF-8&serverTimezone=GMT%2B8
      username: {mysql_username}
      password: {mysql_password}
      driver-class-name: com.mysql.jdbc.Driver
```

4. 启动`kafka-manager`
```
nohup java -jar kafka-manager-web-2.0.0-SNAPSHOT.jar --spring.config.location=./application.yml > /dev/null 2>&1 &
```

---

### 2.2、安装zookeeper

和网上的一些文章基本一致，可以直接百度一下，或者参看下面的说明。

1. 解压安装包
```
tar -zxvf zookeeper-3.4.14.tar.gz
```


2. 修改配置文件(先在一台节点上配置)
```
拷贝新的配置：
cp conf/zoo_sample.cfg  conf/zoo.cfg

修改配置：
#如果没有该目录，先去创建，这里以tmp根目录为例，事先在tmp下创建好zookeeper-3.4.14/data
dataDir=/tmp/zookeeper-3.4.14/data  
#zk节点有几个，就配置几个，从1递增，下面的示例是有3个zk节点，注意host换成节点ip
server.1=host1:2888:3888
server.2=host2:2888:3888
server.3=host3:2888:3888
```

3. 创建一个myid文件
```
在 上述dataDir=/tmp/zookeeper-3.4.14/data 目录下，创建myid文件，vi myid

然后将里面的内容设置为对应的id.

如配置文件中该主机对应的server.N的N是多少，则myid中的数值就为多少，比如当前的节点作为zk的1号节点，内容就写1
```

4. 其他机器重复上述过程

5. 启动集群，
```
./zkServer.sh start
./zkServer.sh status #查看集群状态
```

---

### 2.3、安装 Kafka

#### 2.3.1、环境要求

- **`java-11`**，即要求预先安装`JDK11`

#### 2.3.2、安装步骤

1. 获取集群ID

```shell
访问kafka-manager(默认账号密码: admin/admin)

'运维管控' -> '集群列表' -> '注册集群'

zookeeper地址填写zk地址(加上namespace)

bootstrapServers填写kafka引擎节点地址，多个用英文逗号分隔. 例如: xxx.xxx.xxx.xxx:9093,xxx.xxx.xxx.xxx:9093

集群类型选共享集群

安全协议填写如下:

{
	"security.protocol": "SASL_PLAINTEXT",
	"sasl.mechanism": "PLAIN",
	"sasl.jaas.config": "org.apache.kafka.common.security.plain.PlainLoginModule required username=\"kafka-admin\" password=\"diditest@bdt\";"
}

注册成功后，会生成集群ID（后面kafka引擎配置需要）

```

2. 初始化安装包


这里以 `kafka_2.11-1.1.1-cp2.tgz` 包为例。

```shell
# 下载confluent-包并解压，最后得到如下文件
confluent-4.1.3

# 解压压缩包：
tar -zxf kafka_2.11-1.1.1-cp2.tgz

# 拷贝libs文件覆盖confluent-kafka的包
cp kafka_2.11-1.1.1-cp2/libs/*  confluent-4.1.3/share/java/kafka

# 拷贝配置等文件
cp kafka_2.11-1.1.1-cp2/config/kafka_client_jaas.conf   confluent-4.1.3/etc/kafka
cp kafka_2.11-1.1.1-cp2/config/kafka_exmetrics.txt      confluent-4.1.3/etc/kafka
cp kafka_2.11-1.1.1-cp2/config/kafka_server_jaas.conf   confluent-4.1.3/etc/kafka
cp kafka_2.11-1.1.1-cp2/config/server.properties        confluent-4.1.3/etc/kafka

# 备注
confluent-4.1.3 和 kafka_2.11-1.1.1-cp2 中都有support-metrics-*包，而且版本还不一样，这块随意保留一份即可。

```

3. 配置文件

```shell
# 配置数据地址
log.dirs=将其配置为数据盘的地址。

# 配置zk地址
修改zookeeper.connect，将其配置为kafka集群的zk地址(加上namespace)。
zookeeper.connect=xxx.xxx.xxx.xxx:2181,xxx.xxx.xxx.xxx:2181/xxx_test_zk （多个zk节点用英文逗号分隔）

# 修改 gateway.url
修改gateway.url，将其配置为为kafka-manager的地址。例如：http://127.0.0.1:8080/gateway
如果不清楚kafka-manager的地址，可以访问swagger来查看，例如：http://127.0.0.1:8080/swagger-ui.html
查看【GATEWAY-服务发现相关接口(REST)】，请求地址里/api的前缀即为kafka-manager的应用根前缀。
例如/gateway/api/xxxx

# 修改cluster.id
修改cluster.id，将其修改为为该集群添加进kafka-manager之后的集群ID(上述集群ID)

# 其他配置
依据需要进行相应的调整

# 其他建议, confluent的上报metrics基本没啥用，可不开启
confluent.support.metrics.enable=false
confluent.support.customer.id=anonymous

```


4. 启动文件修改

```shell

# 修改 bin/kafka-server-start 文件
# 在KAFKA_HEAP_OPTS下面增加如下配置
if [ "x$KAFKA_HEAP_OPTS" = "x" ]; then
    export KAFKA_HEAP_OPTS="-Xmx8G -Xms8G"
    export JMX_PORT=8099
    #export KAFKA_DEBUG=debug
    #export DAEMON_MODE=true
    export KAFKA_OPTS="-Djava.security.auth.login.config=$base_dir/../etc/kafka/kafka_server_jaas.conf"
    export DEBUG_SUSPEND_FLAG="n"
    export JAVA_DEBUG_PORT="8096"
    export GC_LOG_ENABLED=true
fi

# 修改 bin/kafka-run-class
可以对比一下我们提供的包里面的bin/kafka-run-class.sh 和confluent里面的差异进行调整。
主要是：
KAFKA_JMX_OPTS
DEFAULT_JAVA_DEBUG_OPTS
KAFKA_JVM_PERFORMANCE_OPTS
```

5. 启动`kafka`

```
进入confluent-4.1.3/bin目录
执行： nohup ./kafka-server-start ../etc/kafka/server.properties > /dev/null 2>&1 &
```

6. 集群模式

```
多台机器，重复上述过程即可
```

---

### 2.4、安装 `kafka-service-discovery`

#### 2.4.1、环境要求

- **`java-8`**，即要求预先安装`JDK8`

#### 2.4.2、安装步骤

1. 配置`kafka-gateway`

这一步比较特殊，当前没有操作界面，需要手动往`kafka-manager`的`MySQL  gateway_config`表中，手动写入如下数据：

```
INSERT INTO gateway_config(type, name, value, version) VALUES ('SERVICE_DISCOVERY_CLUSTER_ID', '{clusterId}', '{bootstrapServers}', 1);

{clusterId}是新加集群的集群ID  例如: 1
{bootstrapServers}是新加集群的集群服务地址(集群Broker地址)  例如: xxx:xxx.xxx.xxx:9093,xxx.xxx.xxx.xxx:9093
version > 0 即可，建议从1开始.
```

2. 解压`kafka-service-discovery.tar.gz`文件

```
解压压缩包：tar -zxvf kafka-service-discovery.tar.gz
```

3. 配置文件(kafka-service-discovery/config/server.prperties)修改

```
修改log.dirs，将其配置为日志输出地址。
修改gateway.address，将其配置为为kafka-manager的地址。例如：http://127.0.0.1:8080/gateway
如果不清楚kafka-manager的地址，可以访问swagger来查看，例如：http://127.0.0.1:8080/swagger-ui.html
查看【GATEWAY-服务发现相关接口(REST)】，请求地址里/api的前缀即为kafka-manager的应用根前缀。
例如/gateway/api/xxxx
```

4. 启动`kafka-service-discovery`

```
进入kafka-service-discovery/bin目录
执行： nohup ./kafka-server-start.sh ../config/server.properties > /dev/null 2>&1 &
```