Description

Artifactory is a repository manager that supports all software management packages, container images and Helm charts. It manages artifacts throughout a DevOps pipeline. The Artifactory plugin integrates with the Artifactory repository to import artifacts for Maven, Gradle, and Ivy builds.

Quick Info

Product
HCL Launch
Type
plugin
Compatibility
HCL Launch 6.0.1 and later
Created by
HCL Software
Updated Date
December 23, 2021
Version Name Modified date Action

21.1098499

launch-artifactory-21.1098499.zip 15-Mar-2021 13:27

22.1126875

launch-artifactory-22.1126875.zip 23-Dec-2021 06:19

launch-artifactory-21.1098499.zip

21.1098499


launch-artifactory-22.1126875.zip

22.1126875


Summary

The Artifactory automation plugin includes steps to complete the following tasks:

  • Importing artifacts from an Artifactory repository corresponding to Maven, Gradle or Ivy builds.
  • Importing NuGet packages from a remote NuGet repository through an Artifactory repository.
  • Attach properties to a file or folder.
  • Retrieve the latest build artifact within a SNAPSHOT.
  • Retrieve an archive file that contains all the artifacts for a specific build.

This plugin includes one or more steps, click Steps for step details and properties.

Compatibility

This plugin works with Jfrog Artifactory versions 2.0+ . The Artifactory Pro edition is also supported.

This plugin requires HCL Launch 6.0.1 and later.

This plugin runs on all operating systems that are supported by the HCL Launch agent.

Installation

See Installing plugins in HCL Launch for installing and removing plugins.

History

The following table describes the changes made in each plugin version.

Plugin history details
Version Description
21 Minor enhancements

Usage

Before you begin, the HCL Launch agent must be installed on the target system where the artifacts are downloaded.

Step palette

To access this plugin in the palette, click Repositories > Artifact > Artifactory.

Complete the following steps to create resources and define a deployment process.

  1. To download the files that are imported from Artifactory to the agent computer, define a resource for the agent.
  2. Add the agent to the new resource group.
    • Hover over the row for the resource group, click Actions, and then select Add agent.
  3. Create components for the resources. The component process can include any of the plugin steps: Download version (Maven build), Download version (non-Maven build) or Download NuGet package.
  4. Add the components to the resources.
    • Navigate to the resource.
    • Click Actions > Add Component.
    • Select the component to use.
  5. Create the application.
    • Navigate to Applications.
    • If an application does not exist, click Create New Application. You can also use an existing application.
    • Enter an application name, and then click Save.
    • Click the Components tab, then add the component that you created previously.
  6. Create an application environment.
    • On the Resources page, click Create New Environment.
    • Enter an environment name, and then click Save.
    • Navigate to the environment editor page.
    • Click the environment name, and then click Add Base Resource. Select the group that you created previously.
  7. Create an application process.
    • Click the Processes tab.
    • Add a deploy step.
    • Drag the Install Component step to the process editor.
      • Select the component that you created for the resource.
      • Select the process for the component. For example, select Download My Maven package from Artifactory.
    • Click Save to save the process.
  8. Run the process to test the new component.

Steps

The following process steps are available in the Artifactory plugin.

Download Latest Build for SNAPSHOT

Retrieve the latest build artifact within a SNAPSHOT.

Input properties for the Download Latest Build for SNAPSHOT step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using api key, username and password is ignored. No apiKey
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory. Yes url
Artifactory Repository String The repository in Artifactory where the build artifact resides. For example:libs-snapshot-local Yes repo
Classifier String The classifier of the version snapshot, if any. No classifier
File Extension String The file extension of the build artifact. For example: jar Yes extension
Password Password The password to authenticate with the Artifactory server. No password
Repo Path String The path (group ID and artifact ID) of the build artifact. For example: org.jfrog.test/multi2 Yes repoPath
User Name String The user name to authenticate with the Artifactory server. No username
Version String The version of the build artifact. For example: 3.8-SNAPSHOT Yes version

Download NuGet Package

Download a NuGet package from a NuGet repository.

Input properties for the Download NuGet Package step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using api key, username and password is ignored. No apiKey
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory Yes artifactoryUrl
Packages String A list of packages to download, separated by newline characters. Use the following format: repoPath/version Yes artifacts
Repository Password Password The password to authenticate with Artifactory. No password
Repository User name String The user name to authenticate with Artifactory. No username
Verify Hash Boolean Select to verify hash values after the files are downloaded. No checkHash

Download version (Maven build)

Download all files under a specified version of a repository that was built with Maven.

