官網(wǎng)說明: https://cwiki.apache.org/confluence/display/AMBARI/Configuration+support+in+Ambari

設(shè)置方法

服務(wù)需要配置的參數(shù)統(tǒng)一都是由.xml格式文件進行配置，默認(rèn)會讀取configuration/目錄下的.xml文件?？梢酝ㄟ^配置metainfo.xml中的<configuration-dir></configuration-dir>參數(shù)修改讀取的目錄。

在configuration/目錄下的.xml文件，都會在WebUI顯示，如下圖所示：

配置文件設(shè)置Custom xxx

默認(rèn)配置文件在WebUI可以配置兩種，一種是我們在.xml文件中指定的配置對應(yīng)Advanced xxx，另外一種是自定義配置對應(yīng)上面頁面中Custom xxx，自定義配置主要應(yīng)對我們沒有提前設(shè)置的參數(shù)，可以自定義補充。可以通過在.xml文件中參數(shù)supports_adding_forbidden="true"來控制是否需要Custom xxx，設(shè)置為false或者不添加該參數(shù)是需要Custom xxx。

配置方法

<configuration supports_adding_forbidden="true">...
</configuration>

詳細(xì)配置Custom xxx的方法見05.Ambari自定義服務(wù)開發(fā)-自定義服務(wù)配置文件生成

配置文件詳細(xì)的配置方法

.xml文件的整體格式

<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="configuration.xsl"?>
<configuration>
....
</configuration>

在<configuration>下可以設(shè)置我們需要配置的具體配置參數(shù)了

基礎(chǔ)參數(shù)格式

<property><name>doris_pid_dir</name><display-name>Doris pid directory</display-name><value>/var/run/doris</value><description>Doris pid directory</description>
</property>

說明：

• name：屬性名稱
• display-name：WebUI中顯示的屬性名稱，如未設(shè)置display-name，前端頁面顯示name值
• value：屬性具體值，在WebUI中顯示的值，可修改
• description：描述信息，在WebUI中顯示。

在頁面中如下圖所示

value-attributes配置介紹

參考：https://blog.csdn.net/qq_44226094/article/details/130210270

用于設(shè)置參數(shù)的類型、是否為空等等

樣例

<!-- 這里規(guī)定了屬性值的類型為int，最小值為0，最大值為48000 -->
<value-attributes><!-- 值類型boolean/ int/ float/ directory/ directories/ content/value-list/ user/ password --><type>int</type><!--是否可復(fù)寫 true/ false --><overridable>true</overridable><!-- 空值是否有效 true/ false --><empty-value-valid>true</empty-value-valid><!-- property是否 ui true/ false --><ui-only-property>true</ui-only-property><!-- 不可編輯 true / false --><read-only>true</read-only><!--值是否在安裝時可編輯 true/ false --><editable-only-at-install></editable-only-at-install><!-- property 顯示值 true/ false --><show-property-name></show-property-name><!-- 步長 --><increment-step>100</increment-step><!-- 可選值 --><selection-cardinality>2+</selection-cardinality><!-- property 文件名 --><property-file-name></property-file-name><!-- property文件類型 --><property-file-type></property-file-type><!-- 條目 --><entries><entry><value>2</value></entry><!-- ... --></entries><!-- 隱藏 --><hidden></hidden><!--條目是否可編輯 true/ false --><entries-editable></entries-editable><!-- 用戶組 --><user-groups></user-groups><!-- 密鑰庫是否啟用 true/ false --><keystore></keystore><!-- 最小值 --><minimum>0</minimum><!-- 最大值 --><maximum>48000</maximum><!-- 值單位 B/ MB/ ms/ Bytes/ milliseconds --><unit></unit><!--可見  --><visible></visible><!-- 復(fù)制 --><copy></copy>
</value-attributes>

設(shè)置屬性在服務(wù)安裝后不可修改

在<property>標(biāo)簽內(nèi)添加：

<value-attributes><editable-only-at-install>true</editable-only-at-install>
</value-attributes>

使用樣例

<property><name>test_editable-only-at-install</name><display-name>測試服務(wù)安裝后不可編輯</display-name><value>123456</value><description>測試服務(wù)安裝后不可編輯描述</description><value-attributes><editable-only-at-install>true</editable-only-at-install></value-attributes>
</property>

效果

設(shè)置允許字段為空

在<property>標(biāo)簽內(nèi)添加：

<value-attributes><empty-value-valid>true</empty-value-valid>
</value-attributes>

