jenkinsci / jenkinsci/jfrog-plugin

Update docs to mention the JFrog CLI build-discard command

Open
#54 0 comments 0 reactions 0 assignees View on GitHub
feature request
Dominant language
Java
Stars
16
Forks
85
PR merge metrics
No merged PRs in 30d

Description

### Is your feature request related to a problem? Please describe.

I did not know how to handle discarding Artifactory builds (and their artifacts) once they have been uploaded by Jenkins. I also did not know how to handle Jenkins builds marked with the "Keep Forever" option on the Artifactory side.

I struggled with this until I eventually found the `jf rt build-discard` command. This command "completes the loop" of using the Jenkins JFrog plugin with Artifactory.

For example:

1. `jf rt upload` to upload Artifacts
2. `jf rt build-publish` to publish the build-info object
3. `jf rt build-discard` to manage the lifetime of the builds and their corresponding artifacts in Artifactory

### Describe the solution you'd like to see

I think it would be very useful for new JFrog users like myself who are trying to setup Artifactory with Jenkins for the first time if the Jenkins JFrog CLI docs called out the `jf rt build-discard` command since it is needed to "complete the loop" for Jenkins/Artifactory builds/artifacts integration.

### Describe alternatives you've considered

N/A

### Additional context

N/A

Contributor guide

Open the contributing guide

Research direction

Start by locating the Jenkins JFrog CLI documentation and reviewing how it currently describes uploading artifacts and publishing build information. Add the jf rt build-discard command to the documented Jenkins/Artifactory workflow, including its role in managing build and artifact lifetimes; done means new users can find this step alongside the existing commands.

Written by the indexing model from the issue text.

Assessment

Domain
devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.