# artifactory-plugin

**Repository Path**: mamh-java/artifactory-plugin

## Basic Information

- **Project Name**: artifactory-plugin
- **Description**: https://github.com/mamh-java/artifactory-plugin
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-05-14
- **Last Updated**: 2025-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

[![](readme_image.png)](#readme)

<div align="center">

# Jenkins Artifactory Plugin

![JFrog Plugin Installs](https://img.shields.io/jenkins/plugin/i/artifactory?label=Plugin%20installs%20plugin&logo=Jenkins&logoColor=white&color=blue&style=for-the-badge)

[![Scanned by Frogbot](https://raw.github.com/jfrog/frogbot/master/images/frogbot-badge.svg)](https://github.com/jfrog/frogbot#readme)
[![Tests](https://github.com/jfrog/jenkins-artifactory-plugin/actions/workflows/tests.yml/badge.svg?branch=master)](https://github.com/jfrog/jenkins-artifactory-plugin/actions/workflows/tests.yml) [![Static Analysis](https://github.com/jfrog/jenkins-artifactory-plugin/actions/workflows/analysis.yml/badge.svg?branch=master)](https://github.com/jfrog/jenkins-artifactory-plugin/actions/workflows/analysis.yml)
[![](https://img.shields.io/badge/Docs-%F0%9F%93%96-blue)](https://jfrog.com/help/r/jfrog-integrations-documentation/jenkins-artifactory-plug-in)

</div>

## General

The plugin integrates Jenkins and Artifactory to publish, resolve, promote and release traceable build artifacts. For
more information, including the release notes, please visit
the [JFrog Artifactory Plugin documentation](https://jfrog.com/help/r/jfrog-integrations-documentation/jenkins-artifactory-plug-in).
The release notes for versions 3.18.1 and above are available [here](https://github.com/jfrog/jenkins-artifactory-plugin/releases).

## How to Contribute

JFrog welcomes community contribution through pull requests.

### Important:

The plugin code is stored in two GitHub repositories:
https://github.com/jfrog/jenkins-artifactory-plugin and
https://github.com/jenkinsci/artifactory-plugin

Please make sure to submit pull requests to *https://github.com/jfrog/jenkins-artifactory-plugin* only.

## How to build the plugin code
To build the plugin, please use Maven 3.6.1 or above, with JDK 8, and run:
```console
> mvn clean install
```

## Tests
### Unit tests
To run unit tests execute the following command:
```
> mvn clean test
```

### Integration tests
#### Running integration tests
Before running the integration tests, set the following environment variables.
See [here](https://www.jfrog.com/confluence/display/JFROG/Access+Tokens#AccessTokens-GeneratingAdminTokens) how to generate a Platform Admin Token.

*JENKINS_PLATFORM_URL*<br>
*JENKINS_PLATFORM_USERNAME*<br>
*JENKINS_PLATFORM_ADMIN_TOKEN*<br>
*JENKINS_ARTIFACTORY_DOCKER_PUSH_DOMAIN* (For example, server-docker-local.jfrog.io)<br>
*JENKINS_ARTIFACTORY_DOCKER_PULL_DOMAIN* (For example, server-docker-remote.jfrog.io)<br>
*JENKINS_ARTIFACTORY_DOCKER_PUSH_REPO* (For example, docker-local)<br>
*JENKINS_ARTIFACTORY_DOCKER_PULL_REPO* (For example, docker-remote)<br>
*JENKINS_ARTIFACTORY_DOCKER_HOST* - Optional address of the docker daemon (For example, tcp://127.0.0.1:1234)<br>
*JENKINS_PIP_ENV_INIT* - Optional command to activate pip virtual-environment for tests execution (For example, source /Users/user/jenkins-venv/bin/activate)<br>
*MAVEN_HOME* - The local maven installation path.<br>
*GRADLE_HOME* - The local gradle installation path.<br>

To disable build scan with Xray integration tests, set *JENKINS_XRAY_TEST_ENABLE* to *false*.
Go tests require Go v1.14 or above.

Run the integration tests.
```
> mvn clean verify -DskipITs=false
```
#### Integration tests results and progress
The tests results are printed to the console (standard output) when the tests finish.
Since JUnit however does not indicate which tests are currently running, a file named *tests.log* is created in the current directory, which logs the tests progress.