# 部署

# 1.部署

Ignite对部署没有要求,可以非常容易地部署到私有主机或者任意的云环境,比如,Ignite可以独立部署,也可以部署在Kubernetes或者Docker容器中,还有Apache Mesos以及Hadoop Yarn。它可以运行在物理主机中,也可以部署在虚拟机中。

# 2.Docker部署

Docker可以将Ignite应用及其所有的依赖打包进一个标准的容器,Docker会自动下载Ignite的二进制包,将代码部署进Ignite以及配置节点,它还可以自动启动配置好的Ignite节点,这样的集成方式,使得通过简单地重启Ignite的Docker容器就可以部署新的代码。

# 2.1.启动Ignite Docker容器

要运行Docker容器,需要拉取然后启动一个Docker镜像,默认会下载最新的版本,但是在这里可以看到一个完整的清单。 可以使用如下的命令拉取Ignite docker镜像:

# Pull latest version.
sudo docker pull apacheignite/ignite

# Pull ignite version {ignite-version}
sudo docker pull apacheignite/ignite:{ignite-version}

可以使用docker run来运行Ignite docker容器:

# Run latest version.
sudo docker run -it --net=host
-e "CONFIG_URI=$CONFIG_URI"
[-e "OPTION_LIBS=$OPTION_LIBS"]
[-e "JVM_OPTS=$JVM_OPTS"]
...
apacheignite/ignite

# Run ignite version {ignite-version}
sudo docker run -it --net=host
-e "CONFIG_URI=$CONFIG_URI"
[-e "OPTION_LIBS=$OPTION_LIBS"]
[-e "JVM_OPTS=$JVM_OPTS"]
...
apacheignite/ignite:{ignite-version}

下面的配置参数在docker容器中可以通过环境变量进行传递:

名称 描述 默认 示例
CONFIG_URI Ignite配置文件的URL(也可以相对于类路径的META-INF文件夹),下载的配置文件会保存于./ignite-config.xml https://raw.githubusercontent.com/apache/ignite/ master/examples/config/example-cache.xml
OPTION_LIBS 会被包含在类路径中的可选库 ignite-log4j, ignite-spring,ignite-indexing ignite-aws,ignite-aop
JVM_OPTS 通过docker命令传递给ignite实例的环境变量。 -Xms1g -Xmx1g -server -XX:+AggressiveOpts -XX:MaxPermSize=256m
EXTERNAL_LIBS 库文件URL列表 http://central.maven.org/maven2/io/undertow/undertow-servlet/1.3.10.Final/undertow-servlet-1.3.10.Final.jar,http://central.maven.org/maven2/io/undertow/undertow-build-config/1.0.0.Beta24/undertow-build-config-1.0.0.Beta24.jar

# 2.2.示例

要启动Ignite的docker容器,可以使用如下的命令:

sudo docker run -it --net=host -e "CONFIG_URI=https://raw.githubusercontent.com/apache/ignite/master/examples/config/example-cache.xml" apacheignite/ignite

之后应该看到如下的输出日志:

# 3.AWS部署

Ignite的AMI(Amazon机器镜像)可以通过AWS的EC2管理控制台配置一个简单的Ignite集群,通过AMI进行安装,可以快速地部署一个Ignite集群。

# 3.1.Amazon EC2部署

  • 点击下表的链接选择必要的区域:
    区域 镜像
    US-WEST ami-9cdbb3fc
    US-EAST ami-ce82caa4
    EU-CENTRAL ami-191b0775
    或者,也可以使用Apache Ignite关键字在Community AMIs中搜索镜像:
  • 选择一个Instance Type;
  • 打开Configure Instance并且展开Advanced Details;
  • 添加下面的任意配置参数;
