From 0474c6baff44ad74ea5d437171b2fdb05874547a Mon Sep 17 00:00:00 2001 From: Jay Gabriels Date: Sat, 6 Aug 2022 22:38:01 -0700 Subject: [PATCH] Update gitlab.md --- examples/gitlab.md | 49 +++++++++++++++++++++++++++------------------- 1 file changed, 29 insertions(+), 20 deletions(-) diff --git a/examples/gitlab.md b/examples/gitlab.md index cd5aafa..6545059 100644 --- a/examples/gitlab.md +++ b/examples/gitlab.md @@ -5,43 +5,52 @@ ## Hosted GitLab Instances +### Cloning All Groups + **Note: "all-groups" only works on hosted GitLab instances running 13.0.1 or greater** -1. Clone all groups on a **hosted gitlab** instance **preserving** the directory structure of subgroups +1. Clone all groups **preserving the directory structure** of subgroups ``` ghorg clone all-groups --base-url=https:// --scm=gitlab --token=XXXXXX --preserve-dir ``` +1. Clone all groups on an **insecure** instance **preserving the directory structure** of subgroups + + ``` + ghorg clone all-groups --base-url=http:// --scm=gitlab --token=XXXXXX --preserve-dir --insecure-gitlab-client +### Cloning Specific Groups + +1. Clone a single **group**, **preserving the directory structure** of subgroups within that group + + ``` + ghorg clone --base-url=https:// --scm=gitlab --preserve-dir + ``` + +1. Clone only a **subgroup** + + ``` + ghorg clone / --base-url=https:// --scm=gitlab + ``` + +1. clone all repos that are **prefixed** with "frontend" **into a folder** called "design_only" + + ``` + ghorg clone --base-url=https:// --scm=gitlab --match-regex=^frontend --output-dir=design_only + ``` +### Cloning User Repos + 1. Clone a **user** on a **hosted gitlab** instance using a **token** for auth ``` ghorg clone --clone-type=user --base-url=https:// --scm=gitlab --token=bGVhdmUgYSBjb21tZW50IG9uIGlzc3VlIDY2 ``` -1. Clone a **group** on a **hosted gitlab** instance **preserving** the directory structure of subgroups - - ``` - ghorg clone --base-url=https:// --scm=gitlab --preserve-dir - ``` - -1. Clone only a **subgroup** on a **hosted gitlab** - - ``` - ghorg clone / --base-url=https:// --scm=gitlab - ``` - -1. clone all repos that are **prefixed** with "frontend" **into a folder** called "design_only" from a **group** on a **hosted gitlab** instance - - ``` - ghorg clone --base-url=https:// --scm=gitlab --match-regex=^frontend --output-dir=design_only - ``` - ## Cloud GitLab Orgs eg. https://gitlab.com/gitlab-examples -1. clone all groups **preserving** the directory structure of subgroups +1. clone **all groups**, **preserving the directory structure** of subgroups ``` ghorg clone gitlab-examples --scm=gitlab --token=XXXXXX --preserve-dir