Open JFrog Packages from GitHub

Open JFrog Artifactory packages from GitHub Linked artifacts and return to the publishing workflow.

Open a package stored in JFrog Artifactory from GitHub, then return from the JFrog package view to the GitHub workflow that published it.

📘

Note

Artifact View is available with Enterprise X and Enterprise+ subscriptions. For other GitHub integration features, see JFrog and GitHub Feature Availability.

Before You Begin

  • An Enterprise X or Enterprise+ subscription.
  • The JFrog GitHub App is installed for the GitHub organization.
  • GitHub Linked Artifacts Integration is turned on. In the JFrog GitHub integration, open Global Settings, turn on the toggle, enter the GitHub Organization, and click Save.
  • The workflow uses jfrog/setup-jfrog-cli@v5. The JFrog CLI running in GitHub Actions adds the vcs.provider, vcs.org, and vcs.repo properties to the uploaded package. JFrog links only packages whose vcs.provider is github and whose vcs.org names the connected organization.
  • A workflow that authenticates to JFrog and publishes the package.

Publish Package from GitHub Actions

Publish the package from a GitHub Actions workflow so that the JFrog CLI adds the GitHub properties that Artifact View uses to link the package.

To publish the package from GitHub Actions:

  1. In the workflow, add the jfrog/setup-jfrog-cli@v5 step:

    - uses: jfrog/setup-jfrog-cli@v5
      env:
        JF_URL: ${{ vars.JF_URL }}
        JF_PROJECT: ${{ vars.JF_PROJECT }}
      with:
        oidc-provider-name: <OIDC_PROVIDER_NAME>

    Where:

    • <OIDC_PROVIDER_NAME>: The OIDC provider name configured in JFrog
  2. Run the package-specific jf upload command.

  3. To include the build in the JFrog package view, publish build info with jf rt build-publish.

Attestation is optional. For more information, see GitHub Attestation to JFrog Evidence.

Verify Artifact View Links

After the workflow publishes the package, confirm that GitHub links to the package in JFrog and that JFrog links back to the workflow.

To verify the Artifact View links:

  1. In GitHub, go to the organization's Packages > Linked artifacts.

  2. Confirm the package shows the JFrog storage registry and artifact repository.

    JFrog package details in GitHub

  3. Click the artifact repository link to open the package in JFrog.

    Artifact repository link on the GitHub linked artifact

  4. On the JFrog package version, open the Builds tab.

  5. Click the CI Server link to return to the GitHub workflow.

Troubleshoot Artifact View

The following table lists common Artifact View issues and what to check.

SymptomWhat to Check
The package is in Artifactory but not linked from GitHub.Confirm the GitHub App is installed for the organization, GitHub Linked Artifacts Integration is on, and the package has vcs.provider set to github and vcs.org set to that organization. GitHub rejects artifact URLs longer than 152 characters.
The CI link is missing in JFrog.Confirm the workflow published build info for the same package and project.

Related Topics


Did this page help you?