Input properties for the Download version (Maven build) step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using an API key, username and password is ignored. No apiKey
Artifactory Base URL String The base URL of the Artifactory server. For example:https://server.example.com:8081/artifactory Yes artifactoryUrl
Excludes String The patterns to use for excluding files to download. No excludes
Includes String The patterns to use for including files to download. The wildcard ** indicates every directory and the wildcard * indicates every file. The pattern dist/**/* retrieves the entire file tree underneath the dist directory. Yes includes
Repository Password Password The password to authenticate with Artifactory. No password
Repository User name String The user name to authenticate with Artifactory. No username
Repository name String The name of the repository. No repositoryName
Verify Hash Boolean Select to verify hash values after the files are downloaded. No checkHash
Versions String A list of versions to download, separated by newline characters. Use the following format: groupId/artifactId/version Yes artifacts

Download version (non-Maven build)

Download all files under specified version of a repository (non-Maven).

Input properties for the Download version (non-Maven build) step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using api key, username and password will be ignored. No apiKey
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory Yes artifactoryUrl
Download Recursively Boolean Select this box to download files and folders in subfolders of versions. Requires Artifactory Pro edition or higher. No recursive
Excludes String The patterns to use for excluding files to download. No excludes
Includes String The patterns to use for including files to download. The wildcard ** indicates every directory and the wildcard * indicates every file. So the pattern dist/**/* would retrieve the entire file tree underneath the dist directory. Yes includes
Repository Password Password The password to authenticate with Artifactory. No password
Repository User name String The user name to authenticate with Artifactory. No username
Repository name String The name of the repository. Yes repositoryName
Verify Hash Boolean Select to verify hash values after the files are downloaded. No checkHash
Versions String A list of folders and subfolders to download, separated by newline characters. Use the following format: path/to/artifact/version Yes artifacts

Promote Build

Change the status of a build, optionally moving or copying the build to a target repository.

Input properties for the Promote Build step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using api key, no username and password can be specified. No apiKey
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory Yes url
Build Name String The name of the build to promote. Yes buildName
Build Number String The number of the build to promote. Yes buildNumber
CI User String User that invoked promotion from the CI server. No buildUser
Comment String Comment to describe the reason for promotion. No buildComment
Copy Boolean Select to copy instead of move when a target repository is specified. No buildCopy
Include Artifacts Boolean Select to move or copy the build artifacts. No buildArtifact
Include Dependencies Boolean Select to move or copy the build dependencies. No buildDepend
Password Password The password to authenticate with the Artifactory server. No password
Properties String A newline separated list of name=value properties to set on the promotion. For example: tester=John Smith. Specify multiple values per name with commas (escape commas with backslash \ to avoid this). For example: osVersions=Windows,Linux No buildProps
Source Repository String The source repository that contains the build artifacts to copy or move. Yes buildSource
Status String New build status. Yes buildStatus
Target Repository String The target repository for the build artifacts and dependencies. Yes buildTarget
User Name String The user name to authenticate with the Artifactory server. No username

Retrieve Build Artifacts Archive

Retrieve an archive file that contains all the artifacts for a specific build.

Input properties for the Retrieve Build Artifacts Archive step
Name Type Description Required Property
Api Key Password The API key to authenticate with the Artifactory server. If you enter an API key, you cannot specify a user name and password. No apiKey
Archive Type Enumeration Select the merge type of the archive file to return. Valid types are: zip, tar, tar.gz., and tgz. No buildType
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory Yes url
Build Name String The name of the build to download. Yes buildName
Build Number String Specify the build to download by number. Cannot be used with Build Status. No buildNumber
Password Password The password to authenticate with the Artifactory server. No password
Repositories String Specify the repository to search for the build in. Separate multiple repositories with commas. No buildRepos
Status String Specify the build to download by status. Cannot be used with Build Number. No buildStatus
User Name String The user name to authenticate with the Artifactory server. No username

Set Item Properties

Attach properties to a file or folder.

Input properties for the Set Item Properties step
Name Type Description Required Property
Api Key Password The api key to authenticate with the Artifactory server. If using api key, username and password is ignored. No apiKey
Artifact Path String The path to the artifact to set properties on. For example: libs-release-local/org/jfrog/multi1/2.7-SNAPSHOT Yes path
Artifactory Base URL String The base URL of the Artifactory server. For example: https://server.example.com:8081/artifactory Yes url
Password Password The password to authenticate with the Artifactory server. No password
Properties String Specify a list of properties to set. Place each entry on a separate line. Use the following format: key=value. Separate multiple values for a key with commas, and add a backslash (\) before the following special characters: comma (,), backslash(\), vertical bar (|), and equal sign (=). Do not use a backslash before the equal sign between the key and the value or before commas used to separate multiple values. For example: osVersions=Windows\=7\,10,Linux\=16.04 LTS\ Yes properties
Recursive Boolean Select to attach properties recursively if the Artifact Path is a directory. No recursive
User Name String The user name to authenticate with the Artifactory server. No username