src/zh/UserGuide/latest/Deployment-and-Maintenance/Docker-Install.md - iotdb-docs - Git at Google

 <!--

     Licensed to the Apache Software Foundation (ASF) under one
     or more contributor license agreements.  See the NOTICE file
     distributed with this work for additional information
     regarding copyright ownership.  The ASF licenses this file
     to you under the Apache License, Version 2.0 (the
     "License"); you may not use this file except in compliance
     with the License.  You may obtain a copy of the License at

         http://www.apache.org/licenses/LICENSE-2.0

     Unless required by applicable law or agreed to in writing,
     software distributed under the License is distributed on an
     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
     KIND, either express or implied.  See the License for the
     specific language governing permissions and limitations
     under the License.

 -->

 # docker部署

 Apache IoTDB 的 Docker 镜像已经上传至 [https://hub.docker.com/r/apache/iotdb](https://hub.docker.com/r/apache/iotdb)。
 Apache IoTDB 的配置项以环境变量形式添加到容器内。

 ## docker镜像安装（单机版）

 ```shell
 # 获取镜像
 docker pull apache/iotdb:1.3.0-standalone
 # 创建 docker bridge 网络
 docker network create --driver=bridge --subnet=172.18.0.0/16 --gateway=172.18.0.1 iotdb
 # 创建 docker 容器
 # 注意：必须固定IP部署。IP改变会导致 confignode 启动失败。
 docker run -d --name iotdb-service \
               --hostname iotdb-service \
               --network iotdb \
               --ip 172.18.0.6 \
               -p 6667:6667 \
               -e cn_internal_address=iotdb-service \
               -e cn_seed_config_node=iotdb-service:10710 \
               -e cn_internal_port=10710 \
               -e cn_consensus_port=10720 \
               -e dn_rpc_address=iotdb-service \
               -e dn_internal_address=iotdb-service \
               -e dn_seed_config_node=iotdb-service:10710 \
               -e dn_mpp_data_exchange_port=10740 \
               -e dn_schema_region_consensus_port=10750 \
               -e dn_data_region_consensus_port=10760 \
               -e dn_rpc_port=6667 \
               apache/iotdb:1.3.0-standalone
 # 尝试使用命令行执行SQL
 docker exec -ti iotdb-service /iotdb/sbin/start-cli.sh -h iotdb-service
 ```

 外部连接：

 ```shell
 # <主机IP/hostname> 是物理机的真实IP或域名。如果在同一台物理机，可以是127.0.0.1。
 $IOTDB_HOME/sbin/start-cli.sh -h <主机IP/hostname> -p 6667
 ```

 ```yaml
 # docker-compose-1c1d.yml
 version: "3"
 services:
   iotdb-service:
     image: apache/iotdb:1.3.0-standalone
     hostname: iotdb-service
     container_name: iotdb-service
     ports:
       - "6667:6667"
     environment:
       - cn_internal_address=iotdb-service
       - cn_internal_port=10710
       - cn_consensus_port=10720
       - cn_seed_config_node=iotdb-service:10710
       - dn_rpc_address=iotdb-service
       - dn_internal_address=iotdb-service
       - dn_rpc_port=6667
       - dn_mpp_data_exchange_port=10740
       - dn_schema_region_consensus_port=10750
       - dn_data_region_consensus_port=10760
       - dn_seed_config_node=iotdb-service:10710
     volumes:
         - ./data:/iotdb/data
         - ./logs:/iotdb/logs
     networks:
       iotdb:
         ipv4_address: 172.18.0.6

 networks:
   iotdb:
     external: true
 ```
 如果需要修改内存配置，需要将 IoTDB 的配置文件夹 conf 映射出来。
 1. 在 volumes 配置内增加一个映射 `./iotdb-conf:/iotdb/conf` 启动 docker 容器。执行后，iotdb-conf 目录下有了 IoTDB 的所有配置。
 2. 修改目录 iotdb-conf 下的 confignode-env.sh 和 datanode-env.sh 内的相关配置。再次启动 docker 容器。

 ## docker镜像安装（集群版）

 目前只支持 host 网络和 overlay 网络，不支持 bridge 网络。overlay 网络参照[1C2D](https://github.com/apache/iotdb/tree/master/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml)的写法，host 网络如下。

 假如有三台物理机，它们的hostname分别是iotdb-1、iotdb-2、iotdb-3。依次启动。
 以 iotdb-2 节点的docker-compose文件为例：

 ```yaml
 version: "3"
 services:
   iotdb-confignode:
     image: apache/iotdb:1.3.0-confignode
     container_name: iotdb-confignode
     environment:
       - cn_internal_address=iotdb-2
       - cn_seed_config_node=iotdb-1:10710
       - schema_replication_factor=3
       - cn_internal_port=10710
       - cn_consensus_port=10720
       - schema_region_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
       - config_node_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
       - data_replication_factor=3
       - data_region_consensus_protocol_class=org.apache.iotdb.consensus.iot.IoTConsensus
     volumes:
       - /etc/hosts:/etc/hosts:ro
       - ./data/confignode:/iotdb/data
       - ./logs/confignode:/iotdb/logs
     network_mode: "host"

   iotdb-datanode:
     image: apache/iotdb:1.3.0-datanode
     container_name: iotdb-datanode
     environment:
       - dn_rpc_address=iotdb-2
       - dn_internal_address=iotdb-2
       - dn_seed_config_node=iotdb-1:10710
       - data_replication_factor=3
       - dn_rpc_port=6667
       - dn_mpp_data_exchange_port=10740
       - dn_schema_region_consensus_port=10750
       - dn_data_region_consensus_port=10760
       - data_region_consensus_protocol_class=org.apache.iotdb.consensus.iot.IoTConsensus
        - schema_replication_factor=3
       - schema_region_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
       - config_node_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
     volumes:
       - /etc/hosts:/etc/hosts:ro
       - ./data/datanode:/iotdb/data/
       - ./logs/datanode:/iotdb/logs/
     network_mode: "host"
 ```

 注意：

 1. `cn_seed_config_node`和`dn_seed_config_node`所有节点配置一样，需要配置第一个启动的节点，这里为`iotdb-1`。
 2. 上面docker-compose文件中，`iotdb-2`需要替换为每个节点的 hostname、域名或者IP地址。
 3. 需要映射`/etc/hosts`，文件内配置了 iotdb-1、iotdb-2、iotdb-3 与IP的映射。或者可以在 docker-compose 文件中增加 `extra_hosts` 配置。
 4. 首次启动时，必须首先启动 `iotdb-1`。
 5. 如果部署失败要重新部署集群，必须将所有节点上的IoTDB服务停止并删除，然后清除`data`和`logs`文件夹后，再启动。


 ## 配置
 IoTDB 的配置文件，都在安装目录的conf目录下。
 IoTDB 本身配置都可以在 docker-compose 文件的 environment 中进行配置。
 如果对日志和内存进行了自定义配置，那么需要将`conf`目录映射出来。

 ### 修改日志级别
 日志配置文件为 logback-confignode.xml 和 logback-datanode.xml，可以根据需要进行精细配置。

 ### 修改内存配置
 内存配置文件为 confignode-env.sh 和 datanode-env.sh。堆内存 ON_HEAP_MEMORY， 堆外内存 OFF_HEAP_MEMORY。例如：`ON_HEAP_MEMORY=8G, OFF_HEAP_MEMORY=2G`

 ## 升级
 1. 获取新的镜像
 2. 修改 docker-compose 文件的 image
 3. 使用 docker stop 和 docker rm 命令，停止运行的 docker 容器
 4. 启动 IoTDB

 ## 设置开机自启动
 1. 修改 docker-compose 文件，每个docker 容器配置：`restart: always`
 2. 将 docker 服务设置为开机自启动
 以 CentOS 操作系统为例： `systemctl enable docker`
	<!--

	Licensed to the Apache Software Foundation (ASF) under one
	or more contributor license agreements. See the NOTICE file
	distributed with this work for additional information
	regarding copyright ownership. The ASF licenses this file
	to you under the Apache License, Version 2.0 (the
	"License"); you may not use this file except in compliance
	with the License. You may obtain a copy of the License at

	http://www.apache.org/licenses/LICENSE-2.0

	Unless required by applicable law or agreed to in writing,
	software distributed under the License is distributed on an
	"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
	KIND, either express or implied. See the License for the
	specific language governing permissions and limitations
	under the License.

	-->

	# docker部署

	Apache IoTDB 的 Docker 镜像已经上传至 [https://hub.docker.com/r/apache/iotdb](https://hub.docker.com/r/apache/iotdb)。
	Apache IoTDB 的配置项以环境变量形式添加到容器内。

	## docker镜像安装（单机版）

	```shell
	# 获取镜像
	docker pull apache/iotdb:1.3.0-standalone
	# 创建 docker bridge 网络
	docker network create --driver=bridge --subnet=172.18.0.0/16 --gateway=172.18.0.1 iotdb
	# 创建 docker 容器
	# 注意：必须固定IP部署。IP改变会导致 confignode 启动失败。
	docker run -d --name iotdb-service \
	--hostname iotdb-service \
	--network iotdb \
	--ip 172.18.0.6 \
	-p 6667:6667 \
	-e cn_internal_address=iotdb-service \
	-e cn_seed_config_node=iotdb-service:10710 \
	-e cn_internal_port=10710 \
	-e cn_consensus_port=10720 \
	-e dn_rpc_address=iotdb-service \
	-e dn_internal_address=iotdb-service \
	-e dn_seed_config_node=iotdb-service:10710 \
	-e dn_mpp_data_exchange_port=10740 \
	-e dn_schema_region_consensus_port=10750 \
	-e dn_data_region_consensus_port=10760 \
	-e dn_rpc_port=6667 \
	apache/iotdb:1.3.0-standalone
	# 尝试使用命令行执行SQL
	docker exec -ti iotdb-service /iotdb/sbin/start-cli.sh -h iotdb-service
	```

	外部连接：

	```shell
	# <主机IP/hostname> 是物理机的真实IP或域名。如果在同一台物理机，可以是127.0.0.1。
	$IOTDB_HOME/sbin/start-cli.sh -h <主机IP/hostname> -p 6667
	```

	```yaml
	# docker-compose-1c1d.yml
	version: "3"
	services:
	iotdb-service:
	image: apache/iotdb:1.3.0-standalone
	hostname: iotdb-service
	container_name: iotdb-service
	ports:
	- "6667:6667"
	environment:
	- cn_internal_address=iotdb-service
	- cn_internal_port=10710
	- cn_consensus_port=10720
	- cn_seed_config_node=iotdb-service:10710
	- dn_rpc_address=iotdb-service
	- dn_internal_address=iotdb-service
	- dn_rpc_port=6667
	- dn_mpp_data_exchange_port=10740
	- dn_schema_region_consensus_port=10750
	- dn_data_region_consensus_port=10760
	- dn_seed_config_node=iotdb-service:10710
	volumes:
	- ./data:/iotdb/data
	- ./logs:/iotdb/logs
	networks:
	iotdb:
	ipv4_address: 172.18.0.6

	networks:
	iotdb:
	external: true
	```
	如果需要修改内存配置，需要将 IoTDB 的配置文件夹 conf 映射出来。
	1. 在 volumes 配置内增加一个映射 `./iotdb-conf:/iotdb/conf` 启动 docker 容器。执行后，iotdb-conf 目录下有了 IoTDB 的所有配置。
	2. 修改目录 iotdb-conf 下的 confignode-env.sh 和 datanode-env.sh 内的相关配置。再次启动 docker 容器。

	## docker镜像安装（集群版）

	目前只支持 host 网络和 overlay 网络，不支持 bridge 网络。overlay 网络参照[1C2D](https://github.com/apache/iotdb/tree/master/docker/src/main/DockerCompose/docker-compose-cluster-1c2d.yml)的写法，host 网络如下。

	假如有三台物理机，它们的hostname分别是iotdb-1、iotdb-2、iotdb-3。依次启动。
	以 iotdb-2 节点的docker-compose文件为例：

	```yaml
	version: "3"
	services:
	iotdb-confignode:
	image: apache/iotdb:1.3.0-confignode
	container_name: iotdb-confignode
	environment:
	- cn_internal_address=iotdb-2
	- cn_seed_config_node=iotdb-1:10710
	- schema_replication_factor=3
	- cn_internal_port=10710
	- cn_consensus_port=10720
	- schema_region_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
	- config_node_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
	- data_replication_factor=3
	- data_region_consensus_protocol_class=org.apache.iotdb.consensus.iot.IoTConsensus
	volumes:
	- /etc/hosts:/etc/hosts:ro
	- ./data/confignode:/iotdb/data
	- ./logs/confignode:/iotdb/logs
	network_mode: "host"

	iotdb-datanode:
	image: apache/iotdb:1.3.0-datanode
	container_name: iotdb-datanode
	environment:
	- dn_rpc_address=iotdb-2
	- dn_internal_address=iotdb-2
	- dn_seed_config_node=iotdb-1:10710
	- data_replication_factor=3
	- dn_rpc_port=6667
	- dn_mpp_data_exchange_port=10740
	- dn_schema_region_consensus_port=10750
	- dn_data_region_consensus_port=10760
	- data_region_consensus_protocol_class=org.apache.iotdb.consensus.iot.IoTConsensus
	- schema_replication_factor=3
	- schema_region_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
	- config_node_consensus_protocol_class=org.apache.iotdb.consensus.ratis.RatisConsensus
	volumes:
	- /etc/hosts:/etc/hosts:ro
	- ./data/datanode:/iotdb/data/
	- ./logs/datanode:/iotdb/logs/
	network_mode: "host"
	```

	注意：

	1. `cn_seed_config_node`和`dn_seed_config_node`所有节点配置一样，需要配置第一个启动的节点，这里为`iotdb-1`。
	2. 上面docker-compose文件中，`iotdb-2`需要替换为每个节点的 hostname、域名或者IP地址。
	3. 需要映射`/etc/hosts`，文件内配置了 iotdb-1、iotdb-2、iotdb-3 与IP的映射。或者可以在 docker-compose 文件中增加 `extra_hosts` 配置。
	4. 首次启动时，必须首先启动 `iotdb-1`。
	5. 如果部署失败要重新部署集群，必须将所有节点上的IoTDB服务停止并删除，然后清除`data`和`logs`文件夹后，再启动。


	## 配置
	IoTDB 的配置文件，都在安装目录的conf目录下。
	IoTDB 本身配置都可以在 docker-compose 文件的 environment 中进行配置。
	如果对日志和内存进行了自定义配置，那么需要将`conf`目录映射出来。

	### 修改日志级别
	日志配置文件为 logback-confignode.xml 和 logback-datanode.xml，可以根据需要进行精细配置。

	### 修改内存配置
	内存配置文件为 confignode-env.sh 和 datanode-env.sh。堆内存 ON_HEAP_MEMORY，堆外内存 OFF_HEAP_MEMORY。例如：`ON_HEAP_MEMORY=8G, OFF_HEAP_MEMORY=2G`

	## 升级
	1. 获取新的镜像
	2. 修改 docker-compose 文件的 image
	3. 使用 docker stop 和 docker rm 命令，停止运行的 docker 容器
	4. 启动 IoTDB

	## 设置开机自启动
	1. 修改 docker-compose 文件，每个docker 容器配置：`restart: always`
	2. 将 docker 服务设置为开机自启动
	以 CentOS 操作系统为例： `systemctl enable docker`