实验性功能标志

OpenSearch 版本可能包含实验性功能，您可以根据需要启用或禁用这些功能。根据安装类型，有几种启用功能标志的方法。

在 opensearch.yml 中启用

如果您正在运行 OpenSearch 集群并希望在配置文件中启用功能标志，请将以下行添加到 opensearch.yml

opensearch.experimental.feature.<feature_name>.enabled: true

在 Docker 容器上启用

如果您正在运行 Docker，请将以下行添加到 docker-compose.yml 中 opensearch-node > environment 部分

OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true"

在 Tarball 安装上启用

要在 tarball 安装上启用功能标志，请在 config/jvm.options 或 OPENSEARCH_JAVA_OPTS 中提供新的 JVM 参数。

选项 1：修改 jvm.options

在启动 opensearch 进程之前，将以下行添加到 config/jvm.options 中以启用该功能及其依赖项

-Dopensearch.experimental.feature.<feature_name>.enabled=true

然后运行 OpenSearch

./bin/opensearch

选项 2：使用环境变量启用

作为直接修改 config/jvm.options 的替代方法，您可以通过使用环境变量来定义属性。这可以在启动 OpenSearch 时使用单个命令完成，或者通过 export 定义变量。

要在启动 OpenSearch 时内联添加功能标志，请运行以下命令

OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true" ./opensearch-3.1.0/bin/opensearch

如果您想在运行 OpenSearch 之前单独定义环境变量，请运行以下命令

export OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true"

./bin/opensearch

为 OpenSearch 开发启用

要为开发启用功能标志，您必须在构建 OpenSearch 之前将正确的属性添加到 run.gradle。有关如何使用 Gradle 构建 OpenSearch 的信息，请参阅开发人员指南。

将以下属性添加到 run.gradle 以启用该功能

testClusters {
    runTask {
      testDistribution = 'archive'
      if (numZones > 1) numberOfZones = numZones
      if (numNodes > 1) numberOfNodes = numNodes
      systemProperty 'opensearch.experimental.feature.<feature_name>.enabled', 'true'
    }
  }