search

jfrog / jenkins-artifactory-plugin

Jenkins artifactory plugin
http://jenkins-ci.org/
116 stars 190 forks source link

readme

# 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)

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. The release notes for versions 3.18.1 and above are available here.

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:

> 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 how to generate a Platform Admin Token.

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

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.