使用樣例

    <property><name>test_empty-value-valid</name><display-name>測試字段允許為空</display-name><value>123456</value><description>測試字段允許為空描述</description><value-attributes><empty-value-valid>true</empty-value-valid></value-attributes></property>

tip:

1. empty-value-valid參數(shù)為true代表可以為空，不設(shè)置或者為false是不能為空

2. 如果不設(shè)置<empty-value-valid>true</empty-value-valid>參數(shù)，不填寫內(nèi)容，會提示需要填寫

效果

是否顯示配置名稱

在<property>標(biāo)簽內(nèi)添加：

<value-attributes><!-- 默認(rèn)為input輸入框，當(dāng)type為content時，即為文本框 --><type>content</type><!-- 是否顯示配置名稱 --><show-property-name>false</show-property-name>
</value-attributes>

使用樣例

     <property><name>test_show-property-name</name><display-name>測試是否顯示配置名稱</display-name><value>123456</value><description>測試是否顯示配置名稱描述</description><value-attributes><!-- 默認(rèn)為input輸入框，當(dāng)type為content時，即為文本框 --><type>content</type><!-- 是否顯示配置名稱 --><show-property-name>false</show-property-name></value-attributes></property>

效果

參數(shù)類型設(shè)置

字符串類型

    <property><name>fe_passwd</name><display-name>Frontend密碼</display-name><value>  </value><description>默認(rèn)無密碼,用來添加節(jié)點、檢查節(jié)點連接客戶端使用</description></property>

Password

    <property><name>fe_passwd</name><display-name>Frontend密碼</display-name><value>  </value><value-attributes><type>password</type></value-attributes><description>默認(rèn)無密碼,用來添加節(jié)點、檢查節(jié)點連接客戶端使用</description></property>

樣例

Boolean

    <property><name>test_type_boolean</name><display-name>測試類型-boolean</display-name><value></value><value-attributes><type>boolean</type></value-attributes></property>

樣例

Int

    <property><name>test_type_int</name><display-name>測試類型-int</display-name><value></value><value-attributes><type>int</type></value-attributes></property>

樣例

Float

    <property><name>test_type_float</name><display-name>測試類型-float</display-name><value></value><value-attributes><type>float</type></value-attributes></property>

樣例

Directory

填寫目錄格式數(shù)據(jù)，非目錄格式無法填寫

    <property><name>test_type_directory</name><display-name>測試類型-directory</display-name><value></value><value-attributes><type>directory</type></value-attributes></property>

樣例

Directories

填寫多個目錄格式數(shù)據(jù)，多個目錄采用逗號分隔，或者換行分隔，換行分隔保存后會自動轉(zhuǎn)換成逗號分隔

    <property><name>test_type_directories</name><display-name>測試類型-directories</display-name><value></value><value-attributes><type>directories</type></value-attributes></property>

樣例

Content-多行文本

    <property><name>test_type_content</name><display-name>測試類型-content</display-name><value></value><value-attributes><type>content</type></value-attributes></property>

樣例

user-自動創(chuàng)建用戶和用戶組

配置后會自動創(chuàng)建用戶和用戶組，并將用戶設(shè)置到某個組下，doris-env.xml文件部分內(nèi)容如下

    <property><name>doris_user</name><display-name>Doris user</display-name><value>doris</value><description>Doris user</description><!--選擇配置的屬性為用戶，設(shè)置成用戶則會自動創(chuàng)建該用戶--><property-type>USER</property-type><value-attributes><type>user</type><overridable>false</overridable><!--設(shè)置用戶所屬用戶組--><user-groups><!--設(shè)置用戶組屬于，cluster-env->user_group的配置--><!--讀取的配置最終會統(tǒng)一匯總到/var/lib/ambari-agent/data/command-xxx.json這個文件，可以在這里直接查詢驗證--><property><type>cluster-env</type><name>user_group</name></property><!--設(shè)置用戶組屬于，doris-env->doris_group的配置，這里doris-env就是當(dāng)前文件的配置--><property><type>doris-env</type><name>doris_group</name></property></user-groups></value-attributes></property><property><!--創(chuàng)建用戶組，組名為doris_group--><name>doris_group</name><display-name>doris User Group</display-name><value>doris_group</value><property-type>GROUP</property-type><description>doris user group.</description></property>

上面配置實現(xiàn)了：創(chuàng)建一個名為doris的用戶，并將其分配到特定的用戶組（doris_group和hadoop）

tip：cluster-env->user_group獲取到的值就是hadoop