OpenSearch Common Utils
OpenSearch Common Utils is focused on providing reusable Java components for OpenSearch plugins.
This library is composed of following parts:
- SecureRestClientBuilder - provides methods to create secure low-level and high-level REST client. This is useful to make secure REST calls to OpenSearch or other plugin api's.
- InjectSecurity - provides methods to inject user or roles. This is useful for running background jobs securely.
- IntegTestsWithSecurity - provides methods to create users, roles for running integ tests with security plugin.
- Shared Request/Response/Action classes used for plugin to plugin transport layer calls.
- Any common functionality across OpenSearch plugins could be moved to this.
Setup
- Check out this package from version control.
- Launch Intellij IDEA, choose Import Project, and select the
settings.gradle
file in the root of this package. - To build from the command line, set
JAVA_HOME
to point to a JDK >= 14 before running./gradlew
.
Build
Building from the command line
./gradlew clean
./gradlew build
./gradlew publishToMavenLocal
Logging
To change loglevel, add below to config/log4j2.properties
or use REST API to set.
logger.commons.name = com.amazon.opendistroforelasticsearch.commons
logger.commons.level = debug
Code of Conduct
This project has adopted an Open Source Code of Conduct.
Security issue notifications
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.
Licensing
See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.
Copyright
Copyright 2020 Amazon.com, Inc. or its affiliates. All Rights Reserved.