名称 描述 默认 示例
CONFIG_URI Ignite配置文件的URL(也可以相对于类路径的META-INF文件夹),下载的配置文件会保存于./ignite-config.xml https://raw.githubusercontent.com/apache/ignite/ master/examples/config/example-cache.xml
OPTION_LIBS 会被包含在类路径中的可选库 ignite-log4j, ignite-spring,ignite-indexing ignite-aws,ignite-aop
JVM_OPTS 通过docker命令传递给ignite实例的环境变量。 -Xms1g -Xmx1g -server -XX:+AggressiveOpts -XX:MaxPermSize=256m
EXTERNAL_LIBS 库文件URL列表 http://central.maven.org/maven2/io/undertow/undertow-servlet/1.3.10.Final/undertow-servlet-1.3.10.Final.jar,http://central.maven.org/maven2/io/undertow/undertow-build-config/1.0.0.Beta24/undertow-build-config-1.0.0.Beta24.jar
IGNITE_VERSION Ignite的版本 latest 2.1.0

如下图所示:

首选Ignite版本 IGNITE_VERSION属性可以视具体情况而定。

sudo docker ps
  • 显示日志:
sudo docker logs -f CONTAINER_ID
  • 进入docker容器:
sudo docker exec -it container_id /bin/bash

# 4.Google计算部署

Ignite的镜像可以通过Google计算控制台配置一个简单的Ignite集群,通过镜像进行安装,可以快速地部署一个Ignite集群。

# 4.1.Google计算部署

gcloud compute images create ignite-image \
   --source-uri gs://ignite-media/ignite-google-image.tar.gz

要了解更多信息,可以参照cloud.google.com

  • 打开Google Compute Console

  • 打开Compute->Compute Engine->VM实例,然后点击New instance

  • 点击Boot diskChange按钮;

  • 打开Custom images,然后选择已导入的镜像,在下面的截图中,可以看到名为ignite-name的镜像;

  • 点击Management, disk, networking, access & security options,然后可以添加任意的配置参数: |名称|描述|默认|示例| |---|---|---|---| |CONFIG_URI|Ignite配置文件的URL(也可以相对于类路径的META-INF文件夹),下载的配置文件会保存于./ignite-config.xml|无|https://raw.githubusercontent.com/apache/ignite/ master/examples/config/example-cache.xml| |OPTION_LIBS|会被包含在类路径中的可选库|ignite-log4j, ignite-spring,ignite-indexing|ignite-aws,ignite-aop| |JVM_OPTS|通过docker命令传递给ignite实例的环境变量。|无|-Xms1g -Xmx1g -server -XX:+AggressiveOpts -XX:MaxPermSize=256m| |EXTERNAL_LIBS|库文件URL列表|无|http://central.maven.org/maven2/io/undertow/undertow-servlet/1.3.10.Final/undertow-servlet-1.3.10.Final.jar,http://central.maven.org/maven2/io/undertow/undertow-build-config/1.0.0.Beta24/undertow-build-config-1.0.0.Beta24.jar| |IGNITE_VERSION|Ignite的版本|latest|1.7.0|

如下图所示:

首选Ignite版本 IGNITE_VERSION属性可以视具体情况而定。

  • 填写必要的属性然后运行实例;
  • 连接实例;
  • 要查看执行的过程,需要知道容器的id,可以使用如下命令:
sudo docker ps
  • 下面的命令会显示日志:
sudo docker logs -f CONTAINER_ID
  • 使用下面的命令可以进入docker容器:
sudo docker exec -it container_id /bin/bash

# 5.Mesos部署

# 5.1.概述

Apache Ignite支持在Mesos集群上调度和运行Ignite节点。 Apache Mesos是一个集群管理器,它提供了一个通用运行环境以及所有的必要资源来部署、运行和管理分布式应用。它对资源的管理和隔离有助于充分利用服务器资源。 要了解Apache Mesos的更多信息,请参照:http://mesos.apache.org/

# 5.2.Ignite Mesos框架

