Difference between revisions of "Get started"

From ETSI Forge
Jump to: navigation, search
Line 4: Line 4:
  
 
In this page we will go through the initial setup to contribute to the Forge.
 
In this page we will go through the initial setup to contribute to the Forge.
</big>{{My template}}This is the content of the template
+
</big>
  
 
In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at [mailto:cti_support@etsi.org cti_support@etsi.org].
 
In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at [mailto:cti_support@etsi.org cti_support@etsi.org].
Line 20: Line 20:
 
# Install [https://tortoisegit.org/ Tortoise Git]
 
# Install [https://tortoisegit.org/ Tortoise Git]
  
= Set up your Gerrit profile =
+
= Set up your profile =
 
 
In order to use Gerrit to contribute and review code you will need to add your credentials.
 
Both SSH and HTTPS are supported, the latter is recommend for starters and its usage will be explained below.
 
<big>
 
# Navigate to Gerrit at https://forge.etsi.org/gerrit.
 
# Sign in (link in the top right corner) entering your EOL or FORGE credentials.
 
#* [[File:Gerrit tutorial signin.png|700px|frameless|Click to enlarge|center|Click to enlarge]]
 
# Your user name will appear on the top right of the page. Click on it, the select '''Settings'''.
 
#*
 
[[File:Gerrit tutorial settings.png|700px|frameless|Click to enlarge|center|Click to enlarge]]
 
# In the menu on the left, select '''HTTP Password'''.
 
#* [[File:Gerrit http password.png|700px|frameless|Click to enlarge|center|Click to enlarge]]
 
# Click on <code>Generate password</code> button.
 
 
 
<br />
 
Now Gerrit has a secure password for your HTTP access.
 
<div style="text-align:center; color:red; font-size:16pt">When cloning a repository you will be asked to insert username and password:
 
'''use the password copied from the Gerrit settings, not your EOL password'''.
 
  
Don't worry, you will need to insert that only once.</div>
+
In order to use the git repositories at Forge, to contribute and to review code you will need to  
</big>
+
# <big>'''Log into''' the platform: [https://forge.etsi.org/gitlab/users/sign_in Click here]</big>
 +
## Use your <u>'''EOL credentials'''</u> to login.
 +
# <big>(Optional) Set up your '''SSH keys''': [https://forge.etsi.org/gitlab/profile/keys Click here]</big>
 +
## This is needed if you intend to push/pull commits over SSH.
 +
# <big>(Optional) '''Customize''' your profile: [https://forge.etsi.org/gitlab/profile Click here]</big>
 +
## You may add your picture, some bios, etc.
 +
# <big>'''That's it'''! Now visit the [https://forge.etsi.org/gitlab/explore/projects Projects] or [https://forge.etsi.org/gitlab/explore/groups Groups] pages to discover the many activities on the Forge.</big>
  
 
= How to contribute =
 
= How to contribute =
  
 
Find out how to clone a repository in [[How to contribute]].
 
Find out how to clone a repository in [[How to contribute]].

Revision as of 16:50, 26 October 2018

ETSI Forge collaboration process is based on the Git versioning system. This means that the shared materials and documents are tracked and versioned at each revision.

In this page we will go through the initial setup to contribute to the Forge.

In case something is missing, feel free to edit and add it to this page. If help is needed you can send an email at cti_support@etsi.org.

Set up Git

On Windows

Install a Git client on your Windows operating system. You may find a list of Windows applications to manage Git repositories here.

The following steps are based on Tortoise Git, but should be similar for other client.

  1. Install Git for Windows
  2. Install Tortoise Git

Set up your profile

In order to use the git repositories at Forge, to contribute and to review code you will need to

  1. Log into the platform: Click here
    1. Use your EOL credentials to login.
  2. (Optional) Set up your SSH keys: Click here
    1. This is needed if you intend to push/pull commits over SSH.
  3. (Optional) Customize your profile: Click here
    1. You may add your picture, some bios, etc.
  4. That's it! Now visit the Projects or Groups pages to discover the many activities on the Forge.

How to contribute

Find out how to clone a repository in How to contribute.