• OpenSearch Build Libraries
  • Jenkins Shared Libraries
• Contributing
• Getting Help
• Code of Conduct
• Security
• License
• Copyright

OpenSearch Build Libraries

OpenSearch build libraries consist of shared libraries used to build, test and release OpenSearch, OpenSearch Dashboards and its associated products such as clients, drivers, etc.

Jenkins Shared Libraries

This repository consist of jenkins shared libraries as one of the libraries. Read more about jenkins shared libraries here Checkout different retrieval methods that can be used by jenkins files to use this remote library.

Example:

lib = library(identifier: 'jenkins@<tag>', retriever: modernSCM([
    $class: 'GitSCMSource',
    remote: 'https://github.com/opensearch-project/opensearch-build-libraries.git',
]))

Library Details

Name	Description
standardReleasePipeline.groovy	The library sets up the necessary jenkins properties for you such as agent label, docker image to use as well as workflow time out. Check how to use the default in your workflow and how to overide agent & docker image if you need.
standardReleasePipelineWithGenericTrigger.groovy	A standard release pipeline for OpenSearch projects including generic triggers. A tag or a draft release can be used as a trigger using this library. The defaults are all set to trigger via a draft release. If the release is successful, the release can be published by using right params.. Check how to use the default in your workflow and how to overide values.
publishToNpm.groovy	A library to publish artifacts to NPM registry under @opensearch-project namespace. You can use PublishToNpmLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
publishToPyPi.groovy	A library to publish artifacts to PyPi registry with OpenSearch as the maintainer. This library takes care of signing the artifacts before publishing. You can use PublishToPyPiLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
publishToRubyGems.groovy	A library to publish gems to rubygems.org with opensearchproject as the owner. Please note that this library expects the gems to be pre-signed. You can use PublishToRubyGemsLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
publishToMaven.groovy	A library to sign and deploy opensearch maven artifacts to sonatype staging repository, it also has an optional parameter autoPublish to auto-release artifacts from staging repo to prod without manual intervention. You can use PublishToMavenLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
publishToNuget.groovy	A library to build, sign and publish dotnet artifacts to Nuget Gallery. Please check if the default docker file contains the required dotnet sdk. You can use PublishToNugetLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
publishToArtifactsProdBucket.groovy	This library signs and uploads the artifacts to production S3 bucket which points to artifacts.opensearch.org. Please make sure the role that you use to upload exists and has the right permission. For artifacts of different types like macos, linux and windows, call this lib for each artifact with different signing parameters. You can use PublishToArtifactsProdBucketLibTester to add tests in your repository. See how to use the lib in your jenkinsFile.
buildMessage.groovy	This library that can parse the jenkins build log based on the user defined input query string.
closeBuildSuccessGithubIssue.groovy	This library that identifies the successfully built components and closes the created [AUTOCUT] issues.
createGithubIssue.groovy	This library that identifies the failed components and creates the [AUTOCUT] issues.
publishGradleCheckTestResults.groovy	This library runs part of Gradle Check and publishes the failed test data to the OpenSearch Metrics Cluster.
gradleCheckFlakyTestDetector.groovy	This library detects the flaky tests from OpenSearch Metrics Cluster and generates a test report.
gradleCheckFlakyTestGitHubIssue.groovy	This library is used in gradleCheckFlakyTestDetector.groovy to create/edit the GitHub Issue using the generated test report.
publishDistributionBuildResults.groovy	This library is used for publishing the OpenSearch Project Distribution build results to the OpenSearch Metrics cluster.
publishIntegTestResults.groovy	This library is used for publishing the OpenSearch Project Integration Test results to the OpenSearch Metrics cluster.

Contributing

See developer guide and how to contribute to this project.

Getting Help

If you find a bug, or have a feature request, please don't hesitate to open an issue in this repository.

For more information, see project website and documentation. If you need help and are unsure where to open an issue, try forums.

Code of Conduct

This project has adopted the Amazon Open Source Code of Conduct. For more information see the Code of Conduct FAQ, or contact [email protected] with any additional questions or comments.

Security

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.

License

This project is licensed under the Apache v2.0 License.

Copyright

Copyright OpenSearch Contributors. See NOTICE for details.