常规部署Apache Ignite集群需要下载Apache Ignite二进制包,修改配置参数以及启动节点。Apache Ignite Mesos框架由调度器任务组成,可以极大地简化集群的部署。

  • 调度器:调度器启动时将自己在Mesos主节点上注册,注册成功之后调度器就会开始处理从Mesos主节点到使用资源的Ignite节点的资源请求,调度器会维护Ignite集群所需(并且可用)的所有资源水平(CPU,内存等);
  • 任务:在Mesos从节点上启动Ignite节点。

# 5.3.运行Ignite Mesos框架

要运行Ignite Mesos框架需要配置好的正在运行的Apache Mesos集群,如果需要如何Apache Mesos集群的信息,请参照:https://docs.mesosphere.com/getting-started/datacenter/install/

确保主节点和从节点监听正确的IP地址,否则无法保证Mesos集群能正常工作。

通过Marathon运行框架 目前,建议的做法是通过Marathon运行框架。

  • 安装Marathon,参照:https://docs.mesosphere.com/getting-started/datacenter/install/marathon章节;
  • 下载Apache Ignite然后将libs\optional\ignite-mesos\ignite-mesos-<ignite-version>-jar-with-dependencies.jar上传到任意一个云存储(比如Amazon S3yun);
  • 拷贝下面的应用定义(JSON格式)然后保存成marathon.json文件,然后对参数做必要的修改;
 {
  "id": "ignition",
  "instances": 1,
  "cpus": 2,
  "mem": 2048,
  "ports": [0],
  "uris": [
    "http://host/ignite-mesos-<ignite-version>-jar-with-dependencies.jar"
  ],
  "env": {
    "IGNITE_NODE_COUNT": "4",
    "MESOS_MASTER_URL": "zk://localhost:2181/mesos",
    "IGNITE_RUN_CPU_PER_NODE": "2",
    "IGNITE_MEMORY_PER_NODE": "2048",
    "IGNITE_VERSION": "1.0.5",
    "MESOS_USER" : "userAAAAA",
    "MESOS_ROLE" :  "role1"
  },
  "cmd": "java -jar ignite-mesos-<ignite-version>-jar-with-dependencies.jar"
}

角色名必须是有效的目录名,因此如下的格式非法:

1.为空串; 2.为.或者..; 3.由-开始; 4.包含斜杠、退格键以及空白符等。

如果集群没有额外的约束,框架会试图占用Mesos集群的所有资源。

  • 通过curl等工具发送应用定义的POST请求给Marathon:
curl -X POST -H "Content-type: application/json" --data-binary @marathon.json http://<marathon-ip>:8080/v2/apps/
  • 为了确保Apache Mesos框架正确部署,可以这么做,打开Marathon界面http://<marathon-ip>:8080,确保有一个名为ignition的应用,而且状态是Running
  • 打开Mesos控制台http://<master-ip>:5050,如果一切正常那么任务的名字类似Ignite node N,状态是RUNNING。在本示例中,N=4,可以看示例中的marathon.json文件-"IGNITE_NODE_COUNT": "4";
  • Mesos允许通过浏览器获得任务的日志,要查看Ignition的日志可以点击Active Tasks表格中的Sandbox
  • 点击stdout获取标准输出日志,stderr获取标准错误日志; 通过jar文件运行框架
  • 下载Ignite包然后打开libs\optional\ignite-mesos\文件夹;
  • 使用如下命令运行框架:
java -jar ignite-mesos-<ignite-version>-jar-with-dependencies.jar

或者:

java -jar ignite-mesos-<ignite-version>-jar-with-dependencies.jar properties.prop

其中properties.prop是一个属性文件,如果不提供配置文件那么框架会试图占用Mesos集群的所有资源,下面是一个例子:

