Files
ghorg/examples/gitlab.md

49 lines
1.4 KiB
Markdown

## Hosted GitLab Instances
clone all groups on a **hosted gitlab** instance **preserving** the directory structure of subgroups
```
$ ghorg clone all-groups --base-url=https://<your.instance.gitlab.com> --scm=gitlab --token=XXXXXXXXXXXXX --preserve-dir
```
clone a **user** on a **hosted gitlab** instance using a **token** for auth
```
$ ghorg clone <gitlab_username> --clone-type=user --base-url=https://<your.instance.gitlab.com> --scm=gitlab --token=XXXXXXXXXXXXX
```
clone a **group** on a **hosted gitlab** instance **preserving** the directory structure of subgroups
```
$ ghorg clone <gitlab_group> --base-url=https://<your.instance.gitlab.com> --scm=gitlab --preserve-dir
```
clone only a **subgroup** on a **hosted gitlab**
```
$ ghorg clone <gitlab_group>/<gitlab_sub_group> --base-url=https://<your.instance.gitlab.com> --scm=gitlab
```
clone all repos that are **prefixed** with "frontend" **into a folder** called "design_only" from a **group** on a **hosted gitlab** instance
```
$ ghorg clone <gitlab_group> --base-url=https://<your.instance.gitlab.com> --scm=gitlab --match-regex=^frontend --output-dir=design_only
```
## Cloud GitLab Orgs
eg. https://gitlab.com/fdroid
clone all groups **preserving** the directory structure of subgroups
```
$ ghorg clone fdroid --scm=gitlab --token=XXXXXXXXXXXXX --preserve-dir
```
clone only a **subgroup**
```
$ ghorg clone fdroid/metrics-data --scm=gitlab --token=XXXXXXXXXXXXX
```