Experimental feature flags
출처: 문서
본문
실험용 기능 플래그
OpenSearch 릴리스에는 필요에 따라 활성화하거나 비활성화할 수 있는 실험용 기능이 포함되어 있을 수 있어요. 기능 플래그를 활성화하는 방법은 설치 방식에 따라 여러 가지가 있어요.
opensearch.yml에서 활성화하기
OpenSearch 클러스터를 실행 중이고 설정 파일에서 기능 플래그를 활성화하고 싶다면, opensearch.yml에 다음 줄을 추가해요:
opensearch.experimental.feature.<feature_name>.enabled: true
{% include copy.html %}
Docker 컨테이너에서 활성화하기
Docker를 실행 중이라면, opensearch-node > environment 섹션 아래의 docker-compose.yml에 다음 줄을 추가해요:
OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true"
{% include copy.html %}
tarball 설치에서 활성화하기
tarball 설치에서 기능 플래그를 활성화하려면, 새로운 JVM 파라미터를 config/jvm.options 또는 OPENSEARCH_JAVA_OPTS 중 한 곳에 지정해 주세요.
옵션 1: jvm.options 수정하기
기능과 그 의존성을 활성화하려면, opensearch 프로세스를 시작하기 전에 config/jvm.options에 다음 줄을 추가해요:
-Dopensearch.experimental.feature.<feature_name>.enabled=true
{% include copy.html %}
그다음 OpenSearch를 실행해요:
./bin/opensearch
{% include copy.html %}
옵션 2: 환경 변수로 활성화하기
config/jvm.options를 직접 수정하는 대신, 환경 변수를 사용해 속성을 정의할 수도 있어요. 이는 OpenSearch를 시작할 때 한 번의 명령으로 처리하거나, export로 변수를 정의해서 할 수 있어요.
OpenSearch를 시작할 때 기능 플래그를 인라인으로 추가하려면, 다음 명령을 실행해요:
OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true" ./opensearch-{{site.opensearch_version}}/bin/opensearch
{% include copy.html %}
OpenSearch를 실행하기 전에 환경 변수를 따로 정의하고 싶다면, 다음 명령들을 실행해요:
export OPENSEARCH_JAVA_OPTS="-Dopensearch.experimental.feature.<feature_name>.enabled=true"
{% include copy.html %}
./bin/opensearch
{% include copy.html %}
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'
}
}
{% include copy.html %}