From 1b82bd27ea3913032d0789333d35304e221956f9 Mon Sep 17 00:00:00 2001 From: karen Carias Date: Mon, 22 Jun 2015 08:54:40 -0700 Subject: [PATCH 1/4] added new file about creating your SSH keys --- doc/gitlab_basics/README.md | 2 +- doc/gitlab_basics/create_your_ssh_keys.md | 47 +++++++++++++++++++++++ 2 files changed, 48 insertions(+), 1 deletion(-) create mode 100644 doc/gitlab_basics/create_your_ssh_keys.md diff --git a/doc/gitlab_basics/README.md b/doc/gitlab_basics/README.md index c434e0146e3..de56c3ab4fc 100644 --- a/doc/gitlab_basics/README.md +++ b/doc/gitlab_basics/README.md @@ -4,4 +4,4 @@ Step-by-step guides on the basics of working with Git and GitLab. * [Start using Git on the commandline](start_using_git.md) - +* [Create and add your SSH Keys](create_your_ssh_keys.md) diff --git a/doc/gitlab_basics/create_your_ssh_keys.md b/doc/gitlab_basics/create_your_ssh_keys.md new file mode 100644 index 00000000000..3720381f014 --- /dev/null +++ b/doc/gitlab_basics/create_your_ssh_keys.md @@ -0,0 +1,47 @@ +# How to create your SSH Keys + +You need to connect your computer to your GitLab account through SSH Keys. They are unique for every computer that you link with your GitLab account with. + +## Generate your SSH Key + +* Create an account on GitLab. Sign up and check your email for your confirmation link + +* After you confirm, go to [gitlab.com](https://about.gitlab.com/) and sign in to your account + +## Add your SSH Key + +* At the top right corner, click on "profile settings" + +![profile settings](basicimages/profile_settings.png) + +* On the left side menu click on "SSH Keys" + +![SSH Keys](basicimages/shh_keys.png) + +* Then click on the green button "Add SSH Key" + +![Add SSH Key](basicimages/add_sshkey.png) + +* There, you should paste the SSH Key that your commandline will generate for you. Below you'll find the steps to generate it + +![Paste SSH Key](basicimages/paste_sshkey.png) + +## To generate an SSH Key on your commandline + +* Go to your [commandline](start_using_git.md) and follow the [instructions](https://gitlab.com/help/ssh/README) to generate it + +* Copy your SSH Key that your commandline created and paste it on the "Key" box on the GitLab page. The title will be added automatically + +![Paste SSH Key](basicimages/key.png) + +## Things to know when using your commandline + +1. Don’t use capital letters + +1. You need to find out how your directory is structured. The structure is like a tree, so you won’t be able to access one subfolder unless you open the main folder where it is contained. Directories are folders or files in your system. + +1. You can change multiple pages in one commit. A branch consists of multiple commits. + +1. The terminal will add changes locally in your computer, that you later need to send to gitlab.com. + +1. You can add changes directly into your computer files after you tell the terminal: “git pull NAME OF DOC”, and then you can send those changes to GitLab through the terminal. (changes like adding files, changing names, adding pictures to files, etc) From 707864a4f384c654d4c16e081ff4c3361322f937 Mon Sep 17 00:00:00 2001 From: karen Carias Date: Mon, 22 Jun 2015 09:00:38 -0700 Subject: [PATCH 2/4] added images to doc --- doc/gitlab_basics/create_your_ssh_keys.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/doc/gitlab_basics/create_your_ssh_keys.md b/doc/gitlab_basics/create_your_ssh_keys.md index 3720381f014..27c163b6704 100644 --- a/doc/gitlab_basics/create_your_ssh_keys.md +++ b/doc/gitlab_basics/create_your_ssh_keys.md @@ -1,6 +1,6 @@ # How to create your SSH Keys -You need to connect your computer to your GitLab account through SSH Keys. They are unique for every computer that you link with your GitLab account with. +You need to connect your computer to your GitLab account through SSH Keys. They are unique for every computer that you link your GitLab account with. ## Generate your SSH Key @@ -12,31 +12,31 @@ You need to connect your computer to your GitLab account through SSH Keys. They * At the top right corner, click on "profile settings" -![profile settings](basicimages/profile_settings.png) +![profile settings](basicsimages/profile_settings.png) * On the left side menu click on "SSH Keys" -![SSH Keys](basicimages/shh_keys.png) +![SSH Keys](basicsimages/shh_keys.png) * Then click on the green button "Add SSH Key" -![Add SSH Key](basicimages/add_sshkey.png) +![Add SSH Key](basicsimages/add_sshkey.png) * There, you should paste the SSH Key that your commandline will generate for you. Below you'll find the steps to generate it -![Paste SSH Key](basicimages/paste_sshkey.png) +![Paste SSH Key](basicsimages/paste_sshkey.png) ## To generate an SSH Key on your commandline * Go to your [commandline](start_using_git.md) and follow the [instructions](https://gitlab.com/help/ssh/README) to generate it -* Copy your SSH Key that your commandline created and paste it on the "Key" box on the GitLab page. The title will be added automatically +* Copy the SSH Key that your commandline created and paste it on the "Key" box on the GitLab page. The title will be added automatically -![Paste SSH Key](basicimages/key.png) +![Paste SSH Key](basicsimages/key.png) ## Things to know when using your commandline -1. Don’t use capital letters +1. Don’t use capital letters. 1. You need to find out how your directory is structured. The structure is like a tree, so you won’t be able to access one subfolder unless you open the main folder where it is contained. Directories are folders or files in your system. @@ -44,4 +44,4 @@ You need to connect your computer to your GitLab account through SSH Keys. They 1. The terminal will add changes locally in your computer, that you later need to send to gitlab.com. -1. You can add changes directly into your computer files after you tell the terminal: “git pull NAME OF DOC”, and then you can send those changes to GitLab through the terminal. (changes like adding files, changing names, adding pictures to files, etc) +1. You can add changes directly into your computer files after you tell the terminal: “git pull NAME OF DOC”, and then you can send those changes to GitLab through the terminal (changes like adding files, changing names, adding pictures to files, etc). From 2cf9baecfbd2d7163add07c81bfd5b8dd1f85706 Mon Sep 17 00:00:00 2001 From: karen Carias Date: Tue, 23 Jun 2015 11:20:20 -0700 Subject: [PATCH 3/4] added requested changes --- doc/gitlab_basics/create_your_ssh_keys.md | 11 ----------- 1 file changed, 11 deletions(-) diff --git a/doc/gitlab_basics/create_your_ssh_keys.md b/doc/gitlab_basics/create_your_ssh_keys.md index 27c163b6704..14f69638700 100644 --- a/doc/gitlab_basics/create_your_ssh_keys.md +++ b/doc/gitlab_basics/create_your_ssh_keys.md @@ -34,14 +34,3 @@ You need to connect your computer to your GitLab account through SSH Keys. They ![Paste SSH Key](basicsimages/key.png) -## Things to know when using your commandline - -1. Don’t use capital letters. - -1. You need to find out how your directory is structured. The structure is like a tree, so you won’t be able to access one subfolder unless you open the main folder where it is contained. Directories are folders or files in your system. - -1. You can change multiple pages in one commit. A branch consists of multiple commits. - -1. The terminal will add changes locally in your computer, that you later need to send to gitlab.com. - -1. You can add changes directly into your computer files after you tell the terminal: “git pull NAME OF DOC”, and then you can send those changes to GitLab through the terminal (changes like adding files, changing names, adding pictures to files, etc). From fe44adb73ceb877567dc4a6574d6a9ada2cfcc2b Mon Sep 17 00:00:00 2001 From: karen Carias Date: Tue, 23 Jun 2015 11:27:08 -0700 Subject: [PATCH 4/4] added final phrase in doc --- doc/gitlab_basics/create_your_ssh_keys.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/gitlab_basics/create_your_ssh_keys.md b/doc/gitlab_basics/create_your_ssh_keys.md index 14f69638700..1e7f7c28513 100644 --- a/doc/gitlab_basics/create_your_ssh_keys.md +++ b/doc/gitlab_basics/create_your_ssh_keys.md @@ -34,3 +34,4 @@ You need to connect your computer to your GitLab account through SSH Keys. They ![Paste SSH Key](basicsimages/key.png) +* Now, you'll be able to use Git over SSH, instead of Git over HTTP.