diff options
| -rw-r--r-- | doc/gitlab-basics/start-using-git.md | 44 |
1 files changed, 38 insertions, 6 deletions
diff --git a/doc/gitlab-basics/start-using-git.md b/doc/gitlab-basics/start-using-git.md index f897083afb8..e352eee174f 100644 --- a/doc/gitlab-basics/start-using-git.md +++ b/doc/gitlab-basics/start-using-git.md @@ -68,18 +68,50 @@ git config --global --list ## Basic Git commands -### Clone down a repository +### Clone a repository + +To start working locally on an existing remote repository, +clone it with `git clone <repository path>`. By cloning a +repository, you'll download a copy of its files in your +local computer, preserving the Git connection with the +remote repository. + +You can either clone it via HTTPS or [SSH](../ssh/README.md). +If you chose to clone it via HTTPS, you'll have to enter your +credentials every time you pull and push. With SSH, you enter +your credentials once and can pull and push straight away. + +You can find both paths (HTTPS and SSH) by navigating to +your project's landing page and clicking **Clone**. GitLab +will prompt you with both paths, from which you can copy +and paste in your command line. + +As an example, consider a repository path: + +* `https://gitlab.com/gitlab-org/gitlab-ce.git` +* `git@gitlab.com:gitlab-org/gitlab-ce.git` + +To get started, open a terminal window in the directory +you wish to clone the repository files into, and run one +of the following commands. + +Clone via HTTPS: -This is for you to get a copy of the repository from a ongoing project, where REPOSITORY-URL is the url to your git repository. It will be placed in a folder that has the same name as your repository by default. ```bash -git clone REPOSITORY-URL +git clone https://gitlab.com/gitlab-org/gitlab-ce.git ``` -Once your repository is cloned, you can change your working directory to the new folder and use the other commands below. +Clone via SSH: +```bash +git clone git@gitlab.com:gitlab-org/gitlab-ce.git ``` -cd REPOSITORY -``` + +Both commands will download a copy of the files in a +folder named after the project's name. + +You can then navigate to the directory and start working +on it locally. ### Go to the master branch to pull the latest changes from there |