使用Artifactory 6。x ?
JFrog Artifactory 6.x User Guide
有问题吗?要报告一个问题吗?Contact JFrog support
Skip to end of metadata
Go to start of metadata
Generic
Overview
Artifactory supports build integration whether you are running builds on one of the common CI servers in use today, on cloud-based CI servers or standalone without a CI server.
Integration of Artifactory into your build ecosystem provides important information that supports fully reproducible builds through visibility of artifacts deployed, dependencies and information on the build environment.
The Artifactory Build Integration Add-on provides a set of plugins you can use with industry standard CI systems and build tools that enable you to:
- See all the builds that are published and their build results in Artifactory.
- Explore the modules of each build, including published artifacts and corresponding dependencies.
- Obtain information about the build environment.
- Check if a specific artifact is required for or is a result of a build, and providing alerts if such an artifact should be targeted for removal.
- Treat all the artifacts and/or dependencies from a specific build as a single unit and perform bulk operations such as move, copy, export etc.
- Receive bidirectional links between build and artifact information inside the build server and Artifactory pages.
Running Builds on a CI Server
Artifactory can easily be added to a continuous integration build ecosystem by treating the CI server as a regular build client, so that it resolves dependencies from Artifactory, and deploys artifacts into a dedicated repository within Artifactory.
Supported Plugins
CI servers that are currently supported, each through a specific plugin are:
The build tools supported on all of these CI servers are:Maven 3 and 2,Gradle,Ivy/Ant,.Net, MSBuildas well asGenericbuild tools. For details please refer to the documentation for each CI server plugin.
Bintray Plugins
In addition to the plugins supported by Artifactory, there is also theGradle Bintray Pluginwhich provides integration between Gradle builds directly with JFrog Bintray.
Running Standalone Builds or on a Cloud-based CI Server
In the last few years, the popularity of cloud-based CI servers has grown. Some examples are,CircleCI,Travis CI,drone.ioandCodeship. The problem is that none of these are "pluggable" in the traditional way. Therefore, to support builds running on cloud-based build servers, as well as standalone builds, Artifactory provides plugins for industry standard build tools such as Maven, Gradle, Ivy/Ant and MSBuild. These plugins provide all the benefits of Artifactory that facilitate fully reproducible builds without the need for a CI server. For more details please refer toMaven Repository,Working with Gradle,Working with IvyandMSBuild Artifactory Plugin.
Build Integration for Artifactory open source version vs. Artifactory Pro
When using the OSS version of Artifactory, Build Integration includes the GenericBuildInfoView and the ability to traverse and view build information using Artifactory's REST APIs.
Artifactory Power Packextends these capabilities and provides Module Artifacts and Dependencies View, Repository View of Builds and the ability to export and manipulate build items.
Inspecting Builds
Builds and Build History
All CI server projects that deploy their output to Artifactory can be viewed in theBuild Browserwhich is accessed in theArtifactsmodule underBuilds.
Selecting a project displays all runs of that build reflecting the build history in the CI server.
Selecting a build item from the list displays completebuild-level information.You can also view the build in the CI server by selecting the corresponding link under theCI Servercolumn.
Permissions
To view build information you must have the 'deploy' permission on some repository path.
Build-level Information
You can select theBuild Numberto drill down into a specific build. This displays detailed information about the build, and enables you to compare it with another build as described in the following sections.
There are three categories of information:
- General build informationabout the build and its environment.
- Build modulesalong with theirartifacts and dependencies.
- Generic view of the build information in JSON format.
General Build Information
This tab displays general information about the build:
Name |
The name assigned to the component being built |
数量 |
The specific run of the build |
Type |
The build tool used |
Agent |
The CI server managing the build |
Build Agent |
The specific version of build tool used |
Started |
The time stamp when the build was started |
Duration |
The duration of the build |
Principal |
The factor that triggered this build. This may be a CI server user, or another build |
Artifactory Principal |
The Artifactory user that triggered this build |
URL |
Link to the build information directly on the build server |
Published Modules
This tab displays the modules published into Artifactory as a result of the build, along with the number of artifacts and dependencies that they contain.
Module Artifacts and Dependencies
Selecting a published module that was built will display its artifacts and dependencies. You can group these by type or scope by clicking the corresponding column header.
You can click any item to download it directly, or click itsRepo Pathtoview it in theTree Browser.
Environment
The Environment tab displays an extensive list of properties and environment settings defined for the selected build. You can use these to reproduce the environment precisely if you need to rerun the build.
Issues
TheIssuesprovides integration between Artifactory, Jenkins CI server and JIRA issue tracker. When using Jenkins CI, if you to set theEnable JIRA Integrationoption in the Jenkins Artifactory Plugin, theIssuestab will display any JIRA issues that have been addressed by this build.
Licenses
TheLicensestab displays the results of a detailed license analysis of all artifacts and their dependencies.
TheSummaryline displays the number of artifacts found with the following statuses:
Unapproved |
The license found has not been approved for use Approving licenses You can approve a license for use in theAdmintab underConfiguration | Licenses.For details please refer toLicense Control. |
Not Found |
No license requirements were found for the artifact. |
Unknown |
The artifact requires a license that is unknown to Artifactory |
Neutral |
A license requirement that is not approved has been found for the artifact, however there is another license that is approved. |
Approved |
All license requirements for the artifact are approved in Artifactory. |
Build Diff
TheDifftab allows you to compare the selected build with any other build. Once you select a build number in theSelect A Build To Compare Againstfield, Artifactory displays all the differences between the builds that were detected including new artifacts added, dependencies deleted, properties changed and more.
Release History
The Release History tab displays a list of the selected build's release landmarks.
Build Info JSON
GenericBuildInfoView
This tab displays the rawBuildInfoJSON representation of the build information in Artifactory. This data can be accessed via the REST API or used for debugging and is also availablein the Artifactory OSS version.
Exporting and Manipulating Build Items
You can view a build in the repository browser and perform actions on it as a whole with all its artifacts and dependencies. For example, you could promote it to another repository, copy it, or export it to a disk.
Repository View of Builds
When viewing an artifact within theTree Browser, you can see all of the builds with which that artifact is associated, whether directly or as a dependency in theBuildstab
Moreover, if you try to remove the artifact you will receive a warning that the build will no longer be reproducible.
The association of an artifact with a build is retained even if you move or copy it within Artifactory, because the association linked to the artifact's checksum which remains constant, regardless of the its location.
Behind the Scenes
Behind the scenes, the Artifactory plug-in for your CI server performs two major tasks:
- It resolves all dependencies from a resolution repository in Artifactory.
- It deploys all the artifacts to Artifactory as an atomic operation at the end of the build, guaranteeing a more coherent deployment when building multi-module projects
(Maven and Ivy deploy each module at the end of its build cycle. If one of the modules fails, this can result in partial deployments). - It sends a
BuildInfo数据对象通过REST API在Artifactoryend of deployment. This is a structured JSON object containing all the data about the build environment, artifacts and dependencies, in a standard and open format.
Release Management
Artifactory supports release management through its plugins forJenkins,TeamCityandBamboo.
When you run your builds usingMavenorGradlewith jobs that useSubversion, Git orPerforceas your version control system, you can manually stage a release build allowing you to:
Change values for the release and next development version
Choose a target staging repository to which to deploy the release
Create a VCS tag for the release
Staged release builds can later be提升orrolled-back, changing their release status in Artifactory, with the option to move the build artifacts to a different target repository.
Inside Artifactory, the history of all build status change activities (staged, promoted, rolled-back, etc.) is recorded and displayedfor full traceability.
To learn more about release management specific to your CI server, please refer to:
Release Management in the Jenkins Documentation
TeamCity Artifactory Plugin - Release Management
Bamboo Artifactory Plug-in - Release Management
Overview
Content Tools