# The number of nodes in the cluster.
IGNITE_NODE_COUNT=1
# Mesos ZooKeeper URL to locate leading master.
MESOS_MASTER_URL=zk://localhost:2181/mesos
# The number of CPU Cores for each Apache Ignite node.
IGNITE_RUN_CPU_PER_NODE=4
# The number of Megabytes of RAM for each Apache Ignite node.
IGNITE_MEMORY_PER_NODE=4096
# The version ignite which will be run on nodes.
IGNITE_VERSION=1.7.0
  • 为了确保Apache Mesos框架部署正确,可以这么做-打开Mesos控制台http://<marathon-ip>:5050,如果一切正常,名字类似Ignite node N的任务状态应该是Running。在本示例中N=1,可以看示例中的properties.prop文件-"IGNITE_NODE_COUNT": "1";
  • Mesos可以通过浏览器获得任务的日志,要查看Ignition的日志,可以点击Sandbox
  • 点击stdout获取标准输出日志,stderr获取标准错误日志;

# 5.4.配置

所有配置都是通过环境变量或者配置文件处理的(这非常适用于简化marathon的配置以运行框架),下面的配置参数可以根据需要进行配置:

名称 描述 默认值 示例
IGNITE_RUN_CPU_PER_NODE 每个Ignite节点的CPU核数 没有限制 2
IGNITE_MEMORY_PER_NODE 每个节点的内存数量(M) 没有限制 1024
IGNITE_DISK_SPACE_PER_NODE 每个节点占用的磁盘容量(M) 1024 2048
IGNITE_NODE_COUNT 集群内的节点数量 5 10
IGNITE_TOTAL_CPU Ignite集群的CPU核数 没有限制 5
IGNITE_TOTAL_MEMORY Ignite集群占用的内存(M) 没有限制
IGNITE_TOTAL_DISK_SPACE Ignite集群占用的磁盘空间(M) 没有限制 5120
IGNITE_MIN_CPU_PER_NODE 要运行Ignite节点所需的CPU核数的最小值 1 4
IGNITE_MIN_MEMORY_PER_NODE 要运行Ignite节点所需的内存的最小值(M) 256 1024
IGNITE_VERSION 节点要运行的Ignite的版本 latest 1.6.0
IGNITE_WORK_DIR 保存Ignite二进制包的目录 ignite-release /opt/ignite/
IGNITE_XML_CONFIG Apache Ignite配置文件的路径 /opt/ignite/ignite-config.xml
IGNITE_CONFIG_XML_URL Apache Ignite配置文件的URL https://example.com/default-config.xml
IGNITE_USERS_LIBS 要添加到类路径的库文件的路径 /opt/libs/
IGNITE_USERS_LIBS_URL 要添加到类路径的库文件的URL列表,逗号分割 https://example.com/lib.zip,https://example.com/lib1.zip
MESOS_MASTER_URL 要定位主节点的Mesos Zookeeper的URL zk://localhost:2181/mesos zk://176.0.1.45:2181/mesos or 176.0.1.45:2181
IGNITE_PACKAGE_URL Ignite的压缩包URL,这个参数可以用于替换IGNITE_VERSION参数。 http://apache-mirror.rbc.ru/pub/apache//ignite/1.7.0/apache-ignite-1.7.0-src.zip
IGNITE_PACKAGE_PATH Ignite的压缩包路径,这个参数在访问因特网受限时是有用的。 /opt/ignite/apache-ignite-fabric-1.6.0-bin.zip
IGNITE_HTTP_SERVER_IDLE_TIMEOUT 设置一个HTTP连接的最大空闲时间(毫秒),jetty服务器会使用,服务器提供了ignite的mesos框架所需的资源,比如ignite压缩包,用户的库文件,配置等。 30000 30000

# 6.Yarn部署

# 6.1.概述

与Yarn的集成可以支持在Yarn集群上调度和运行Apache Ignite节点。 Yarn是一个资源管理器,它提供了一个包括所有必要资源的通用的运行环境来进行分布式应用的部署,运行和管理,它对资源的管理和隔离有助于充分利用服务器资源。 要了解Yarn的信息,请参照http://hadoop.apache.org/docs/current/hadoop-yarn/hadoop-yarn-site/YARN.html

