Configure your Java build tool to use the Lightwell Network repository

Configure your Java build tool to resolve dependencies through the Lightwell Network repository by adding the repository to your existing build configuration.

Before you begin

You have an active Lightwell Network membership.
You have created a Lightwell Network service account. For more information, see Create a Lightwell Network service account
You have chosen the repository tier that matches your environment. For more information, see Choose the right repository for your environment.
You have one of the following Java build tools configured:
- Apache Maven
- Gradle

About this task

Select the configuration method that matches your build tool.

Procedure

If you are using Apache Maven:

Open your Maven settings.xml file.

Add one of the following blocks inside your existing <profiles> section, and add the corresponding <activeProfile> entry inside your existing <activeProfiles> section. If your settings.xml file does not have these sections, add the entire block:

Validated repository:

 <settings>
    <profiles>
      <profile>
        <id>lightwell-validated</id>
        <repositories>
          <repository>
            <id>lightwell-validated</id>
            <name>Lightwell Network - Validated</name>
            <url>https://packages.redhat.com/lightwell/java/validated/</url>
            <releases>
              <enabled>true</enabled>
            </releases>
            <snapshots>
              <enabled>false</enabled>
            </snapshots>
          </repository>
        </repositories>
      </profile>
    </profiles>
    <activeProfiles>
      <activeProfile>lightwell-validated</activeProfile>
    </activeProfiles>
  </settings>

Remediated repository:

 <settings>
    <profiles>
      <profile>
        <id>lightwell-remediated</id>
        <repositories>
          <repository>
            <id>lightwell-remediated</id>
            <name>Lightwell Network - Remediated</name>
            <url>https://packages.redhat.com/lightwell/java/remediated/</url>
            <releases>
              <enabled>true</enabled>
            </releases>
            <snapshots>
              <enabled>false</enabled>
            </snapshots>
          </repository>
        </repositories>
      </profile>
    </profiles>
    <activeProfiles>
      <activeProfile>lightwell-remediated</activeProfile>
    </activeProfiles>
  </settings>

Add a <server>block inside the <servers> section of your settings.xml file to configure authentication. The <id> must match the repository <id> in your profile. If your settings.xml file does not have a <servers> section, add one.
Validated repository:
```
<servers> 
    <server> 
        <id>lightwell-validated</id> 
        <username><service_account_username></username> 
        <password><service_account_token></password>
    </server>
</servers>
```
Remediated repository
```
<servers> 
    <server> 
        <id>lightwell-remediated</id> 
        <username><service_account_username></username> 
        <password><service_account_token></password>
    </server> 
</servers>
```
where:

<service_account_username>: Specifies your registry service account username in the format XXXXXXX|service-account-name

<service_account_token>: Specifies your registry service account token.
Save the file.

Note:

To switch to the other repository tier, replace the block with the one for the other tier.

If you are using Gradle:
1. Open your build.gradle file.
2. Add the following repositories block. Ensure the Lightwell Network repository is placed above mavenCentral() to prioritize patched versions:
  Validated repository:
  repositories { maven { name = "lightwell-validated" url "https://packages.redhat.com/lightwell/java/validated/" credentials { username = "<service_account_username>" password = "<service_account_token>" } mavenCentral() }
  Remediated repository
  repositories { maven { name = "lightwell-remediated" url "https://packages.redhat.com/lightwell/java/remediated/" credentials { username = "<service_account_username>" password = "<service_account_token>" } } mavenCentral() }
  where:
  
  <service_account_username>: Specifies your registry service account username in the format XXXXXXX|service-account-name.
  
  <service_account_token>: Specifies your registry service account token
  To use the validated repository instead, replace remediated with validated in the URL.
3. Add your service account credentials to your ~/.gradle/gradle.properties file.
  
  Note:
  
  Do not store credentials directly in your build.gradle file. Do not commit credentials to version control. Store them securely, for example, in your ~/.gradle/gradle.properties file.
4. Save the file.

What to do next

Run a build to confirm that dependencies resolve through the Lightwell Network repository:
For maven, run the following command:
```
$ mvn dependency:resolve
```
For Gradle, run the following command:
```
$ gradle dependencies
```
Verify that the build output shows artifacts resolving from the Lightwell Network repository URL.
If you are using the Remediated repository, add a remediated dependency to your project and verify that the resolved artifact includes the .rhlw-0000X version suffix, for example, 5.3.17.rhlw-00001.