summaryrefslogtreecommitdiff
path: root/doc/gitlab-basics
diff options
context:
space:
mode:
authorTiago Botelho <tiagonbotelho@hotmail.com>2018-01-31 13:52:46 +0000
committerTiago Botelho <tiagonbotelho@hotmail.com>2018-02-06 13:35:35 +0000
commit839829a7786dd163eccb470bf251211bfb90bd72 (patch)
treea30dd2d54dc1b20d9b5e5130b7f4bc5ce44c2723 /doc/gitlab-basics
parentdc229c076cdc0ef6e7f3f74f6e462c22880ff08c (diff)
downloadgitlab-ce-839829a7786dd163eccb470bf251211bfb90bd72.tar.gz
Adds documentation for the feature
Diffstat (limited to 'doc/gitlab-basics')
-rw-r--r--doc/gitlab-basics/create-project.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/doc/gitlab-basics/create-project.md b/doc/gitlab-basics/create-project.md
index e18711f3392..d491d676884 100644
--- a/doc/gitlab-basics/create-project.md
+++ b/doc/gitlab-basics/create-project.md
@@ -33,5 +33,43 @@
1. Click **Create project**.
+## Push to create a new project
+
+> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/26388) in GitLab 10.5.
+
+When you create a new repo locally, instead of going to GitLab to manually
+create a new project and then push the repo, you can directly push it to
+GitLab to create the new project, all without leaving your terminal. That
+will automatically create a new project under a GitLab namespace that you have access to
+with its visibility set to private by default (you can later change it).
+
+This can be done by using either SSH or HTTP:
+
+```
+## Git push using SSH
+git push git@gitlab.com:namespace/nonexistent-project.git branch_name
+
+## Git push using HTTP
+git push https://gitlab.com/namespace/nonexistent-project.git branch_name
+```
+
+Once the push finishes successfully, a remote message will indicate
+the command to set the remote and the URL to the new project:
+
+```
+remote:
+remote: The private project namespace/nonexistent-project was created.
+remote:
+remote: To configure the remote, run:
+remote: git remote add origin https://gitlab.com/namespace/nonexistent-project.git
+remote:
+remote: To view the project, visit:
+remote: https://gitlab.com/namespace/nonexistent-project
+remote:
+```
+
+If the project name is already in use, your push will be rejected
+to prevent accidental overwriting the existing project.
+
[import it]: ../workflow/importing/README.md
[reserved]: ../user/reserved_names.md