debian-mirror-gitlab/doc/user/index.md

255 lines
10 KiB
Markdown
Raw Normal View History

2018-11-08 19:23:39 +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
2020-10-24 23:57:45 +05:30
type: reference, index
2018-11-08 19:23:39 +05:30
description: 'Read through the GitLab User documentation to learn how to use, configure, and customize GitLab and GitLab.com to your own needs.'
---
2021-04-17 20:07:23 +05:30
# User Docs **(FREE)**
2017-09-10 17:25:29 +05:30
Welcome to GitLab! We're glad to have you here!
2021-02-22 17:27:13 +05:30
As a GitLab user you have access to all the features
2018-11-08 19:23:39 +05:30
your [subscription](https://about.gitlab.com/pricing/)
2019-07-07 11:18:12 +05:30
includes, except [GitLab administrator](../administration/index.md)
2021-11-18 22:05:49 +05:30
settings, unless you have administrator privileges to install, configure,
2017-09-10 17:25:29 +05:30
and upgrade your GitLab instance.
2021-11-18 22:05:49 +05:30
Administrator privileges for [GitLab.com](https://gitlab.com/) are restricted to the GitLab team.
2017-09-10 17:25:29 +05:30
2020-04-08 14:13:33 +05:30
For more information on configuring GitLab self-managed instances, see the [Administrator documentation](../administration/index.md).
2017-09-10 17:25:29 +05:30
## Overview
2019-03-02 22:35:43 +05:30
GitLab is a fully integrated software development platform that enables your team to be transparent, fast, effective, and cohesive from discussion on a new idea to production, all on the same platform.
2017-09-10 17:25:29 +05:30
2019-03-02 22:35:43 +05:30
For more information, see [All GitLab Features](https://about.gitlab.com/features/).
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
### Concepts
2019-03-02 22:35:43 +05:30
To get familiar with the concepts needed to develop code on GitLab, read the following articles:
2018-03-17 18:26:18 +05:30
2019-12-21 20:55:43 +05:30
- [Demo: Mastering Code Review With GitLab](https://about.gitlab.com/blog/2017/03/17/demo-mastering-code-review-with-gitlab/).
2021-09-30 23:02:18 +05:30
- [What is GitLab Flow?](https://about.gitlab.com/topics/version-control/what-is-gitlab-flow/).
2019-12-21 20:55:43 +05:30
- [Tutorial: It's all connected in GitLab](https://about.gitlab.com/blog/2016/03/08/gitlab-tutorial-its-all-connected/): an overview on code collaboration with GitLab.
- [Trends in Version Control Land: Microservices](https://about.gitlab.com/blog/2016/08/16/trends-in-version-control-land-microservices/).
2021-04-17 20:07:23 +05:30
- [Trends in Version Control Land: Innersourcing](https://about.gitlab.com/topics/version-control/what-is-innersource/).
2018-03-17 18:26:18 +05:30
2017-09-10 17:25:29 +05:30
## Use cases
2018-03-17 18:26:18 +05:30
GitLab is a Git-based platform that integrates a great number of essential tools for software development and deployment, and project management:
2017-09-10 17:25:29 +05:30
2019-07-07 11:18:12 +05:30
- Hosting code in repositories with version control.
2019-03-02 22:35:43 +05:30
- Tracking proposals for new implementations, bug reports, and feedback with a
2021-04-29 21:17:54 +05:30
fully featured [Issue tracker](project/issues/index.md).
2021-11-11 11:23:49 +05:30
- Organizing and prioritizing with [issue boards](project/issue_board.md).
2022-04-04 11:22:00 +05:30
- Reviewing code in [merge requests](project/merge_requests/index.md) with live-preview changes per
2019-07-07 11:18:12 +05:30
branch with [Review Apps](../ci/review_apps/index.md).
2021-09-30 23:02:18 +05:30
- Building, testing, and deploying with built-in [Continuous Integration](../ci/index.md).
2022-05-07 20:08:51 +05:30
- View the current health and status of each CI environment running on Kubernetes with [deploy boards](project/deploy_boards.md).
- Leverage continuous delivery method with [Canary Deployments](project/canary_deployments.md).
2019-07-07 11:18:12 +05:30
- Deploying personal and professional static websites with [GitLab Pages](project/pages/index.md).
2019-12-04 20:38:33 +05:30
- Integrating with Docker by using [GitLab Container Registry](packages/container_registry/index.md).
2021-01-03 14:25:43 +05:30
- Tracking the development lifecycle by using [GitLab Value Stream Analytics](analytics/value_stream_analytics.md).
2020-07-28 23:09:34 +05:30
- Provide support with [Service Desk](project/service_desk.md).
2021-01-03 14:25:43 +05:30
- [Export issues as CSV](project/issues/csv_export.md).
2017-09-10 17:25:29 +05:30
With GitLab Enterprise Edition, you can also:
2019-12-26 22:10:19 +05:30
- Improve collaboration with:
2022-04-04 11:22:00 +05:30
- [Merge request approvals](project/merge_requests/approvals/index.md).
2021-04-17 20:07:23 +05:30
- [Multiple Assignees for Issues](project/issues/multiple_assignees_for_issues.md).
2021-11-11 11:23:49 +05:30
- [Multiple issue boards](project/issue_board.md#multiple-issue-boards).
2021-04-29 21:17:54 +05:30
- Create formal relationships between issues with [linked issues](project/issues/related_issues.md).
2021-02-22 17:27:13 +05:30
- Use [Burndown Charts](project/milestones/burndown_and_burnup_charts.md) to track progress during a sprint or while working on a new version of their software.
2021-04-17 20:07:23 +05:30
- Leverage [Elasticsearch](../integration/elasticsearch.md) with [Advanced Search](search/advanced_search.md) for faster, more advanced code search across your entire GitLab instance.
2019-09-04 21:01:54 +05:30
- [Authenticate users with Kerberos](../integration/kerberos.md).
2021-11-18 22:05:49 +05:30
- [Mirror a repository](project/repository/mirror/index.md) from elsewhere on your local server.
2021-09-30 23:02:18 +05:30
- View your entire CI/CD pipeline involving more than one project with [Multiple-Project Pipelines](../ci/pipelines/multi_project_pipelines.md).
2019-09-04 21:01:54 +05:30
- [Lock files](project/file_lock.md) to prevent conflicts.
- Scan your code for vulnerabilities and [display them in merge requests](application_security/sast/index.md).
2017-09-10 17:25:29 +05:30
2021-04-29 21:17:54 +05:30
You can also [integrate](project/integrations/overview.md) GitLab with numerous third-party applications, such as Mattermost, Microsoft Teams, Trello, Slack, Bamboo CI, Jira, and a lot more.
2017-09-10 17:25:29 +05:30
2021-01-29 00:20:46 +05:30
## User types
There are several types of users in GitLab:
2022-05-07 20:08:51 +05:30
- Regular users.
- [Internal users](../development/internal_users.md) often referred to as bot or system users.
- [Auditor](permissions.md#auditor-users) with read access to self-managed instances.
2021-01-29 00:20:46 +05:30
- [GitLab Administrator](../administration/index.md) with full access to
2022-05-07 20:08:51 +05:30
self-managed instances including settings and the [Admin Area](admin_area/index.md).
Each user can be a member in a [group](group/index.md).
See the [permissions page](permissions.md) for details on how each user type is used.
2021-01-29 00:20:46 +05:30
2021-03-11 19:13:27 +05:30
## User activity
2021-12-11 22:18:48 +05:30
GitLab tracks user contribution activity.
2021-04-17 20:07:23 +05:30
You can follow or unfollow other users from their [user profiles](profile/index.md#access-your-user-profile).
2021-06-08 01:23:25 +05:30
To view a user's activity in a top-level Activity view:
2021-03-11 19:13:27 +05:30
2021-06-08 01:23:25 +05:30
1. From a user's profile, select **Follow**.
1. In the GitLab menu, select **Activity**.
1. Select the **Followed users** tab.
2021-03-11 19:13:27 +05:30
2021-12-11 22:18:48 +05:30
### User contribution events
Each of these contribution events is tracked:
- `approved`
- Merge request
- `closed`
- [Epic](group/epics/index.md)
- Issue
- Merge request
- Milestone
- `commented` on any `Noteable` record.
- Alert
- Commit
- Design
- Issue
- Merge request
- Snippet
- `created`
- Design
- [Epic](group/epics/index.md)
- Issue
- Merge request
- Milestone
- Project
- Wiki page
- `destroyed`
- Design
- Milestone
- Wiki page
- `expired`
- Project membership
- `joined`
- Project membership
- `left`
- Project membership
- `merged`
- Merge request
- `pushed` commits to (or deleted commits from) a repository, individually or in bulk.
- Project
- `reopened`
- [Epic](group/epics/index.md)
- Issue
- Merge request
- Milestone
- `updated`
- Design
- Wiki page
2017-09-10 17:25:29 +05:30
## Projects
2019-03-02 22:35:43 +05:30
In GitLab, you can create [projects](project/index.md) to host
your code, track issues, collaborate on code, and continuously
2017-09-10 17:25:29 +05:30
build, test, and deploy your app with built-in GitLab CI/CD. Or, you can do
it all at once, from one single project.
2018-03-17 18:26:18 +05:30
- [Repositories](project/repository/index.md): Host your codebase in
2019-07-07 11:18:12 +05:30
repositories with version control and as part of a fully integrated platform.
2018-03-17 18:26:18 +05:30
- [Issues](project/issues/index.md): Explore the best of GitLab Issues' features.
2022-04-04 11:22:00 +05:30
- [Merge requests](project/merge_requests/index.md): Collaborate on code,
reviews, live preview changes per branch, and request approvals with merge requests.
2018-03-17 18:26:18 +05:30
- [Milestones](project/milestones/index.md): Work on multiple issues and merge
2019-07-07 11:18:12 +05:30
requests towards the same target date with Milestones.
2017-09-10 17:25:29 +05:30
## Account
2022-05-07 20:08:51 +05:30
There is a lot you can customize and configure to enjoy the best of GitLab.
2017-09-10 17:25:29 +05:30
2020-04-22 19:07:51 +05:30
- [Settings](profile/index.md): Manage your user settings to change your personal information,
2019-07-07 11:18:12 +05:30
personal access tokens, authorized applications, etc.
2018-03-17 18:26:18 +05:30
- [Authentication](../topics/authentication/index.md): Read through the authentication
2019-07-07 11:18:12 +05:30
methods available in GitLab.
2018-03-17 18:26:18 +05:30
- [Permissions](permissions.md): Learn the different set of permissions levels for each
2019-07-07 11:18:12 +05:30
user type (guest, reporter, developer, maintainer, owner).
2018-03-17 18:26:18 +05:30
- [Feature highlight](feature_highlight.md): Learn more about the little blue dots
2019-07-31 22:56:46 +05:30
around the app that explain certain features.
2021-06-08 01:23:25 +05:30
- [Abuse reports](report_abuse.md): Report abuse from users to GitLab administrators.
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
## Groups
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
With GitLab [Groups](group/index.md) you can assemble related projects together
and grant members access to several projects at once.
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
Groups can also be nested in [subgroups](group/subgroups/index.md).
2017-09-10 17:25:29 +05:30
## Discussions
In GitLab, you can comment and mention collaborators in issues,
merge requests, code snippets, and commits.
When performing inline reviews to implementations
to your codebase through merge requests you can
2021-09-30 23:02:18 +05:30
gather feedback through [resolvable threads](discussions/index.md#resolve-a-thread).
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
### GitLab Flavored Markdown (GFM)
Read through the [GFM documentation](markdown.md) to learn how to apply
2019-09-30 21:07:59 +05:30
the best of GitLab Flavored Markdown in your threads, comments,
2019-12-26 22:10:19 +05:30
issues and merge requests descriptions, and everywhere else GFM is
2018-03-17 18:26:18 +05:30
supported.
2020-11-24 15:15:51 +05:30
## To-Do List
2017-09-10 17:25:29 +05:30
2020-11-24 15:15:51 +05:30
Never forget to reply to your collaborators. [GitLab To-Do List](todos.md)
is a tool for working faster and more effectively with your team,
2017-09-10 17:25:29 +05:30
by listing all user or group mentions, as well as issues and merge
requests you're assigned to.
## Search
[Search and filter](search/index.md) through groups, projects, issues, merge requests, files, code, and more.
## Snippets
[Snippets](snippets.md) are code blocks that you want to store in GitLab, from which
2022-05-07 20:08:51 +05:30
you have quick access to. You can also gather feedback on them through [Discussions](#discussions).
2017-09-10 17:25:29 +05:30
2021-01-29 00:20:46 +05:30
## GitLab CI/CD
2021-09-30 23:02:18 +05:30
Use built-in [GitLab CI/CD](../ci/index.md) to test, build, and deploy your applications
2021-01-29 00:20:46 +05:30
directly from GitLab. No third-party integrations needed.
2020-11-24 15:15:51 +05:30
## Features behind feature flags
Understand what [features behind feature flags](feature_flags.md) mean.
2019-12-26 22:10:19 +05:30
## Keyboard shortcuts
There are many [keyboard shortcuts](shortcuts.md) in GitLab to help you navigate between
pages and accomplish tasks faster.
2018-03-17 18:26:18 +05:30
## Integrations
2022-05-07 20:08:51 +05:30
[Integrate GitLab](../integration/index.md) with your preferred tool, such as Trello, Jira, etc.
2018-03-17 18:26:18 +05:30
2017-09-10 17:25:29 +05:30
## Webhooks
2018-11-08 19:23:39 +05:30
Configure [webhooks](project/integrations/webhooks.md) to listen for
2021-02-22 17:27:13 +05:30
specific events like pushes, issues or merge requests. GitLab sends a
2017-09-10 17:25:29 +05:30
POST request with data to the webhook URL.
## API
2021-09-30 23:02:18 +05:30
Automate GitLab via [API](../api/index.md).
2017-09-10 17:25:29 +05:30
2018-03-17 18:26:18 +05:30
## Git and GitLab
Learn what is [Git](../topics/git/index.md) and its best practices.
2018-11-18 11:00:15 +05:30
2020-11-24 15:15:51 +05:30
## Instance-level analytics
2018-11-18 11:00:15 +05:30
2020-11-24 15:15:51 +05:30
See [various statistics](admin_area/analytics/index.md) of your GitLab instance.
2019-07-31 22:56:46 +05:30
2021-04-17 20:07:23 +05:30
## Operations Dashboard
2019-07-31 22:56:46 +05:30
2022-05-07 20:08:51 +05:30
See [Operations Dashboard](operations_dashboard/index.md) for a summary of each project's operational health.