Using the latest version?
JFrog Container Registry Guide
The Tree Browser lets you drill down through the repository hierarchy and displays full information for each level within it. For any repository, folder or artifact selected in the tree, a tabbed panel displays detailed data views and a variety of actions that can be performed on the selected item. The information tabs available are context sensitive and depend on the item selected. For example, if you select a Docker package, a Docker Info tab displays information specific to Docker packages.
Click on the "Tree" link at the top of the tree browser to collapse all open nodes in the tree.
Sorting the Tree Browser
The default order in which repositories appear in the Tree Browser is: Distribution, Local, Remote, Virtual.
You can modify this order through the
artifactory.treebrowser.sortRepositories.sortByType system property.
For example, to reverse the order, you would set:
If you omit any repository type in the specified sort order, it will be ordered according to the default setting.
The simple browser lets you browse repositories using simple path-driven URLs, which are the same URLs used by build tools such as Docker. It provides lightweight, view-only browsing.
A unique feature of this browsing mode is that you can also view remote repositories (when enabled for the repository), and virtual repositories to see the true location of each folder and artifact
You can apply a filter to both the Tree Browser and the Simple Browser, either by clicking the search icon, or just typing out the filter expression while on the browser.
- By repository name: To filter by repository name, just type the name you want to filter by
- By package type: To only display repositories for a particular package type, type pkg:<package type>. For example, typing
pkg:dockerwill filter out any repositories that are not Docker repositories
- By repository type: To only display particular repository types, type repo:<repository type>. For example, typing
repo:localwill filter out any repositories that are not local repositories. The options are local, cached, remote and virtual.
Selecting any item in the Tree or Simple browser displays tabs which provide information regarding the metadata associated with the selected item:
Info: General Information including download statistics such as the total number of downloads, time stamp of last download and the last user who downloaded.
Virtual Repository Associations: Indicates which virtual repositories "contain" the selected artifact.
Checksums displays SHA1, SHA-256 and MD5 checksums automatically.
The permissions (Delete/Overwrite, Deploy/Cache, Annotate, Read) that each user or group regarding the selected item. Permissions for groups are as specifically assigned to them. Permissions for individual users are the union of permissions specifically assigned as well as those inherited by virtue of the user being included in groups.
|The list of properties annotating the selected item.|
|The list of users watching this item.|
|The list of builds that either produce or use the selected item.|
|XML and POM files also display a tab through which you can view the file contents.|
List Browsing lets you browse the contents of a repository outside of the JFrog Container Registry UI. It provides a highly responsive, read-only view and is similar to a directory listing provided by HTTP servers.
To use List Browsing, click the icon to the right of a repository name in the Simple Browser (indicated in red in the screenshot above).
Creating public views with List Browsing
List browsing can be used to provide public views of a repository by mounting it on a well-known path prefix such as
list (see example below).
This allows the system administrator to create a virtual host that only exposes JFrog Container Registry's List Browsing feature to public users (while maintaining write and other advanced privileges), but limiting access to the intensive UI and REST API features for internal use only.
For a Smart Remote Repository, JFrog Container Registry lets you navigate the contents of the repository on the remote JFrog Container Registry instance even if the artifacts have not been cached locally.
To enable remote browsing, you need to set the List Remote Folder Items checkbox in the remote repository configuration. Once this is set you can navigate that repository using the Simple or List Browser.
In the Simple Browser, an item that is not cached is indicated by an icon on its right when you hover over the item. In the List Browser, an item that is not cached is indicated by an arrow.
Initial responsiveness of remote repositories
JFrog Container Registry provides a trash can as an easy way to recover items that have been inadvertently deleted from local repositories.
The trash can can be enabled or disabled in the Trash Can Settings by an JFrog Container Registry administrator.
When enabled, the trash can is displayed at the bottom of the Artifact Repository Browser and it holds all artifacts or repository paths that have been deleted from local repositories for the period of time specified in the Retention Period field.
Right-click on an item in the trash can gives you the option to Refresh, Restore it to its original location, or Delete permanently.
Right-click on the trash can icon gives you the option to Refresh the whole trash can, Search Trash for specific items, or Empty Trash which means that all items in the trash can will be permanently deleted.
Click the pin icon to pin the trash can so it remains visible even if you scroll the tree.
JFrog Container Registry fully supports browsing with WebDAV. For full details please refer to Using WebDAV.