|
|
# Getting an account
|
|
|
To get an account log in with you KIS credentials on the [start page]("https://gitlab.leibniz-kis.de"). This will create an account but it will still be necessary for an admin to unblock it so you can get going. Simply contact Scientific IT or @schaffer.
|
|
|
|
|
|
# Setting up ssh keys
|
|
|
To make pushing and pulling simple, it makes sense to register your public key with the server. This key is used as a default authentication method for all ssh connections and can be used to automate authentication with the gitlab server. You can also stick to http for all communication with the server but this will mean you need to enter your credentials everytime you interact with the server.
|
|
|
|
|
|
### Generating ssh key pairs
|
|
|
Below is a rough outline how to register your key with the server. An in-depth manual is provided by [GitLab](https://docs.gitlab.com/ce/ssh/README.html#adding-an-ssh-key-to-your-gitlab-account)
|
|
|
|
|
|
Generating a key pair:
|
|
|
```
|
|
|
ssh-keygen -t ed25519
|
|
|
```
|
|
|
this will yield the response
|
|
|
```
|
|
|
Generating public/private ed25519 key pair.
|
|
|
Enter file in which to save the key (/home/user/.ssh/id_ed25519):
|
|
|
```
|
|
|
after this you'll get a chance to set a passphrase for the key
|
|
|
```
|
|
|
Enter passphrase (empty for no passphrase):
|
|
|
Enter same passphrase again:
|
|
|
```
|
|
|
|
|
|
Now you can copy the SSH key you created to your GitLab account. To do so, follow these steps:
|
|
|
|
|
|
Copy your public SSH key to a location that saves information in text format. The following options saves information for ED25519 keys to the clipboard for the noted operating system:
|
|
|
|
|
|
```
|
|
|
macOS:
|
|
|
pbcopy < ~/.ssh/id_ed25519.pub
|
|
|
|
|
|
Linux (requires the xclip package):
|
|
|
xclip -sel clip < ~/.ssh/id_ed25519.pub
|
|
|
|
|
|
Git Bash on Windows:
|
|
|
cat ~/.ssh/id_ed25519.pub | clip
|
|
|
```
|
|
|
You can also omit the `pbcopy`, `xclip` and `clip` parts and simply copy paste from the command line.
|
|
|
|
|
|
Navigate to http://gitlab.leibniz-kis.de and sign in.
|
|
|
Select your avatar in the upper right corner, and click Settings
|
|
|
Click SSH Keys.
|
|
|
Paste the public key that you copied into the Key text box.
|
|
|
Make sure your key includes a descriptive name in the Title text box, such as Work Laptop or Home Workstation.
|
|
|
Include an (optional) expiry date for the key under “Expires at” section.
|
|
|
|
|
|
Click the Add key button.
|
|
|
|
|
|
To ensure everything worked go to a project on the server and try cloning it via git. If this works you're all set up to interact with GitLab. |