kotovalexarian-likes-gitlab
/
gitlab-org--gitlab-foss
1
0
Fork 0
Code Releases Activity

Update related documentation 

Update the newly added documentation to be more precise and
fix the typos.

Add information about Project aliases into permissions doc.
This commit is contained in:
Patrick Bajao 2019-06-17 11:56:59 +08:00
parent 550ac52b14
commit 6aa0b173e2
3 changed files with 35 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
doc/api/project_aliases.md
View File

@ -1,10 +1,12 @@
# Project Aliases API # Project Aliases API **[PREMIUM ONLY]**
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3264) in GitLab 12.1.
All methods require administrator authorization. All methods require administrator authorization.
## List all project aliases ## List all project aliases
Get a list of all project aliases Get a list of all project aliases:
``` ```
GET /project_aliases GET /project_aliases
@ -33,7 +35,7 @@ Example response:
## Get project alias' details ## Get project alias' details
Get details of a project alias Get details of a project alias:
``` ```
GET /project_aliases/:name GET /project_aliases/:name
@ -57,9 +59,10 @@ Example response:
} }
``` ```
## Create an alias for a project ## Create a project alias
Add a new alias for a project. Reponds with a 201 when successful, 400 when there are validation errors (e.g. alias already exists). Add a new alias for a project. Responds with a 201 when successful,
400 when there are validation errors (e.g. alias already exists):
``` ```
POST /project_aliases POST /project_aliases
@ -67,7 +70,7 @@ POST /project_aliases
| Attribute | Type | Required | Description | | Attribute | Type | Required | Description |
|--------------|--------|----------|-----------------------------------------------| |--------------|--------|----------|-----------------------------------------------|
| `project_id` | string | yes | The The ID or URL-encoded path of the project | | `project_id` | string | yes | The ID or URL-encoded path of the project. |
| `name` | string | yes | The name of the alias. Must be unique. | | `name` | string | yes | The name of the alias. Must be unique. |
``` ```
@ -84,9 +87,10 @@ Example response:
} }
``` ```
## Delete a project aliase ## Delete a project alias
Removes a project aliases. Respond with a 204 when project alias exists, 404 when it doesn't. Removes a project aliases. Responds with a 204 when project alias
exists, 404 when it doesn't:
``` ```
DELETE /project_aliases/:name DELETE /project_aliases/:name

5
doc/user/permissions.md
View File

@ -365,3 +365,8 @@ for details about the pipelines security model.
Since GitLab 8.15, LDAP user permissions can now be manually overridden by an admin user. Since GitLab 8.15, LDAP user permissions can now be manually overridden by an admin user.
Read through the documentation on [LDAP users permissions](../administration/auth/how_to_configure_ldap_gitlab_ee/index.html) to learn more. Read through the documentation on [LDAP users permissions](../administration/auth/how_to_configure_ldap_gitlab_ee/index.html) to learn more.
## Project aliases
Project aliases can only be read, created and deleted by a GitLab administrator.
Read through the documentation on [Project aliases](../user/project/index.md#project-aliases-premium-only) to learn more.

26
doc/user/project/index.md
View File

@ -193,17 +193,27 @@ password <personal_access_token>
To quickly access a project from the GitLab UI using the project ID, To quickly access a project from the GitLab UI using the project ID,
visit the `/projects/:id` URL in your browser or other tool accessing the project. visit the `/projects/:id` URL in your browser or other tool accessing the project.
## Project aliases ## Project aliases **[PREMIUM ONLY]**
Projects' repositories are usually cloned with a namespace and project name. It is > [Introduced](https://gitlab.com/gitlab-org/gitlab-ee/issues/3264) in GitLab 12.1.
also possible to clone them via a project alias. This feature is only available on Git over SSH.
A project alias can be created via API only by administrators. Follow the When migrating repositories to GitLab and they are being accessed by other systems,
[Project Aliases API documentation](../../api/project_aliases.md) for more details. it's very useful to be able to access them using the same name especially when
they are a lot. It reduces the risk of changing significant number of Git URLs in
a large number of systems.
Once an alias has been created for a project (e.g. gitlab-ce for gitlab-org/gitlab-ce), GitLab provides a functionality to help with this. In GitLab, repositories are
the repository can be cloned using the alias (e.g `git clone git@gitlab.com:gitlab-ce.git` usually accessed with a namespace and project name. It is also possible to access
instead of `git clone git@gitlab.com:gitlab-org/gitlab-ce.git`). them via a project alias. This feature is only available on Git over SSH.
A project alias can be only created via API and only by GitLab administrators.
Follow the [Project Aliases API documentation](../../api/project_aliases.md) for
more details.
Once an alias has been created for a project (e.g., an alias `gitlab-ce` for the
project `https://gitlab.com/gitlab-org/gitlab-ce`), the repository can be cloned
using the alias (e.g `git clone git@gitlab.com:gitlab-ce.git` instead of
`git clone git@gitlab.com:gitlab-org/gitlab-ce.git`).
## Project APIs ## Project APIs