generate-gl-repo
Minimal CLI wrapper for node-gitlab package to easy creating new repositories on a GitLab server and clone it locally, all in a single command.
gen my-new-repository
IMPORTANT: You must to have an SSH key properly configured on your local machine and on the GitLab server in order to be able to clone the repository after is has been created.
Options
Usage: gen [options]
Options:
-i, --initialize Initialize the configuration file.
-s, --output-ssh-url Output SSH URL.
-w, --output-html-url Output HTTP URL.
-n, --clone-no Dont clone the repository.
-a, --assign-to-team <team_id> Assign repository to a user group. Need admin permissions.
-h, --help output usage information
Install
npm install generate-gl-repo -g
Note: You must install this package globally to be able to use it anywhere from the CLI.
Configuration
Use this command to initialize the configuration process:
gen -i
The configuration process will ask you:
- Your GitLab server domain name. Ex.: http://gitlab.com
- Your Private Token number.
A JSON configuration file named addrepo.json will be saved on the package install folder at %APPDATA%\npm\node_modules\addrepo
.
How to use
Initialize the configuration file
gen -i
Create a new repository
gen my-new-repository
Note: If there is already a repository with the same name for the current user, the action will fail.
Create a repository, dont clone it, and output the HTTP URL
gen my-new-repository -n -w
Create a repository, and assign it to a user group by ID number
This option require admin permissions in the configured user.
You can run gen -l
to see all the namespace info.
gen my-new-repository -a [namespace_id]
Or cd my-new-repository && gen -a [namespace_id]
Note: If the current user don't have permissions to assign a project to a group, the project will be created for the current user.