Configure Moderne DX with Artifactory access: recipes

In order for Moderne DX to interact with your recipe artifacts from Artifactory, you will need to create a Maven formatted repository inside of Artifactory and point the Moderne DX service to said repository. This guide will walk you through how to configure the Moderne DX service to get the list of recipe artifacts from the repository you created in Artifactory.

Publishing recipe artifacts

Recipe artifacts will automatically be picked up by Moderne so long as you set the recipe source flag to true in the below configuration step.

Configuring the Moderne DX service

The following table contains all of the variables/arguments you need to add to your Moderne DX service run command in order for it to get recipe artifacts from your Maven formatted repository inside of Artifactory. Please note that these variables/arguments must be combined with ones found in other steps in the Configuring the Moderne DX service guide.

You can configure multiple Maven formatted repositories by including multiple entries, each with a different {index}.

OCI Container

Variables:

• MODERNE_DX_MAVEN_{index}_URL – The URL of your Maven repository inside of Artifactory.

• MODERNE_DX_MAVEN_{index}_ASTSOURCE – Specifies whether or not this repository should be searched for LST artifacts. Defaults to true – but you should set this to false (Note: LSTs used to be called ASTs).

• MODERNE_DX_MAVEN_{index}_LOCALREPOSITORY – The path on disk where Maven index files will be downloaded to. This is on the disk where the service is being run and not in Artifactory. Defaults to ~/.moderne-maven

  • If multiple Maven repositories are configured on the service, they must have different MODERNE_DX_MAVEN_{index}_LOCALREPOSITORY configured.

• MODERNE_DX_MAVEN_{index}_USERNAME – (Optional) The username used to resolve artifacts. Defaults to null.

• MODERNE_DX_MAVEN_{index}_PASSWORD – (Optional) The password used to resolve artifacts. Defaults to null.

• MODERNE_DX_MAVEN_{index}_RELEASES – (Optional) Specifies whether or not this repository should be searched for releases. Defaults to true.

• MODERNE_DX_MAVEN_{index}_SNAPSHOTS – (Optional) Specifies whether or not this repository should be searched for snapshots. Defaults to true.

• MODERNE_DX_MAVEN_{index}_RECIPESOURCE – (Optional) Specifies whether or not this repository should be searched for recipe jars. Defaults to true.

• MODERNE_DX_MAVEN_{index}_SKIPSSL – (Optional) Whether or not to skip SSL/TLS verification for calls from the service to this Maven repository. This must be set to true if you use a self-signed SSL/TLS certificate. Defaults to false.

• MODERNE_DX_MAVEN_{index}_SKIPVALIDATECONNECTIVITY– (Optional) By default, on startup dx we validate that it can connect to the configured resource, and fail to start up the dx if we cannot. Set this to true to skip this validation. Defaults to false.

Example:

docker run \
# ... Existing variables
-e MODERNE_DX_MAVEN_0_URL=https://myartifactory.example.com/artifactory/libs-releases-local \
-e MODERNE_DX_MAVEN_0_ASTSOURCE=false \
-e MODERNE_DX_MAVEN_0_LOCALREPOSITORY=~/.moderne-maven \
-e MODERNE_DX_MAVEN_0_USERNAME=admin \
-e MODERNE_DX_MAVEN_0_PASSWORD=password \
# ... Additional variables

Executable JAR

Arguments:

• --moderne.dx.maven[{index}].url – The URL of your Maven repository inside of Artifactory.

• --moderne.dx.maven[{index}].astSource – Specifies whether or not this repository should be searched for LST artifacts. Defaults to true – but you should set this to false (Note: LSTs used to be called ASTs).

• --moderne.dx.maven[{index}].localRepository – The path on disk where Maven index files will be downloaded to. This is on the disk where the service is being run and not in Artifactory. Defaults to ~/.moderne-maven

  • If multiple Maven repositories are configured on the service, they must have different --moderne.dx.maven[{index}].localRepository configured.

• --moderne.dx.maven[{index}].username – (Optional) The username used to resolve artifacts. Defaults to null.

• --moderne.dx.maven[{index}].password – (Optional) The password used to resolve artifacts. Defaults to null.

• --moderne.dx.maven[{index}].releases – (Optional) Specifies whether or not this repository should be searched for releases. Defaults to true.

• --moderne.dx.maven[{index}].snapshots – (Optional) Specifies whether or not this repository should be searched for snapshots. Defaults to true.

• --moderne.dx.maven[{index}].recipeSource – (Optional) Specifies whether or not this repository should be searched for recipe jars. Defaults to true.

• --moderne.dx.maven[{index}].skipSsl – (Optional) Whether or not to skip SSL/TLS verification for calls from the service to this Maven repository. This must be set to true if you use a self-signed SSL/TLS certificate. Defaults to false.

• --moderne.dx.maven[{index}].skipValidateConnectivity– (Optional) By default, on startup dx we validate that it can connect to the configured resource, and fail to start up the dx if we cannot. Set this to true to skip this validation. Defaults to false.

Example:

java -jar moderne-dx-{version}.jar \
# ... Existing arguments
--moderne.dx.maven[0].url=https://myartifactory.example.com/artifactory/libs-releases-local \
--moderne.dx.maven[0].astSource=false \
--moderne.dx.maven[0].localRepository=~/.moderne-maven \
--moderne.dx.maven[0].username=admin \
--moderne.dx.maven[0].password=password \
# ... Additional arguments