The Artifactory source configuration plugin includes steps to complete the following tasks:
The Artifactory source configuration plugin imports Generic, Ivy, or Gradle packages from an Artifactory repository as a component version.
This plugin includes one or more steps, click Steps for step details and properties.
This plugin requires JFrog Artifactory 2.0 or later.
This plugin requires HCL Launch version 6.0.1 or later.
This plugin runs on all operating systems that are supported by the HCL Launch agent.
See Installing plugins in HCL Launch for installing and removing plugins.
The following table describes the changes made in each plugin version.
| Version | Description |
|---|---|
| 29 | RFE 131466. Add support for SHA-256 hash verification instead of SHA-1 and updated logging for verification. |
Use the Artifactory Source Configuration plugin to import artifacts from an Artifactory repository as the component version. To use this plugin, create a component to define the artifacts to be used. The component contains the information for importing the artifacts and any processes to perform on the artifacts.
To create a component, complete the following steps. For more information, see .
https://plugins.hcltechsw.com/wp-content/uploads/2021/04/launch_component_configscr.jpg 548w" sizes="(max-width: 300px) 100vw, 300px" />
When the artifacts are imported, a component version is created using the version of the package. You can specify to import a specific package version or import all versions. If importing all versions, a component version is created for each version.
To access this plugin in the palette, click Source and Repositories > Artifactory.
The following roles are added automatically to resources. You cannot add these roles manually.
>
| Name | Type | Description | Reference |
|---|---|---|---|
| Add Property as Link | String | A list of Artifactory properties to be set as component version links on the imported version. If the property does not exist in Artifactory, it is skipped. Separate multiple properties with a comma (,). | ${p:component/ArtifactoryComponentProperties/links} |
| Add Property as Status | String | A list of Artifactory properties to be set as component version statuses on the imported version. If the property does not exist in Artifactory or the status does not exist in Deploy, it is skipped. Separate multiple properties with a comma (,). | ${p:component/ArtifactoryComponentProperties/statuses} |
| Allow Insecure Connection | Boolean | Select this option to allow insecure connections to the Artifactory repository. | ${p:component/ArtifactoryComponentProperties/allowInsecure} |
| Api Key | Password | The API key to authenticate with the Artifactory server. When using an API key, user name and password are ignored. | ${p:component/ArtifactoryComponentProperties/apiKey} |
| Artifact ID | String | The ID of the artifact. | ${p:component/ArtifactoryComponentProperties/artifactId} |
| Artifactory URL | String | The base URL for the Artifactory server. | ${p:component/ArtifactoryComponentProperties/repoUrl} |
| Download Recursively | Boolean | Select this box to download files and folders in sub-folders of versions. This feature requires Artifactory Pro edition or later. | ${p:component/ArtifactoryComponentProperties/recursive} |
| Exclude Files | String | A list of files to exclude in the version upload. Separate each file with a comma or newline characters. | ${p:component/ArtifactoryComponentProperties/excludes} |
| Extensions of Files to Convert | String | A list of extensions that specify files to convert into a new character set when downloaded. Separate each list item with a comma. | ${p:component/ArtifactoryComponentProperties/extensions} |
| File Extension | String | The extension field for files to retrieve from Artifactory when using the Download Latest Step for SNAPSHOT step. For version imports, use Includes and Excludes fields. | ${p:component/ArtifactoryComponentProperties/extension} |
| Group ID | String | The ID of the artifact group. | ${p:component/ArtifactoryComponentProperties/groupId} |
| HTTP Proxy Host | String | The hostname of the HTTP proxy to use to connect to the Artifactory server. For exampe: proxy.domain.com. | ${p:component/ArtifactoryComponentProperties/proxyHost} |
| HTTP Proxy Password | Password | The password to authenticate with HTTP proxy. | ${p:component/ArtifactoryComponentProperties/proxyPass} |
| HTTP Proxy Port | String | The port number of the HTTP proxy to use to connect to the Artifactory server. | ${p:component/ArtifactoryComponentProperties/proxyPort} |
| HTTP Proxy User name | String | The user name to authenticate with the HTTP proxy. | ${p:component/ArtifactoryComponentProperties/proxyUser} |
| Include Files | String | A list of files to include in the version upload. The default is **/* to uploads all files. Separate files with commas or newline characters. To specify an extension (ex. zip), use *.zip. | ${p:component/ArtifactoryComponentProperties/includes} |
| Latest Version Count | String | The number of most recent versions of the component in Artifactory to import. | ${p:component/ArtifactoryComponentProperties/copyCount} |
| Password | Password | The password to authenicate with the server. | ${p:component/ArtifactoryComponentProperties/password} |
| Preserve Execute Permissions | Boolean | Select to save file execute permissions with files. | ${p:component/ArtifactoryComponentProperties/saveFileExecuteBits} |
| Repo Path | String | The Path for the versions to be imported. The value in this property overrides Group ID and Artifact ID properties. For Maven repositories, use the format: groupId/artifactId. For generic paths use the format: path/to/versions. | ${p:component/ArtifactoryComponentProperties/repoPath} |
| Repository | String | The name of the repository to fetch versions from. | ${p:component/ArtifactoryComponentProperties/repoName} |
| Unzip Archived Files | Boolean | Select this box to unzip archived files before upload as component version files. | ${p:component/ArtifactoryComponentProperties/unzipArchive} |
| User | String | ${p:component/ArtifactoryComponentProperties/user} | |
| Verify Hash | Boolean | Select to verify hash values after the files are downloaded. | ${p:component/ArtifactoryComponentProperties/checkHash} |
| Version Name Pattern | String | A regular expression used to determine the version to be imported. Only the versions with names matching the regular expression are imported. For each group matching the first capturing group, the requested number of latest builds are loaded into HCL Launch. Use this property only when tracking older branches that contain new builds. For example: to return n versions of each 1.0.*, 1.1.*, 1.2.*, and so on, use the following regular expression: (1.[0-9]+).*. | ${p:component/ArtifactoryComponentProperties/versionPattern} |
| Name | Type | Description |
|---|---|---|
| Specific version | String | A regular expression used to determine the verison to be imported. Only the versions with names matching this regular expression are imported. For each group matching the first capturing group, the desired number of latest builds are loaded into HCL Launch. If Version Name Pattern is set in the plugin configuration, versions specified by the version name pattern are filtered out before this regular expression is used as a filter. For example: to return n versions of each 1.0.*, 1.1.*, 1.2.*, and so on, use the following regular expression: (1.[0-9]+).*. |
| Version Description | String | An optional description to add to the versions that are imported into HCL Launch. |
Uploaded: 26-Apr-2024 18:01
Uploaded: 29-Jun-2023 04:40
Uploaded: 20-Jun-2023 07:41
Uploaded: 30-Jan-2023 09:06
Updated log4j dependency.
Uploaded: 15-Mar-2021 13:28
RFE 131466 - Add support for SHA-256 hash verification instead of SHA-1 and updated logging for verification.
Summary
Usage
Steps
Settings and Roles
