NES for Kafka 3.1.x Setup

Setup Instructions

NES for Apache Kafka 3.1.x requires Java 11.

Configure Registry

Create or update your registry configuration:

Maven (~/.m2/settings.xml)

Gradle (~/.gradle/gradle.properties)

<settings>
  <servers>
    <server>
      <id>herodevs-nes-registry</id>
      <username>any_text_here_not_used</username>
      <password>YOUR_NES_ACCESS_TOKEN</password>
    </server>
  </servers>
</settings>

See the guides for Sonatype Nexus or JFrog Artifactory for setup to the HeroDevs NES registry.

Update Build Configuration

Add the NES repository and dependencies to your build configuration:

Look up the latest artifact version in the "Kafka Release Notes".

In a Spring Boot application that uses Spring Boot dependency management, set the kafka.version property to apply the NES version to every artifact that Spring Boot manages. See Spring Boot Dependency Management for details.

Maven (pom.xml)

Gradle (Groovy)

Gradle (Kotlin)

<properties>
  <kafka.version>3.1.2-kafka-3.1.4</kafka.version>
</properties>

<!-- Add NES repository -->
<repositories>
  <repository>
    <id>herodevs-nes-registry</id>
    <url>https://registry.nes.herodevs.com/maven</url>
  </repository>
</repositories>

Otherwise, add the NES dependencies directly to your build configuration:

Maven (pom.xml)

Gradle

<!-- Update Kafka-clients dependency version. Other option is using NES version for each kafka import -->
<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>org.apache.kafka</groupId>
      <artifactId>kafka-clients</artifactId>
      <version>3.1.2-kafka-3.1.4</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<!-- Add NES repository -->
<repositories>
  <repository>
    <id>herodevs-nes-registry</id>
    <url>https://registry.nes.herodevs.com/maven</url>
  </repository>
</repositories>

Build

In order to remove potential obstacles before building your project, make sure the following domains are whitelisted by your firewall/networking team:

registry.nes.herodevs.com
assets.nes.herodevs.com

This will ensure that your network/firewall allows connection to our registry.

Run your build tool:

Maven

Gradle

mvn clean package

Verification

To verify your installation, check that:

Dependencies are downloaded successfully
No version conflicts are reported in your build
Your application starts without errors

Manual Downloads

The direct download URLs for NES for Apache Kafka packages follow this format:

Portion	Value
base_url	https://registry.nes.herodevs.com/maven/org/apache/kafka/
package_name	kafka-clients
version	3.1.2-kafka-3.1.4
filename	package_name + version + extension

Example Link

https://registry.nes.herodevs.com/maven/org/apache/kafka/kafka-clients/3.1.2-kafka-3.1.4/kafka-clients-3.1.2-kafka-3.1.4.pom