debian-mirror-gitlab/doc/README.md

127 lines
11 KiB
Markdown
Raw Normal View History

2018-03-17 18:26:18 +05:30
---
2021-01-29 00:20:46 +05:30
stage: none
group: unassigned
2021-02-22 17:27:13 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments
2018-03-17 18:26:18 +05:30
comments: false
2018-11-08 19:23:39 +05:30
description: 'Learn how to use and administer GitLab, the most scalable Git-based fully integrated platform for software development.'
2018-03-17 18:26:18 +05:30
---
2021-01-29 00:20:46 +05:30
<div class="d-none">
2021-02-22 17:27:13 +05:30
<h3>Visit <a href="https://docs.gitlab.com/ee/">docs.gitlab.com</a> for the latest version
of this help information with enhanced navigation, discoverability, and readability.</h3>
2019-02-15 15:39:39 +05:30
</div>
<!-- the div above will not display on the docs site but will display on /help -->
2019-10-12 21:52:04 +05:30
# GitLab Docs
2014-09-02 18:07:02 +05:30
2020-07-28 23:09:34 +05:30
Welcome to [GitLab](https://about.gitlab.com/) documentation.
2019-02-15 15:39:39 +05:30
Here you can access the complete documentation for GitLab, the single application for the
[entire DevOps lifecycle](#the-entire-devops-lifecycle).
## Overview
No matter how you use GitLab, we have documentation for you.
2021-02-22 17:27:13 +05:30
| Essential documentation | Essential documentation |
|:---------------------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------|
| [**User documentation**](user/index.md)<br>Discover features and concepts for GitLab users. | [**Administrator documentation**](administration/index.md)<br/>Everything GitLab self-managed administrators need to know. |
| [**Contributing to GitLab**](#contributing-to-gitlab)<br/>At GitLab, everyone can contribute! | [**New to Git and GitLab?**](#new-to-git-and-gitlab)<br/>We have the resources to get you started. |
| [**Build an integration with GitLab**](#build-an-integration-with-gitlab)<br/>Consult our integration documentation. | [**Coming to GitLab from another platform?**](#coming-to-gitlab-from-another-platform)<br/>Consult our guides. |
| [**Install GitLab**](https://about.gitlab.com/install/)<br/>Installation options for different platforms. | [**Customers**](subscriptions/index.md)<br/>Information for new and existing customers. |
| [**Update GitLab**](update/README.md)<br/>Update your GitLab self-managed instance to the latest version. | [**Reference Architectures**](administration/reference_architectures/index.md)<br/>GitLab reference architectures |
| [**GitLab releases**](https://about.gitlab.com/releases/)<br/>What's new in GitLab. | |
2020-07-28 23:09:34 +05:30
## Popular topics
Have a look at some of our most popular topics:
| Popular topic | Description |
|:-----------------------------------------------------------------------------------------------------------|:---------------------------------------------------------------------------|
| [Two-factor authentication](user/profile/account/two_factor_authentication.md) | Improve the security of your GitLab account. |
| [GitLab groups](user/group/index.md) | Manage projects together. |
| [GitLab CI/CD pipeline configuration reference](ci/yaml/README.md) | Available configuration options for `.gitlab-ci.yml` files. |
| [Activate GitLab EE with a license](user/admin_area/license.md) **(STARTER ONLY)** | Activate GitLab Enterprise Edition functionality with a license. |
| [Back up and restore GitLab](raketasks/backup_restore.md) **(CORE ONLY)** | Rake tasks for backing up and restoring GitLab self-managed instances. |
| [GitLab release and maintenance policy](policy/maintenance.md) | Policies for version naming and cadence, and also upgrade recommendations. |
| [Elasticsearch integration](integration/elasticsearch.md) **(STARTER ONLY)** | Integrate Elasticsearch with GitLab to enable advanced searching. |
| [Omnibus GitLab database settings](https://docs.gitlab.com/omnibus/settings/database.html) **(CORE ONLY)** | Database settings for Omnibus GitLab self-managed instances. |
| [Omnibus GitLab NGINX settings](https://docs.gitlab.com/omnibus/settings/nginx.html) **(CORE ONLY)** | NGINX settings for Omnibus GitLab self-managed instances. |
| [Omnibus GitLab SSL configuration](https://docs.gitlab.com/omnibus/settings/ssl.html) **(CORE ONLY)** | SSL settings for Omnibus GitLab self-managed instances. |
| [GitLab.com settings](user/gitlab_com/index.md) | Settings used for GitLab.com. |
2018-05-09 12:01:36 +05:30
2021-01-29 00:20:46 +05:30
## The entire DevOps lifecycle
2018-05-09 12:01:36 +05:30
GitLab is the first single application for software development, security,
2021-02-22 17:27:13 +05:30
and operations that enables [Concurrent DevOps](https://about.gitlab.com/topics/concurrent-devops/).
GitLab makes the software lifecycle faster and radically improves the speed of business.
2019-02-15 15:39:39 +05:30
2021-02-22 17:27:13 +05:30
GitLab provides solutions for [each of the stages of the DevOps lifecycle](https://about.gitlab.com/stages-devops-lifecycle/).
2014-09-02 18:07:02 +05:30
2019-02-15 15:39:39 +05:30
## New to Git and GitLab?
Working with new systems can be daunting.
We have the following documentation to rapidly uplift your GitLab knowledge:
2021-01-29 00:20:46 +05:30
| Topic | Description |
|:--------------------------------------------------------------------------------------------------|:---------------------------------------------------------------|
| [GitLab basics guides](gitlab-basics/README.md) | Start working on the command line and with GitLab. |
| [GitLab workflow overview](https://about.gitlab.com/blog/2016/10/25/gitlab-workflow-an-overview/) | Enhance your workflow with the best of GitLab Workflow. |
| [Get started with GitLab CI/CD](ci/quick_start/README.md) | Quickly implement GitLab CI/CD. |
2021-02-22 17:27:13 +05:30
| [Auto DevOps](topics/autodevops/index.md) | Learn more about Auto DevOps in GitLab. |
| [GitLab Markdown](user/markdown.md) | Advanced formatting system (GitLab Flavored Markdown) |
2019-02-15 15:39:39 +05:30
### User account
Learn more about GitLab account management:
| Topic | Description |
|:-----------------------------------------------------------|:---------------------------------------------------------------------------------------------------------------------------|
| [User account](user/profile/index.md) | Manage your account. |
2019-12-26 22:10:19 +05:30
| [Authentication](topics/authentication/index.md) | Account security with two-factor authentication, set up your SSH keys, and deploy keys for secure access to your projects. |
2019-02-15 15:39:39 +05:30
| [Profile settings](user/profile/index.md#profile-settings) | Manage your profile settings, two factor authentication, and more. |
| [User permissions](user/permissions.md) | Learn what each role in a project can do. |
2018-03-27 19:54:05 +05:30
2019-02-15 15:39:39 +05:30
### Git and GitLab
Learn more about using Git, and using Git with GitLab:
2021-01-29 00:20:46 +05:30
| Topic | Description |
|:-----------------------------------------------------------------------------|:---------------------------------------------------------------------------|
| [Git](topics/git/index.md) | Getting started with Git, branching strategies, Git LFS, and advanced use. |
2020-01-01 13:55:28 +05:30
| [Git cheat sheet](https://about.gitlab.com/images/press/git-cheat-sheet.pdf) | Download a PDF describing the most used Git operations. |
2021-01-29 00:20:46 +05:30
| [GitLab Flow](topics/gitlab_flow.md) | Explore the best of Git with the GitLab Flow strategy. |
2019-02-15 15:39:39 +05:30
## Coming to GitLab from another platform
2021-01-29 00:20:46 +05:30
If you are coming to GitLab from another platform, the following information is useful:
2019-02-15 15:39:39 +05:30
2021-01-29 00:20:46 +05:30
| Topic | Description |
|:----------------------------------------------------|:---------------------------------------------------------------------------------------|
| [Importing to GitLab](user/project/import/index.md) | Import your projects from GitHub, Bitbucket, GitLab.com, FogBugz, and SVN into GitLab. |
| [Migrating from SVN](user/project/import/svn.md) | Convert a SVN repository to Git and GitLab. |
2019-02-15 15:39:39 +05:30
2020-07-28 23:09:34 +05:30
## Build an integration with GitLab
2019-02-15 15:39:39 +05:30
There are many ways to integrate with GitLab, including:
2021-02-22 17:27:13 +05:30
| Topic | Description |
|:-------------------------------------------|:---------------------------------------------|
| [GitLab REST API](api/README.md) | Integrate with GitLab using our REST API. |
| [GitLab GraphQL API](api/graphql/index.md) | Integrate with GitLab using our GraphQL API. |
| [Integrations](integration/README.md) | Integrations with third-party products. |
2019-02-15 15:39:39 +05:30
## Contributing to GitLab
2019-12-04 20:38:33 +05:30
GitLab Community Edition is [open source](https://gitlab.com/gitlab-org/gitlab-foss/)
and GitLab Enterprise Edition is [open-core](https://gitlab.com/gitlab-org/gitlab/).
2018-03-27 19:54:05 +05:30
2019-02-15 15:39:39 +05:30
Learn how to contribute to GitLab with the following resources:
2018-03-27 19:54:05 +05:30
2019-02-15 15:39:39 +05:30
| Topic | Description |
|:------------------------------------------------------------|:-----------------------------------------|
| [Development](development/README.md) | How to contribute to GitLab development. |
| [Legal](legal/README.md) | Contributor license agreements. |
| [Writing documentation](development/documentation/index.md) | How to contribute to GitLab Docs. |