Resolving GitLab Subgroups

JFrog Artifactory Documentation

Products
JFrog Artifactory
Content Type
User Guide
ft:sourceType
Paligo

GitLab has a feature called subgroups (explained here). When selecting GitLab as the Git provider for a Go remote repository, a checkbox appears called Resolve Subgroups (for configuration instructions, click here). When selected, Artifactory will check the subgroup path explicitly to resolve Go modules. If not selected, Artifactory will resolve Go modules by treating the /name/ as a submodule. By default, this checkbox is not selected.

The option to resolve subgroups was added to the Go remote repository configuration because GitLab implemented a change in the API path that is not part of the .git protocol and Artifactory is not able to identify if the path is in fact a subgroup or a submodule.

Best Practices

Go remote repositories only work via a virtual repository. Therefore, a dedicated remote repository should be defined to the specific Subgroup URL. You can decide on the remote resolution order, either go to a regular repository first and then a subgroup, or the other way around by ordering the list of remote repositories in the virtual repository.

Limitation

The Resolve Subgroups feature does not support resolving Go submodules.