89 lines
2.4 KiB
Markdown
89 lines
2.4 KiB
Markdown
# GoGitlabber
|
|
|
|
This project is inspired from the python application called gitlabber (https://github.com/ezbz/gitlabber).
|
|
It is mainly to learn Golang. But also to make something that specifically
|
|
solves my problem. 😆
|
|
|
|
It is definitely not as feature-rich as the original project... 😬
|
|
|
|
The program can clone and pull all repositories you have access to on a selfhosted or SaaS provided Gitlab or Gitea server.
|
|
It only supports the HTTP access method.
|
|
|
|
It will pull the repositories in a tree like structure same as on Gitlab or
|
|
Gitea.
|
|
```
|
|
root [http://gitlab.example.com]
|
|
├── group1 [/group1]
|
|
│ └── subgroup1 [/group1/subgroup1]
|
|
│ └── project1 [/group1/subgroup1/project1]
|
|
└── group2 [/group2]
|
|
├── subgroup1 [/group2/subgroup1]
|
|
│ └── project2 [/group2/subgroup1/project2]
|
|
├── subgroup2 [/group2/subgroup2]
|
|
└── subgroup3 [/group2/subgroup3]
|
|
```
|
|
|
|
# Example
|
|
Gitea:
|
|
```
|
|
gogitlabber -backend=gitea -destination=$HOME/Documents -git-url=gitea.example.com
|
|
-git-api-token=supersecrettoken
|
|
```
|
|
Gitlab:
|
|
```
|
|
gogitlabber -backend=gitlab -destination=$HOME/Documents -git-url=gitlab.example.com
|
|
-git-api-token=supersecrettoken
|
|
```
|
|
|
|
# Usage
|
|
```
|
|
Usage of gogitlabber:
|
|
-archived string
|
|
To include archived repositories (any|excluded|exclusive)
|
|
example: -archived=any
|
|
env = GOGITLABBER_ARCHIVED
|
|
(default "excluded")
|
|
|
|
-backend string
|
|
Specify git backend
|
|
example: -backend=gitlab
|
|
env = GOGITLABBER_BACKEND
|
|
|
|
-concurrency int
|
|
Specify repository concurrency
|
|
example: -concurrency=15
|
|
env = GOGITLABBER_CONCURRENCY
|
|
(default 15)
|
|
|
|
-debug
|
|
Toggle debug mode
|
|
example: -debug=true
|
|
env = GOGITLABBER_DEBUG
|
|
(default false)
|
|
|
|
-destination string
|
|
Specify where to check the repositories out
|
|
example: -destination=$HOME/repos
|
|
env = GOGITLABBER_DESTINATION
|
|
(default "$HOME/Documents")
|
|
|
|
-git-api-token string
|
|
Specify API token
|
|
example: -git-api=glpat-xxxx
|
|
env = GIT_API_TOKEN
|
|
(default "")
|
|
|
|
-git-url string
|
|
Specify Git host
|
|
example: -git-url=gitlab.example.com
|
|
env = GIT_URL
|
|
(default "gitlab.com")
|
|
```
|
|
|
|
# Gitea
|
|
Make sure the Gitea Access Token has at least the following permissions:
|
|
- user - read
|
|
- repository - read
|
|
|
|
# Gitlab
|
|
Make sure the Gitlab Access Token has the `api` scope.
|