Blog Post: OpenSearch plugin zips now in Maven repo

Gemfile

@@ -33,3 +33,5 @@ end
 gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]
 
 gem "rouge"
+
+gem "webrick", "~> 1.7"

Gemfile.lock

@@ -73,6 +73,7 @@ GEM
     terminal-table (2.0.0)
       unicode-display_width (~> 1.1, >= 1.1.1)
     unicode-display_width (1.7.0)
+    webrick (1.7.0)
 
 PLATFORMS
   ruby
@@ -91,6 +92,7 @@ DEPENDENCIES
   tzinfo (~> 1.2)
   tzinfo-data
   wdm (~> 0.1.1)
+  webrick (~> 1.7)
 
 BUNDLED WITH
-   2.3.5
+   2.3.18

_authors/prudhvigodithi.markdown

@@ -0,0 +1,8 @@
+---
+name: Prudhvi Godithi
+short_name: prudhvigodithi
+linkedin: 'prudhvi-godithi'
+photo: '/assets/media/authors/prudhvigodithi.jpg'
+---
+
+**Prudhvi Godithi** is an AWS System Engineer working on the OpenSearch project.

_posts/2022-07-24-opensearch-plugin-zips-now-in-maven-repo.markdown

@@ -0,0 +1,95 @@
+---
+layout: post
+title:  "OpenSearch plugin zips now in Maven repo"
+authors: 
+  - prudhvigodithi
+date: 2022-07-24 01:01:01 -0700
+categories: 
+  - technical-post
+twittercard:
+  description: "Details on how to consume OpenSearch plugin zips from a Maven repo and the process involved in shipping them to a Maven repo."
+---
+
+Starting with the release of OpenSearch `2.1.0`, OpenSearch plugin zips are now signed and published to a central Apache Maven [repo](https://repo1.maven.org/maven2/org/opensearch/plugin/).  Using the [Release zips](https://repo1.maven.org/maven2/org/opensearch/plugin/) and [Snapshot zips](https://aws.oss.sonatype.org/content/repositories/snapshots/org/opensearch/plugin/) Maven Repo URLs, OpenSearch plugin zips can now be consumed  as a dependency to build other plugins or fetched as standalone components for your OpenSearch cluster. 
+
+## Motivation 
+
+Before OpenSearch 2.1, plugin zips used as dependencies could not be downloaded dynamically during runtime because plugin zips were not a part of the version-controlled Maven system. The only mechanism for plugin downloads was each plugins' respective Java jars through Maven coordinates. This system forced users who wanted more control over their OpenSearch plugin configuration to use a dependency plugin zip built on a developer desktop instead of a more reliable version-controlled plugin. 
+
+Furthermore, to facilitate the plugin availability as a dependency, tests executed against as part the OpenSearch build process from zip were not accurate, as each local build zip had to find the plugin repo in order to ensure that plugin's availability. These restrictions were challenging to our community since using plugin zips as separate isolated components via a cached mechanism proved to be impossible. 
+
+## Benefits of Maven
+
+With Maven, plugin zips can now be retrieved by:
+
+- Downloading each plugin directly using their respective Maven coordinates .
+- Using clickstream from the central Maven repo, which can be cached later to a local Maven repo.
+- Fetching the development `SNAPSHOT` version with same Maven `groupID` as [org.opensearch.plugin](https://aws.oss.sonatype.org/content/repositories/snapshots/org/opensearch/plugin/).
+
+Using OpenSearch plugin zips through Maven offers the following benefits:
+
+- Plugins zip in the central Maven repo are already signed with `.asc`, `.md5`, `.sha1`, `.sha256`, and `.sha512` extensions.
+- Users are no longer required to to check in zips to any `src/` files since zips can be fetched with the right `groupID`, `artifactID`, and `version`.
+- Tests and CI workflows can directly run against zips from the Maven repo instead of requiring a manual download. 
+
+## Maven zip publication with Gradle
+
+OpenSearch publishes plugin zips using a custom Gradle plugin, `opensearch.pluginzip`. With OpenSearch 2.1, all OpenSearch Gradle-supported plugins create a new task, `publishPluginZipPublicationToZipStagingRepository`. The task performs all the heavy lifting for users by:
+
+- Identifying the distribution plugin zip.
+- Setting the Maven coordinates.
+- Generating the POM file.
+- Updating with the user-generated POM fields.
+- Publishing the zip to your Maven repo.
+
+You can find more details about the inner workings of OpenSearch plugins in the [opensearch-plugins repo](https://github.com/opensearch-project/opensearch-plugins/blob/main/BUILDING.md#opensearchpluginzip).
+
+**Figure 1**: Workflow that ships generated plugin zips to Maven
+
+![Figure 1: Workflow that ship zips to maven]({{ site.baseurl }}/assets/media/blog-images/2022-07-24-opensearch-plugin-zips-now-in-maven-repo/figure1.png){: .img-fluid }**Figure 1**: Workflow that ships generated plugin zips to Maven
+
+## Consume plugin in zips
+
+You can fetch plugin in zips in three different ways:
+
+**Using the Maven CLI**
+
+Consume from central Maven repo:
+
+```
+mvn dependency:get -DgroupId=org.opensearch.plugin -DartifactId=opensearch-job-scheduler -Dversion=2.1.0.0 -Dpackaging=zip -DremoteRepositories=central::default::https://repo.maven.apache.org/maven2,myrepo::::http://myrepo.com/maven2
+```
+
+Consume from the Snapshot Maven repo:
+
+```
+Snapshot Maven repo
+mvn dependency:get -DgroupId=org.opensearch.plugin -DartifactId=opensearch-job-scheduler -Dversion=2.1.0.0-SNAPSHOT -Dpackaging=zip -DremoteRepositories=https://aws.oss.sonatype.org/content/repositories/snapshots/
+```
+
+**Gradle Project: Using the build.gradle file**
+
+```
+dependencies {
+    classpath "org.opensearch.plugin:opensearch-job-scheduler:2.1.0.0@zip"
+    classpath "org.opensearch.plugin:opensearch-knn:2.1.0.0@zip"
+}
+```
+
+**Maven Project: Using the pom.xml file**
+
+```
+<dependencies>
+        <dependency>
+            <groupId>org.opensearch.plugin</groupId>
+            <artifactId>opensearch-job-scheduler</artifactId>
+            <version>2.1.0.0</version>
+            <packaging>zip</packaging>
+        </dependency>
+</dependencies>
+```
+
+
+
+
+