apache ignite系列,二:配置
ignite有两种配置方式,一种是基于XML文件的配置,一种是基于JAVA代码的配置:
这里将ignite常用的配置集中罗列出来了,一般建议使用xml配置。
1,基于XML的配置
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:util="http://www.springframework.org/schema/util"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/util
http://www.springframework.org/schema/util/spring-util.xsd">
<bean >
<!-- Consistent globally unique node identifier which survives node restarts. -->
<!-- 全局一致性id -->
<!--<property name="consistentId" value="cord"/>-->
<!--Set to true to enable distributed class loading for examples, default is false. -->
<!-- 分布式计算class传播 -->
<property name="peerClassLoadingEnabled" value="true"/>
<!-- Set deployment mode. -->
<!-- 部署模式,控制类加载. -->
<property name="deploymentMode" value="CONTINUOUS"/>
<!-- Disable missed resources caching. -->
<!-- 禁用丢失资源缓存 -->
<property name="peerClassLoadingMissedResourcesCacheSize" value="0"/>
<!-- 设为false表示服务端模式 -->
<property name="clientMode" value="false"/>
<!-- Network timeout -->
<!-- 连接超时时间 -->
<property name="networkTimeout" value="10000" />
<!--Exclude force peer class loading of a class, even if exists locally.-->
<!-- 配置需要传播的class的路径 -->
<property name="peerClassLoadingLocalClassPathExclude">
<list>
<value>org.cord.*</value>
</list>
</property>
<!-- 配置需要监听的事件类型-->
<property name="includeEventTypes">
<list>
<util:constant static-field="org.apache.ignite.events.EventType.EVT_CACHE_OBJECT_PUT"/>
<util:constant static-field="org.apache.ignite.events.EventType.EVT_CACHE_OBJECT_READ"/>
<util:constant static-field="org.apache.ignite.events.EventType.EVT_CACHE_OBJECT_REMOVED"/>
</list>
</property>
<!-- Configure internal thread pool. -->
<!-- 公共线程池大小-->
<property name="publicThreadPoolSize" value="64"/>
<!-- Configure system thread pool. -->
<!-- 系统线程池大小-->
<property name="systemThreadPoolSize" value="32"/>
<property name="cacheConfiguration">
<list>
<bean class="org.apache.ignite.configuration.CacheConfiguration">
<!-- 缓存名-->
<property name="name" value="IGNITE_CACHE_KEY_PCOMM_RATE"/>
<!-- 原子模式类型,ATOMIC:原子型,保证性能; TRANSACTIONAL:事务型,分布式锁-->
<property name="atomicityMode" value="ATOMIC"/>
<!--PARTITIONED:分区; REPLICATED:复制;LOCAL:本地 -->
<property name="cacheMode" value="REPLICATED"/>
<!-- 备份数量-->
<property name="backups" value="1"/>
<!-- 禁用jcache标准中缓存读取获取的是副本的机制 -->
<property name="copyOnRead" value="false"/>
<!-- 内存区名-->
<property name="dataRegionName" value="Default_Region"/>
<!-- 是否以二进制形式存储-->
<!--<property name="storeKeepBinary" value="true"/>-->
<!-- 索引类型-->
<property name="indexedTypes">
<list>
<value>java.lang.Long</value>
<value>com.palic.demo.data.domain.CommRate</value>
</list>
</property>
</bean>
</list>
</property>
<!-- Redefining maximum memory size for the cluster node usage. -->
<property name="dataStorageConfiguration">
<bean class="org.apache.ignite.configuration.DataStorageConfiguration">
<!-- Redefining the default region's settings -->
<!-- 默认存储区间配置-->
<property name="defaultDataRegionConfiguration">
<bean class="org.apache.ignite.configuration.DataRegionConfiguration">
<!-- 存储区名-->
<property name="name" value="Default_Region"/>
<!-- 存储区大小-->
<!-- Setting the size of the default region to 1GB. -->
<!--<property name="maxSize" value="#{1L * 1024 * 1024 * 1024}"/>-->
<property name="maxSize" value="#{512 * 1024 * 1024}"/>
<!-- 是否开启持久化-->
<!-- Enabling Apache Ignite Persistent Store. -->
<!--<property name="persistenceEnabled" value="true"/>-->
</bean>
</property>
<property name="dataRegionConfigurations">
<list>
<!-- 自定义内存区-->
<!--
Defining a data region that will consume up to 500 MB of RAM and
will have eviction and persistence enabled.
-->
<bean class="org.apache.ignite.configuration.DataRegionConfiguration">
<!-- Custom region name. -->
<property name="name" value="500MB_Region"/>
<!-- 100 MB initial size. -->
<property name="initialSize" value="#{100L * 1024 * 1024}"/>
<!-- 500 MB maximum size. -->
<property name="maxSize" value="#{500L * 1024 * 1024}"/>
<!-- Enabling persistence for the region. -->
<!--<property name="persistenceEnabled" value="true"/>-->
</bean>
</list>
</property>
<!-- 预写日志模式-->
<!-- Sets property that defines behavior of wal fsync. -->
<!--<property name="walMode">-->
<!--<util:constant static-field="org.apache.ignite.configuration.WALMode.DEFAULT"/>-->
<!--</property>-->
<property name="walMode" value="DEFAULT"/>
<!-- 检查点频率-->
<!--Checkpointing frequency which is a minimal interval when the dirty pages will be written to the Persistent Store.-->
<property name="checkpointFrequency" value="180000"/>
<!--<property name="checkpointFrequency" value="10000"/>-->
<!-- 检查点线程数-->
<!-- Number of threads for checkpointing.-->
<property name="checkpointThreads" value="4"/>
<!-- 在检查点同步完成后预写日志历史保留数量 -->
<!-- Number of checkpoints to be kept in WAL after checkpoint is finished.-->
<property name="walHistorySize" value="20"/>
<!--<property name="walHistorySize" value="2"/>-->
<!-- 持久化文件路径 -->
<!--<!– Path where data and indexes will be persisted. –>-->
<!--<property name="storagePath" value="D:\\Test\\db" />-->
<!--<!– Path to the directory where WAL (Write Ahead Log) is stored. –>-->
<!--<property name="walPath" value="D:\\Test\\db\\wal" />-->
<!--<!– Path to the directory where WAL (Write Ahead Log) archive is stored. –>-->
<!--<property name="walArchivePath" value="D:\\Test\\db\\wal\\archive" />-->
</bean>
</property>
<property name="discoverySpi">
<bean class="org.apache.ignite.spi.discovery.tcp.TcpDiscoverySpi">
<property name="localPort" value="48500"/>
<property name="localPortRange" value="20"/>
<property name="joinTimeout" value="0"/>
<property name="networkTimeout" value="5000" />
<property name="ipFinder">
<bean class="org.apache.ignite.spi.discovery.tcp.ipfinder.vm.TcpDiscoveryVmIpFinder">
<property name="addresses">
<!-- 集群ip列表-->
<list>
<value>127.0.0.1:48500..48520</value>
</list>
</property>
</bean>
</property>
</bean>
</property>
<property name="communicationSpi">
<bean class="org.apache.ignite.spi.communication.tcp.TcpCommunicationSpi">
<property name="localPort" value="48100"/>
</bean>
</property>
</bean>
</beans>
基于此XML配置启动ignite节点的方式如下:
@Configuration
public class IgniteConfig {
@Autowired
private IgniteConfiguration igniteCfg;
@Bean
@ConditionalOnMissingBean
public Ignite initIgnite() {
//推荐借助spring bean的方式注入ignite配置信息,只需要将配置xml文件import即可
//启动类加上注解@ImportResource(locations={"classpath:default-config.xml"})
Ignite ignite = Ignition.start(igniteCfg);
//Ignite ignite = Ignition.start(classpath:default-config.xml)
}
}
2,基于JAVA代码的配置
......
IgniteConfiguration cfg = new IgniteConfiguration();
cfg.setClientMode(false);
//配置集群发现
cfg.setDiscoverySpi(new TcpDiscoverySpi().setLocalPort(48500).setLocalPortRange(20)
.setIpFinder(new TcpDiscoveryVmIpFinder().setAddresses(Arrays.asList("127.0.0.1:48500..48520"))));
//基本配置
cfg.setCommunicationSpi(new TcpCommunicationSpi().setLocalPort(48100));
cfg.setDeploymentMode(CONTINUOUS);
cfg.setPeerClassLoadingEnabled(true);
cfg.setPeerClassLoadingLocalClassPathExclude("com.org.ignite.*");
cfg.setIncludeEventTypes(EventType.EVT_TASK_STARTED, EventType.EVT_TASK_FINISHED, EventType.EVT_TASK_FAILED);
cfg.setPublicThreadPoolSize(64);
cfg.setSystemThreadPoolSize(32);
//添加cache配置
List<CacheConfiguration> cacheConf = new ArrayList<>();
CacheConfiguration<String, Integer> conf = new CacheConfiguration<String, Integer>("test")
.setCacheMode(CacheMode.REPLICATED)
.setIndexedTypes(String.class, Integer.class)
.setAtomicityMode(CacheAtomicityMode.ATOMIC)
.setCopyOnRead(false)
.setBackups(1);
cacheConf.add(conf);
cfg.setCacheConfiguration(cacheConf.toArray(new CacheConfiguration[]{}));
//基于java代码配置启动
Ignition.start(cfg);
......
一般建议基于XML配置,spring bean注入,如果确实需要JAVA配置,可以结合XML配置灵活处理。
在ignite集群中,配置信息是可以动态传播的,而如果是修改配置文件,则需要重启节点才可生效,并且如果有些关键配置不一致,也会导致启动节点报错,无法加入集群。所以最好的做法是,在普通节点中只配置节点相关配置,以及集群发现配置,至于变动性最大的缓存cache配置,可以由应用节点配置,这样便于的集中管控缓存配置。除此之外,使用xml配置,可以保证普通节点与应用节点的配置的一致性,而不需要单独再维护一套代码配置。