10.避免YAML格式问题.md
本文最后更新于:2023年12月5日 晚上
配置文件使用YAML作为其语法。当您编辑文件以修改配置设置时,您应该知道一些事情。
使用空格缩进
缩进在YAML中是有意义的。确保使用空格而不是制表符来缩进部分。 在默认配置文件和留档中的所有示例中,每个缩进级别使用2个空格。我们建议您也这样做。
查看默认配置文件的结构
了解在哪里定义配置选项的最佳方法是查看提供的示例配置文件。配置文件包含Beat可用的大多数默认配置。要更改设置,只需取消注释行并更改值。
测试您的配置文件
您可以测试配置文件以验证结构是否有效。只需更改到安装二进制文件的目录,然后使用指定的test config命令在前台运行Beat。例如:
You’ll see a message if the Beat finds an error in the file.
用单引号括住正则表达式
如果您需要在YAML文件中指定正则表达式,最好将正则表达式包装在单引号中,以解决YAML棘手的字符串转义规则。
有关YAML的更多信息,请参见 http://yaml.org/.
用单引号括起路径
特别是Windows路径有时包含空格或字符,例如驱动器号或三个点,这些可能会被YAML解析器误解。
为了避免这个问题,最好用单引号包装路径。
避免在数值中使用前导零
如果在数字字段中使用前导零(例如,09
)而不将值括在单引号中,则YAML解析器可能会错误地解释该值。如果该值是有效的八进制,则将其转换为整数。如果不是,则将其转换为浮点数。
要防止不必要的类型转换,请避免在字段值中使用前导零,或将值包装在单引号中。
避免意外的模板变量解析
允许配置从环境变量解析数据的模板引擎可能会导致带有$
字符的字符串中出现错误。例如,如果密码字段包含$$
,引擎将将其解析为$
。 要解决此问题,请使用Secrets密钥库或使用$$
转义所有$
实例。
要解决此问题,请使用Secrets密钥库或使用$$
转义所有$
实例。