Phriction Phriction Guide for DKFZ-internal setup of Git and Phabricator (obsolete, see Onboarding guide) History Version 1 vs 13
Version 1 vs 13
Version 1 vs 13
Content Changes
Content Changes
= Install Git =
- {icon linux} [[guide/install-git-linux | Linux (Ubuntu)]]
- {icon windows} [[guide/install-git-windows | Windows]]
= Configure Git =
IMPORTANT: Make sure to use the correct domain in your email address, e.g. `dkfz-heidelberg.de` instead of ~~`dkfz.de`~~.
```$ git config --global user.name "John Doe"
$ git config --global user.email j.doe@dkfz-heidelberg.de
$ git config --global credential.https://phabricator.mitk.org.username jdoe # <-- DKFZ account name```
= Register with LDAP =
IMPORTANT: Make sure to use the `LDAP` login form instead of the ~~`Username/Password`~~ login form.
In Phabricator, click on `Log In` at the top or follow [[https://phabricator.mitk.org/auth/start/ | this link]] to register your DKFZ account:
{F752525, size=full}
= Set up VCS password =
Authentification for read and write access to hosted Git repositories is managed by Phabricator. You must set a VCS password that should be different to your DKFZ account password. You can do this in your [[/settings | Personal Account Settings]]:
{nav icon=wrench, name=Settings > Personal Account Settings > VCS Password}
Use this password when you are asked for your credentials by Git, not your DKFZ account password.
= Upload public SSH key =
We also provide SSH authentification for read and write access to hosted Git repositories, which is more comfortable than using a password. Choose the SSH URI when cloning a repository instead of the HTTPS URI to use this type of authentification. You need to tell Phabricator your public SSH key in your [[/settings | Personal Account Settings]]:
{nav icon=wrench, name=Settings > Personal Account Settings > SSH Public Keys > icon=cog, name="SSH Key Actions" > icon=upload, name="Upload Public Key"}
Copy the contents of your public key (usually a file named `id_rsa.pub` located in a hidden `.ssh` directory in your home directory) into the `Public Key` field and give it a `Name` like "John Doe <j.doe@dkfz-heidelberg.de>".
NOTE: At the DKFZ, the `X:` drive is your home directory on {icon windows} Windows.
If you don't have a SSH key pair yet, use `ssh-keygen` in your terminal/Git Bash to generate one. When asked for a passphrase by `ssh-keygen`, leave it empty:
```$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/x/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /x/.ssh/id_rsa.
Your public key has been saved in /x/.ssh/id_rsa.pub.```
= Profile picture =
Please change your profile picture to something individual by clicking on the default profile picture at the top:
{nav Profile > icon=cogs, name=Manage > icon=picture-o, name="Edit Profile Picture"}
= Install Git =
- {icon linux} [[guide/install-git-linux | Linux (Ubuntu)]]
- {icon windows} [[guide/install-git-windows | Windows]]
= Configure Git =
IMPORTANT: Make sure to use the correct domain in your email address, e.g. `dkfz-heidelberg.de` instead of ~~`dkfz.de`~~.
```$ git config --global user.name "John Doe"
$ git config --global user.email j.doe@dkfz-heidelberg.de
$ git config --global credential.https://phabricator.mitk.org.username jdoe # <-- DKFZ account name```
= Register with LDAP =
IMPORTANT: Make sure to use the `LDAP` login form instead of the ~~`Username/Password`~~ login form.
In Phabricator, click on `Log In` at the top or follow [[https://phabricator.mitk.org/auth/start/ | this link]] to register your DKFZ account:
{F752525, size=full}
= Set up VCS password =
Authentification for read and write access to hosted Git repositories is managed by Phabricator. You must set a VCS password that should be different to your DKFZ account password. You can do this in your [[/settings | Personal Account Settings]]:
{nav icon=wrench, name=Settings > Personal Account Settings > VCS Password}
Use this password when you are asked for your credentials by Git, not your DKFZ account password.
= Upload public SSH key =
We also provide SSH authentification for read and write access to hosted Git repositories, which is more comfortable than using a password. Choose the SSH URI when cloning a repository instead of the HTTPS URI to use this type of authentification. You need to tell Phabricator your public SSH key in your [[/settings | Personal Account Settings]]:
{nav icon=wrench, name=Settings > Personal Account Settings > SSH Public Keys > icon=cog, name="SSH Key Actions" > icon=upload, name="Upload Public Key"}
Copy the contents of your public key (usually a file named `id_rsa.pub` located in a hidden `.ssh` directory in your home directory) into the `Public Key` field and give it a `Name` like "John Doe <j.doe@dkfz-heidelberg.de>".
NOTE: At the DKFZ, the `X:` drive is your home directory on {icon windows} Windows.
If you don't have a SSH key pair yet, use `ssh-keygen` in your terminal/Git Bash to generate one. When asked for a passphrase by `ssh-keygen`, leave it empty:
```$ ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/x/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /x/.ssh/id_rsa.
Your public key has been saved in /x/.ssh/id_rsa.pub.```
= Profile picture =
Please change your profile picture to something individual by clicking on the default profile picture at the top:
{nav Profile > icon=cogs, name=Manage > icon=picture-o, name="Edit Profile Picture"}