第七章Ambari二次开发之自定义Flink服务configuration配置目录详解

1、configuration目录详解

• configuration目录&＃xff1a;主要对第三方服务的Conf目录下相关配置进行参数定义。

• 核心&＃xff1a;configuration被 Ambari Server 加载之后&＃xff0c;在前端页面上会出现两个配置项&＃xff0c;分别是 高级选项 和 自定义选项。其中 高级选项 里面就是 xml 文件的内容&＃xff0c;自定义选项 可以加入自定义配置信息&＃xff0c;如果不需要显示自定义配置信息的话&＃xff0c;可以通过添加 来隐藏掉自定义配置信息。

2、自定义目录文件

2.1、目录文件说明

• 目录中文件如下

<configuration>
<property>
<name>flink_install_dirname>
<value>/opt/flinkvalue>
<description>Location to install Flinkdescription>
property>
<property>
<name>elasticsearch_portname>
<display-name>Elasticsearch portdisplay-name>
<value>9200value>
<description>Elasticsearch portdescription>
property>
<property>
<name>contentname>
<display-name>Elasticsearch config file templatedisplay-name>
<description>This is the template for elasticsearch.yml filedescription>
<value>
http.port: {{elasticsearch_port}}
value>
<value-attributes>
<type>contenttype>
<show-property-name>trueshow-property-name>
value-attributes>
<on-ambari-upgrade add&＃61;"true"/>
property>

configuration>


• property属性说明

• 页面展示&＃xff1a;configuration 文件内的大部分&＃xff08;普通&＃xff09;属性都会在 Ambari Web UI 上的 CONFIGS 下展示&＃xff0c;内容可编辑修改。

2.2、相关参数配置详解

&＃xff08;1&＃xff09;配置项锁定

• 实现效果&＃xff1a;服务安装后不可编辑&＃xff0c;

<value-attributes>
<editable-only-at-install>trueeditable-only-at-install>
value-attributes>


• 修改前效果图

• 修改后效果图

&＃xff08;2&＃xff09;允许字段为空

• 实现效果&＃xff1a;允许value值为空

<value-attributes>
<empty-value-valid>trueempty-value-valid>
value-attributes>


• 修改前效果&＃xff1a;默认情况下字段值为空在安装页面会告警提示

• 修改后效果

&＃xff08;3&＃xff09;设置密码校验

• 实现效果&＃xff1a;修改配置项时需要输入密码

<property require-input&＃61;"true">
<name>kadmin.local.passwordname>
<display-name>admin passworddisplay-name>
<value/>
<property-type>PASSWORDproperty-type>
<description>The password is used to add the kerberos database administratordescription>
<value-attributes>
<type>passwordtype>
value-attributes>
property>


• 修改后效果图
  
  &＃xff08;4&＃xff09;实现swith滑块

• 效果要求&＃xff1a;实现滑块形式的开关要求

<property>
<name>hue-hdfs-module-enabledname>
<value>Yesvalue>
<display-name>Hue HDFS Moduledisplay-name>
<description>Enable Hue Filebrower Moduledescription>
<value-attributes>
<overridable>falseoverridable>
<type>value-listtype>
<entries>
<entry>
<value>Yesvalue>
<label>ONlabel>
entry>
<entry>
<value>Novalue>
<label>OFFlabel>
entry>
entries>
<selection-cardinality>1selection-cardinality>
value-attributes>
property>


• 修改前效果

• 修改后效果

&＃xff08;5&＃xff09;是否显示配置名称

• 目标效果&＃xff1a;隐藏部分name配置&＃xff0c;将value输入框设置为文本框

<value-attributes>

<type>contenttype>

<show-property-name>trueshow-property-name>
value-attributes>


• 输入框 VS 目录输入框VS 文本框显示效果

&＃xff08;6&＃xff09;自动创建用户和用户组

<property>
<name>elastic_username>
<display-name>Elasticsearch userdisplay-name>
<value>esvalue>
<description>Elasticsearch userdescription>
<property-type>USERproperty-type>
<value-attributes>
<type>usertype>
<user-groups>
<property>
<type>cluster-envtype>
<name>user_groupname>
property>
<property>
<type>elastic-envtype>
<name>es_groupname>
property>
user-groups>
value-attributes>
property>
<property>
<name>es_groupname>
<display-name>es User Groupdisplay-name>
<value>elasticsearch_groupvalue>
<property-type>GROUPproperty-type>
<description>es user group.description>
property>


• 注意事项&＃xff1a;只有在初始安装时可自动创建用户/用户组&＃xff0c;如果进行扩容则无法实现自动创建

&＃xff08;7&＃xff09;配置修改后&＃xff0c;提示重启服务


<metainfo>
<schemaVersion>2.0schemaVersion>
<services>
<service>
...(省略)

<components>
<component>
<name>ELASTICSEARCH_SERVICEname>
<displayName>Elasticsearch ServicedisplayName>
<category>MASTERcategory>
<cardinality>1&＃43;cardinality>
...(省略)
<configuration-dir>configurationconfiguration-dir>
<configuration-dependencies>
<config-type>elastic-configconfig-type>
configuration-dependencies>
...(省略)
component>
components>

<configuration-dir>configurationconfiguration-dir>
<configuration-dependencies>
<config-type>elastic-envconfig-type>
configuration-dependencies>

...(省略)
service>
services>
metainfo>


• 参数说明&＃xff1a; 作用域下的 / 来说&＃xff0c;如果在前端页面上修改了该 xml 文件内容后并保存配置&＃xff0c;那么整个服务都将会提示重启。如果是 的作用域下&＃xff0c;则只提示重启该 component 组件&＃xff0c;并不是所有组件都重启。

3、调试方法

1、修改文件
2、将修改文件覆盖/var/lib/ambari-server/resources/stacks/HDP/3.1/services/FLINK
3、重启ambari-server
4、卸载服务重新安装


• 文件配置路径&＃xff1a;Ambari 自定义服务的参数配置由 xml 文件管理&＃xff0c;默认存放在 configuration 目录下。如果要自定义该目录名称的话&＃xff0c;可以在 metainfo.xml 中声明&＃xff0c;在 service 标签下设置 configuration-dir 的值&＃xff1a;configuration-dir

• 配置修改记录会保存到 ambari 数据库中&＃xff0c;主要涉及到的表有如下&＃xff1a;

  
  
  • serviceconfig
  • serviceconfigmapping
  • clusterconfig&＃xff08;历史配置的详细内容&＃xff09;