# 6.2.Ignite Yarn应用

部署Apache Ignite集群的典型步骤是下载Ignite的二进制包,修改配置文件以及启动节点。与Yarn的集成可以避免这些操作,Ignite Yarn应用可以极大的简化集群的部署,它由如下组件组成:

  • 下载Ignite二进制包,将必要的资源放入HDFS,创建启动任务的必要的上下文,启动ApplicationMaster进程;
  • Application master:注册成功之后组件就会开始处理从资源管理器到使用资源的Ignite节点的资源请求,Application master会维护Ignite集群所需的所有资源水平(CPU,内存等);
  • Container:在从节点上运行Ignite节点的实体;

# 6.3.运行Ignite Yarn应用

要运行Ignite应用,需要配置和运行Yarn和Hadoop集群,要了解如何配置集群的信息,可以参照: http://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/ClusterSetup.html.

  • 下载Ignite;
  • 配置属性文件,修改必要的参数,可以参照下面的配置章节:
# The number of nodes in the cluster.
IGNITE_NODE_COUNT=2

# The number of CPU Cores for each Apache Ignite node.
IGNITE_RUN_CPU_PER_NODE=1

# The number of Megabytes of RAM for each Apache Ignite node.
IGNITE_MEMORY_PER_NODE=2048

# The version of Ignite which will be run on nodes.
IGNITE_VERSION=2.3.0
  • 运行应用;
yarn jar ignite-yarn-<ignite-version>.jar ./ignite-yarn-<ignite-version>.jar cluster.properties
  • 为了确保应用正确部署,可以这样做:打开Yarn控制台http://<hostname>:8088/cluster,看名字为Ignition的应用是否工作正常;
  • 可以从浏览器获得日志,要查看日志可以点击任意容器的Logs
  • 点击stdout获取标准输出日志,stderr获取标准错误日志;

# 6.4.配置

所有的配置都是通过环境变量和属性文件进行的,下面的配置参数可以根据需要进行配置:

名称 描述 默认值 示例
IGNITE_XML_CONFIG 指向Apache Ignite配置文件的HDFS路径 /opt/ignite/ignite-config.xml
IGNITE_WORK_DIR 用于保存Ignite二进制包的目录 ./ignite-release /opt/ignite/
IGNITE_RELEASES_DIR 保存Ignite二进制包的HDFS路径 /ignite/releases/ /ignite-rel/
IGNITE_USERS_LIBS 要添加到CLASSPATH的库文件的HDFS路径 /opt/libs/
IGNITE_MEMORY_PER_NODE 每个Ignite节点占用的内存的大小(M),这个是Java堆的大小,包括了堆内缓存(如果使用了堆内缓存)。 2048 1024
IGNITE_MEMORY_OVERHEAD_PER_NODE 所有数据区必要的内存量,包括用于处理JVM本身的负载、用于存储数据的节点,都需要调整,不仅仅是计算。YARN用于容器运行Ignite节点的必要内存量是IGNITE_MEMORY_PER_NODE和IGNITE_MEMORY_OVERHEAD_PER_NODE之和。 IGNITE_MEMORY_PER_NODE * 0.10,最小值384 17408
IGNITE_HOSTNAME_CONSTRAINT 从节点约束 192.168.0.[1-100]
IGNITE_NODE_COUNT 集群节点的数量 3 10
IGNITE_RUN_CPU_PER_NODE 每个Ignite节点的CPU核数 2 4
IGNITE_VERSION 节点上运行的Ignite版本 latest 1.0.5
IGNITE_PATH 到Ignite构建的hdfs路径,当yarn集群运行在内网无法访问互联网时,这个属性很有用。 /ignite/apache-ignite-fabric-1.7.0-bin.zip
IGNITE_JVM_OPTS JVM参数 -XX:+PrintGC
最后更新时间:: 3/31/2020, 4:52:09 PM