提交 1548d6e8 编写于 作者: Lab机器人's avatar Lab机器人

user doc done

上级 a662ac88
...@@ -4,55 +4,55 @@ ...@@ -4,55 +4,55 @@
* [概览](docs/overview.md) * [概览](docs/overview.md)
* [组织](docs/user/org.md) * [组织](docs/user/org.md)
* [子组织](docs/user/org/sub_org.md) * [子组织](docs/user/org/sub_org.md)
* [项目](docs/user/projects.md) * [项目](docs/user/project.md)
* [徽章](docs/user/projects/badges.md) * [徽章](docs/user/project/badges.md)
* [批量编辑](docs/user/projects/bulk-edit.md) * [批量编辑](docs/user/project/bulk-edit.md)
* [新建项目](docs/basic/create-project.md) * [新建项目](docs/basic/create-project.md)
* [描述模板](docs/user/projects/discription-template.md) * [描述模板](docs/user/project/discription-template.md)
* [文件查找](docs/user/projects/repo/file-find.md) * [文件查找](docs/user/project/repo/file-find.md)
* [合并请求](docs/user/projects/merge-request.md) * [合并请求](docs/user/project/merge-request.md)
* [允许协作](docs/user/projects/merge-request/fork-collaboration.md) * [允许协作](docs/user/project/merge-request/fork-collaboration.md)
* [创建合并请求](docs/user/projects/merge-request/create-merge-request.md) * [创建合并请求](docs/user/project/merge-request/create-merge-request.md)
* [Cherry-pick](docs/user/projects/merge-request/cherry-pick.md) * [Cherry-pick](docs/user/project/merge-request/cherry-pick.md)
* [快进合并](docs/user/projects/merge-request/fast-forward.md) * [快进合并](docs/user/project/merge-request/fast-forward.md)
* [解决冲突](docs/user/projects/merge-request/resolve-conflicts.md) * [解决冲突](docs/user/project/merge-request/resolve-conflicts.md)
* [还原](docs/user/projects/merge-request/revert.md) * [还原](docs/user/project/merge-request/revert.md)
* [评审及管理](docs/user/projects/merge-request/reviewing.md) * [评审及管理](docs/user/project/merge-request/reviewing.md)
* [Squash合并](docs/user/projects/merge-request/squash.md) * [Squash合并](docs/user/project/merge-request/squash.md)
* [合并请求版本](docs/user/projects/merge-request/versions.md) * [合并请求版本](docs/user/project/merge-request/versions.md)
* [草稿](docs/user/projects/merge-request/draft.md) * [草稿](docs/user/project/merge-request/draft.md)
* [项目成员](docs/user/projects/member.md) * [项目成员](docs/user/project/member.md)
* [导入](docs/user/projects/import.md) * [导入](docs/user/project/import.md)
* [Github](docs/user/projects/import/github.md) * [Github](docs/user/project/import/github.md)
* [URL](docs/user/projects/import/by-url.md) * [URL](docs/user/project/import/by-url.md)
* [推送选项](docs/user/projects/push-rules.md) * [推送选项](docs/user/project/push-rules.md)
* [Releases](docs/user/projects/releases.md) * [Releases](docs/user/project/releases.md)
* [代码仓库](docs/user/projects/repo.md) * [代码仓库](docs/user/project/repo.md)
* [分支](docs/user/projects/repo/branches.md) * [分支](docs/user/project/repo/branches.md)
* [Git属性](docs/user/projects/git-attr.md) * [Git属性](docs/user/project/git-attr.md)
* [文件指责](docs/user/projects/repo/blame.md) * [文件指责](docs/user/project/repo/blame.md)
* [文件历史记录](docs/user/projects/repo/history.md) * [文件历史记录](docs/user/project/repo/history.md)
* [镜像仓库](docs/user/projects/repo/mirror.md) * [镜像仓库](docs/user/project/repo/mirror.md)
* [保护分支](docs/user/projects/protected-branch.md) * [保护分支](docs/user/project/protected-branch.md)
* [保护Tag](docs/user/projects/protected-tag.md) * [保护Tag](docs/user/project/protected-tag.md)
* [减少仓库大小](docs/user/projects/repo/reduce-repo-size.md) * [减少仓库大小](docs/user/project/repo/reduce-repo-size.md)
* [GPG签名提交](docs/user/projects/repo/gpg-sign.md) * [GPG签名提交](docs/user/project/repo/gpg-sign.md)
* [文件编辑](docs/user/projects/repo/web-editor.md) * [文件编辑](docs/user/project/repo/web-editor.md)
* [WebIDE](docs/user/projects//webide.md) * [WebIDE](docs/user/project//webide.md)
* [项目设置](docs/user/projects/settings.md) * [项目设置](docs/user/project/settings.md)
* [与群组共享项目](docs/user/projects/member/share.md) * [与群组共享项目](docs/user/project/member/share.md)
* [wiki](docs/user/projects/wiki.md) * [wiki](docs/user/project/wiki.md)
* [Issues](docs/user/projects/issues.md) * [Issues](docs/user/project/issues.md)
* [机密Issue](docs/user/projects/issues/confidential.md) * [机密Issue](docs/user/project/issues/confidential.md)
* [关联Issue](docs/user/projects/issues/crosslinking.md) * [关联Issue](docs/user/project/issues/crosslinking.md)
* [截止日期](docs/user/projects/issues/due-date.md) * [截止日期](docs/user/project/issues/due-date.md)
* [看板](docs/user/projects/kanban.md) * [看板](docs/user/project/kanban.md)
* [Issue操作](docs/user/projects/issues/actions.md) * [Issue操作](docs/user/project/issues/actions.md)
* [标签](docs/user/projects/label.md) * [标签](docs/user/project/label.md)
* [管理Issue](docs/user/projects/issues/manage.md) * [管理Issue](docs/user/project/issues/manage.md)
* [里程碑](docs/user/projects/milestone.md) * [里程碑](docs/user/project/milestone.md)
* [服务台](docs/user/projects/serve-desk.md) * [服务台](docs/user/project/serve-desk.md)
* [Issue排序](docs/user/projects/issues/sort.md) * [Issue排序](docs/user/project/issues/sort.md)
* [用户](docs/user.md) * [用户](docs/user.md)
* [举报用户](docs/user/abuse.md) * [举报用户](docs/user/abuse.md)
* [用户账号](docs/user/account.md) * [用户账号](docs/user/account.md)
...@@ -65,12 +65,11 @@ ...@@ -65,12 +65,11 @@
* [快捷键](docs/user/shortcutkey.md) * [快捷键](docs/user/shortcutkey.md)
* [Markdown](docs/user/markdown.md) * [Markdown](docs/user/markdown.md)
* [电子邮件通知](docs/user/account/email-notify.md) * [电子邮件通知](docs/user/account/email-notify.md)
* [快速操作](docs/user/projects/quick-actions.md) * [快速操作](docs/user/project/quick-actions.md)
* [自动填充](docs/user/projects/autofill.md) * [自动填充](docs/user/project/autofill.md)
* [预留命名空间](docs/user/reserved.md) * [预留命名空间](docs/user/reserved.md)
* [搜索](docs/user/search.md) * [搜索](docs/user/search.md)
* [高级全局搜索](docs/user/search/global.md) * [高级全局搜索](docs/user/search/global.md)
* [高级语法搜索](docs/user/search/syntax.md) * [高级语法搜索](docs/user/search/syntax.md)
* [时间跟踪](docs/user/projects/time-track.md) * [时间跟踪](docs/user/project/time-track.md)
* [待办事项](docs/user/todo.md) * [待办事项](docs/user/todo.md)
\ No newline at end of file
此差异已折叠。
无法预览此类型文件
# 用户文档[](#用户文档 "Permalink") # 用户文档[](#user "Permalink")
欢迎来到 GitLab! 我们很高兴您在这里 欢迎您开始使用CODEChina作为您的项目/开源项目代码托管平台
作为 GitLab 用户,您将有权访问您的[订阅](https://about.gitlab.com/pricing/)包括的所有功能,但[GitLab 管理员](../administration/index.html)设置除外,除非您具有安装,配置和升级 GitLab 实例的管理员权限. CODEChina 是一个基于 Git 的平台,它集成了许多用于软件开发和部署以及项目管理的基本工具:
[GitLab.com 的](https://gitlab.com/)管理员特权仅限于 GitLab 团队. * 通过版本控制在代码仓库中托管代码
* 使用功能齐全的[Issues](/project/issues#issues-list)跟踪有关新功能开发、错误报告及反馈的建议
* 组织和管理Issue(/project/issues#issue-boards)优先次序
* 使用Review Apps查看[合并请求](/project/merge_requests)中每个分支中更改的代码并实时预览
* 使用内置的CI/CD构建,测试和部署
* 使用Pages部署个人/专业静态网站
* 通过使用容器注册表与 Docker 集成
* 通过使用价值流分析跟踪开发生命周期
* 提供[服务台](/project/service_desk)支持
有关配置 GitLab 自管理实例的更多信息,请参阅[管理员文档](../administration/index.html) . ## 项目[](#project "Permalink")
## Overview[](#overview "Permalink") 您可以创建[项目](project)来托管代码,跟踪问题,在代码上进行协作。或者,您可以在一个项目中完成下列所有操作:
GitLab 是一个完全集成的软件开发平台,使您的团队能够在同一平台上保持透明,快速,有效和凝聚力,从讨论新想法到正式生产. * [代码仓库](/project/repo.md) :将[代码库](/project/repo)托管在具有版本控制的存储库中,并作为完全集成平台的一部分
* [Issues](/project/issues) :探索 Issue
* [合并请求](/project/merge_requests) :在代码,评论,每个分支的实时预览更改方面进行协作,并通过合并请求来批准请求
* [里程碑](/project/milestone) :在设置的里程碑日期前处理多个Issue及合并请求
有关更多信息,请参见[所有 GitLab 功能](https://about.gitlab.com/features/) . ## 账号[](#account "Permalink")
### Concepts[](#concepts "Permalink") 您可以自定义和配置以下内容:
要熟悉在 GitLab 上开发代码所需的概念,请阅读以下文章: * [设置](/account) :管理用户设置以更改您的个人信息,个人访问令牌,授权的应用程序等
* [权限](/permissions) :了解每种用户类型(访客,记者,开发人员,维护人员,所有者)的不同权限级别集
* [abuse](/abuse) :向我们的审核人员举报用户的滥用或违规情况
* [Demo: Mastering Code Review With GitLab](https://about.gitlab.com/blog/2017/03/17/demo-mastering-code-review-with-gitlab/). ## 组织[](#organization "Permalink")
* [GitLab Workflow: An Overview](https://about.gitlab.com/blog/2016/10/25/gitlab-workflow-an-overview/#gitlab-workflow-use-case-scenario).
* [教程:在 GitLab 中都已连接](https://about.gitlab.com/blog/2016/03/08/gitlab-tutorial-its-all-connected/) :与 GitLab 进行代码协作的概述.
* [Trends in Version Control Land: Microservices](https://about.gitlab.com/blog/2016/08/16/trends-in-version-control-land-microservices/).
* [Trends in Version Control Land: Innersourcing](https://about.gitlab.com/blog/2016/07/07/trends-version-control-innersourcing/).
## Use cases[](#use-cases "Permalink") 通过建立[组织](/org)您可以将相关项目组合在一起,并授予成员一次访问多个项目的权限。
GitLab 是一个基于 Git 的平台,它集成了许多用于软件开发和部署以及项目管理的基本工具: 您也可以在组织中嵌套[子组织](/org/sub_org)
* 通过版本控制在存储库中托管代码. ## 探讨[](#discussions "Permalink")
* 使用功能齐全的[问题跟踪器](project/issues/index.html#issues-list)跟踪有关新实现,错误报告和反馈的建议.
* 组织和[发行委员会的](project/issues/index.html#issue-boards)优先次序.
* 使用[Review Apps](../ci/review_apps/index.html)查看[合并请求中](project/merge_requests/index.html)每个分支的实时预览更改中的代码.
* 使用内置的[持续集成进行](../ci/README.html)构建,测试和部署.
* 使用[GitLab Pages](project/pages/index.html)部署个人和专业静态网站.
* 通过使用[GitLab 容器注册表](packages/container_registry/index.html)与 Docker 集成.
* 通过使用[GitLab 价值流分析](project/cycle_analytics.html)跟踪开发生命周期.
* 提供[服务台](project/service_desk.html)支持.
使用 GitLab 企业版,您还可以: 您可以在 Issue、合并请求、及提交中添加注释、评论并@相关人员,点击[了解更多](/discussions)
* 通过以下方式改善协作: ### Markdown[](#markdown "Permalink")
* [合并请求批准](project/merge_requests/merge_request_approvals.html) .
* [问题的多个受让人](project/issues/multiple_assignees_for_issues.html) .
* [多个发行委员会](project/issue_board.html#multiple-issue-boards) .
*[相关问题](project/issues/related_issues.html)之间创建正式关系.
* 使用[Burndown Charts](project/milestones/burndown_charts.html)可以在冲刺期间或在使用其新版本软件时跟踪进度.
* 利用[Elasticsearch](../integration/elasticsearch.html)[Advanced Global Search](search/advanced_global_search.html)[Advanced Syntax Search](search/advanced_search_syntax.html)在整个 GitLab 实例上进行更快,更高级的代码搜索.
* [Authenticate users with Kerberos](../integration/kerberos.html).
* 从本地服务器上的其他地方[镜像存储库](project/repository/repository_mirroring.html) .
* [Export issues as CSV](project/issues/csv_export.html).
* 使用[Multiple-Project Pipelines](../ci/multi_project_pipeline_graphs.html)查看涉及多个项目的整个 CI / CD [管道](../ci/multi_project_pipeline_graphs.html) .
* [锁定文件](project/file_lock.html)以防止冲突.
* 使用[Deploy Boards](project/deploy_boards.html)查看在 Kubernetes 上运行的每个 CI 环境的当前运行状况和状态.
* 利用[Canary 部署的](project/canary_deployments.html)连续交付方法.
* 扫描您的代码中的漏洞, [并在合并请求中显示它们](application_security/sast/index.html) .
还可以[](project/integrations/overview.html) GitLab 与众多第三方应用程序[集成](project/integrations/overview.html) ,例如 Mattermost,Microsoft Teams,HipChat,Trello,Slack,Bamboo CI,Jira 等. 可以在[markdown](markdown.html)中了解如何在主题、注释、Issue 及合并请求以及所有支持markdonw的其他地方来使用markdown填写你的内容。
## Projects[](#projects "Permalink") ## 待办事项[](#todo "Permalink")
在 GitLab 中,您可以创建[项目](project/index.html)来托管代码,跟踪问题,在代码上进行协作以及使用内置的 GitLab CI / CD 持续构建,测试和部署应用程序. 或者,您可以从一个项目中一次完成所有操作. [代办事项](/todo)可以让你与组织成员更快速、高效地进行写作,它会将所有用户或组织 @你的内容,也包括你被指派的 Issue 及合并请求,让你不会遗漏任何一个协助者的回复。
* [存储库](project/repository/index.html) :将代码[](project/repository/index.html)托管在具有版本控制的存储库中,并作为完全集成平台的一部分. ## 搜索[](#search "Permalink")
* [问题](project/issues/index.html) :探索 GitLab 问题的最佳功能.
* [合并请求](project/merge_requests/index.html) :在代码,评论,每个分支的实时预览更改方面进行协作,并通过合并请求请求批准.
* [里程碑](project/milestones/index.html) :处理多个问题,并与里程碑在同一目标日期合并请求.
## GitLab CI/CD[](#gitlab-cicd "Permalink") [搜索和筛选](/search)组织、项目、Issue、合并请求、文件以及代码等内容。
使用内置的[GitLab CI / CD](../ci/README.html)直接从 GitLab 测试,构建和部署应用程序. 无需第三方集成. ## 快捷键[](#shortcutkey "Permalink")
* [GitLab Auto Deploy](../topics/autodevops/stages.html#auto-deploy) :通过 GitLab Auto Deploy 开箱即用地部署您的应用程序. CODEChina中支持许多[快捷键](/shortcutkey) ,帮助您更方便的在页面之间进行切换、更快地完成任务。
* [Review Apps](../ci/review_apps/index.html) :实时预览带有 Review Apps 的合并请求所引入的更改.
* [GitLab 页面](project/pages/index.html) :使用 GitLab 页面直接从 GitLab 发布您的静态站点. 您可以使用 Pages 构建,测试和部署任何静态站点生成器.
* [GitLab Container Registry](packages/container_registry/index.html) :使用 Container Registry 构建和部署 Docker 映像.
## Account[](#account "Permalink")
您可以自定义和配置很多东西,以享受 GitLab 的最佳体验.
* [设置](profile/index.html) :管理用户设置以更改您的个人信息,个人访问令牌,授权的应用程序等.
* [身份验证](../topics/authentication/index.html) :通读 GitLab 中可用的身份验证方法.
* [权限](permissions.html) :了解每种用户类型(访客,记者,开发人员,维护人员,所有者)的不同权限级别集.
* [功能亮点](feature_highlight.html) :了解有关应用周围的小蓝点的更多信息,这些小点可以解释某些功能.
* [滥用报告](abuse_reports.html) :向 GitLab 管理员报告用户的[滥用情况](abuse_reports.html) .
## Groups[](#groups "Permalink")
使用 GitLab [组,](group/index.html)您可以将相关项目组合在一起,并授予成员一次访问多个项目的权限.
组也可以嵌套在[子组中](group/subgroups/index.html) .
## Discussions[](#discussions "Permalink")
在 GitLab 中,您可以在问题,合并请求,代码段和提交中注释和提及合作者.
通过合并请求对代码库的实现执行内联检查时,可以通过[可解析的线程](discussions/index.html#resolvable-comments-and-threads)收集反馈.
### GitLab Flavored Markdown (GFM)[](#gitlab-flavored-markdown-gfm "Permalink")
通读[GFM 文档,](markdown.html)以了解如何在线程,注释,问题和合并请求描述以及所有支持 GFM 的其他地方应用最好的 GitLab 风味 Markdown.
## Todos[](#todos "Permalink")
Never forget to reply to your collaborators. [GitLab Todos](todos.html) are a tool for working faster and more effectively with your team, by listing all user or group mentions, as well as issues and merge requests you’re assigned to.
## Search[](#search "Permalink")
[搜索和筛选](search/index.html)组,项目,问题,合并请求,文件,代码等.
## Snippets[](#snippets "Permalink")
[片段](snippets.html)是您要存储在 GitLab 中的代码块,您可以从中快速访问它们. 您还可以通过" [讨论"](#discussions)收集有关它们的反馈.
## Keyboard shortcuts[](#keyboard-shortcuts "Permalink")
GitLab 中有许多[键盘快捷键](shortcuts.html) ,可帮助您在页面之间导航并更快地完成任务.
## Integrations[](#integrations "Permalink")
[将 GitLab](../integration/README.html)与您喜欢的工具(例如 Trello,Jira 等) [集成](../integration/README.html) .
## Webhooks[](#webhooks "Permalink") ## Webhooks[](#webhooks "Permalink")
配置[webhook](project/integrations/webhooks.html)以侦听特定事件,例如推送,问题或合并请求. GitLab 会将带有数据的 POST 请求发送到 webhook URL. 配置webhook]以侦听特定事件,例如推送,问题或合并请求。CODEChina会将相关数据通过 POST 请求发送到 webhook 中配置的 URL 中。
\ No newline at end of file
## API[](#api "Permalink")
通过[API](../api/README.html)自动化 GitLab.
## Git and GitLab[](#git-and-gitlab "Permalink")
了解什么是[Git](../topics/git/index.html)及其最佳实践.
## Instance statistics[](#instance-statistics "Permalink")
查看您的 GitLab 实例的[各种统计信息](instance_statistics/index.html) .
## Operations Dashboard[](#operations-dashboard-premium "Permalink")
See [Operations Dashboard](operations_dashboard/index.html) for a summary of each project’s operational health.
\ No newline at end of file
# 电子邮件通知 # 电子邮件通知[](#电子邮件通知 "Permalink")
GitLab 通知使您可以随时了解 GitLab 中发生的事情. 启用通知后,您可以接收有关问题,合并请求和史诗活动的更新. 通知通过电子邮件发送.
## Receiving notifications[](#receiving-notifications "Permalink")
您将由于以下原因之一收到通知:
* 您参与发行,合并请求或史诗. 在这种情况下, *参与*意味着评论或编辑.
* You enable notifications in an issue, merge request, or epic. To enable notifications, click the **Notifications** toggle in the sidebar to *on*.
启用通知后,您将收到有关该问题,合并请求或史诗中发生的操作的通知.
**注意:**通知可能会被管理员阻止,从而阻止发送通知.
## Tuning your notifications[](#tuning-your-notifications "Permalink")
通知的数量可能是巨大的. GitLab 允许您调整收到的通知. 例如,您可能希望收到有关特定项目中所有活动的通知,而对于其他项目,仅当您的名字被提及时才得到通知.
您可以通过组合通知设置来调整收到的通知:
* [Global notification settings](#global-notification-settings)
* [Notification scope](#notification-scope)
* [Notification levels](#notification-levels)
### Editing notification settings[](#editing-notification-settings "Permalink")
编辑通知设置:
1. 点击您的个人资料图片,然后选择**设置** .
2. 点击左侧边栏中的**通知** .
3. 编辑所需的通知设置. 编辑的设置将自动保存并启用.
这些通知设置仅适用于您. 它们不会影响同一项目或组中其他任何人收到的通知.
[![notification settings](img/81fe297de1dccaedd3340735454273bc.png)](img/notification_global_settings.png)
## Global notification settings[](#global-notification-settings "Permalink")
**全局通知设置**是默认设置,除非您为项目或组选择不同的值.
* 通知电子邮件
* 这是您的通知将发送到的电子邮件地址.
* 全局通知级别
* 这是适用于所有通知的默认[通知级别](#notification-levels) .
* 接收有关您自己的活动的通知.
* 如果您想接收有关自己活动的通知,请选中此复选框. 默认值:未选中.
### Notification scope[](#notification-scope "Permalink")
您可以通过为每个项目和组选择不同的通知级别来调整通知的范围.
通知范围按优先级顺序应用(从高到低):
* Project
* 对于每个项目,您可以选择一个通知级别. 您的项目设置将覆盖组设置.
* Group
* 对于每个组,您可以选择一个通知级别. 您的群组设置会覆盖您的默认设置.
* 全局(默认)
* 如果尚未为发生活动的项目或组选择通知级别,则将应用全局或*默认*通知级别.
#### Project notifications[](#project-notifications "Permalink")
您可以为每个项目选择一个通知级别. 如果您需要密切监视选定项目中的活动,这将很有用.
[![notification settings](img/bab81ba0a915cec8b039166d2defc074.png)](img/notification_project_settings_v12_8.png)
要为项目选择通知级别,请使用以下两种方法之一:
1. 点击您的个人资料图片,然后选择**设置** .
2. 点击左侧边栏中的**通知** .
3. 在" **项目"**部分中找到该项目.
4. 选择所需的[通知级别](#notification-levels) .
Or:
1. 导航到项目页面.
2. 单击带有下拉图标的通知下拉列表.
3. 选择所需的[通知级别](#notification-levels) .
有关如何在有新版本发布时通知的演示,请参阅[发布通知](https://www.youtube.com/watch?v=qyeNkGgqmH4) .
#### Group notifications[](#group-notifications "Permalink")
您可以为每个组选择通知级别和电子邮件地址.
[![notification settings](img/c39dc466882289b42ad827dbbc05b39f.png)](img/notification_group_settings_v12_8.png)
##### Group notification level[](#group-notification-level "Permalink")
要为组选择通知级别,请使用以下两种方法之一:
1. 点击您的个人资料图片,然后选择**设置** .
2. 点击左侧边栏中的**通知** .
3. 在" **组"**部分中找到该项目.
4. 选择所需的[通知级别](#notification-levels) .
* * *
1. 导航到组的页面.
2. 单击带有下拉图标的通知下拉列表.
3. 选择所需的[通知级别](#notification-levels) .
##### Group notification email address[](#group-notification-email-address "Permalink")
在 GitLab 12.0 中引入
您可以选择一个电子邮件地址,以接收您所属的每个组的通知. 例如,如果您是自由职业者,并且希望将有关客户项目的电子邮件分开存放,这可能会很有用.
1. 点击您的个人资料图片,然后选择**设置** .
2. 点击左侧边栏中的**通知** .
3. 在" **组"**部分中找到该项目.
4. 选择所需的电子邮件地址.
### Notification levels[](#notification-levels "Permalink")
对于每个项目和组,您可以选择以下级别之一:
| Level | Description |
| --- | --- |
| Global | 您的全局设置适用. |
| Watch | 接收任何活动的通知. |
| 提一下 | `@mentioned`在评论中`@mentioned`接收通知. |
| Participate | 接收有关您参与的线程的通知. |
| Disabled | 关闭通知. |
| Custom | 接收有关自定义选定事件的通知. |
## Notification events[](#notification-events "Permalink")
将通知用户以下事件:
| Event | 发给 | 设定等级 |
| --- | --- | --- |
| 添加了新的 SSH 密钥 | User | 安全电子邮件,始终发送. |
| 添加了新电子邮件 | User | 安全电子邮件,始终发送. |
| 电邮已变更 | User | 安全电子邮件,始终发送. |
| 密码已更改 | User | 安全电子邮件,始终发送. |
| 新用户创建 | User | 在创建用户时发送,但 OmniAuth(LDAP)除外 |
| 用户已添加到项目 | User | 将用户添加到项目时发送 |
| 项目访问权限级别已更改 | User | 更改用户项目访问级别时发送 |
| 用户已添加到组 | User | 将用户添加到组时发送 |
| 群组访问权限级别已更改 | User | 更改用户组访问级别时发送 |
| 项目已移 | 项目成员(1) | (1)不禁用 |
| 新品发布 | 项目成员 | 自定义通知 |
## Issue / Epics / Merge request events[](#issue--epics--merge-request-events "Permalink")
在以下大多数情况下,通知将发送到:
* Participants:
* 发行/合并请求的作者和受让人
* 关于问题/合并请求的评论的作者
* `@username`在问题,合并请求或史诗的标题或描述中提到的任何人
* `@username`在有关问题,合并请求或史诗的任何评论中提及的"参与"或更高通知级别的任何人
* 观察者:通知级别为"观察"的用户
* 订阅者:手动订阅问题,合并请求或史诗的任何人
* 自定义:通知级别为"自定义"的用户针对下表中显示的任何事件打开了通知
**注意:**为了最大程度地减少不需要任何操作的通知的数量,从[GitLab 12.9 起](https://gitlab.com/gitlab-org/gitlab/-/issues/616) ,不再为项目中的所有活动通知合格的批准者. 要接收它们,他们必须将其用户通知设置更改为" **观看"** .
| Event | 发给 |
| --- | --- |
| 新问题 |   |
| 结束期 |   |
| 重新分配问题 | 以上,加上旧的受让人 |
| 重新打开问题 |   |
| 到期问题 | 选择此事件的参与者和自定义通知级别 |
| 更改里程碑问题 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
| 消除里程碑问题 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
| 新合并请求 |   |
| 推送合并请求 | 选择此事件的参与者和自定义通知级别 |
| 重新分配合并请求 | 以上,加上旧的受让人 |
| 关闭合并请求 |   |
| 重新打开合并请求 |   |
| 合并合并请求 |   |
| 更改里程碑合并请求 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
| 删除里程碑合并请求 | 选择了此事件的订户,提及的参与者和自定义通知级别 |
| 新评论 | 以上内容,加上评论中`@username`提及的任何人,通知级别为"提及"或更高 |
| 管道失败 | 管道的作者 |
| 固定管道 | 管道的作者. 默认启用. 在 GitLab 13.1 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/24309) . 管理员可以使用`ci_pipeline_fixed_notifications` [功能标记](../../administration/feature_flags.html)禁用此通知选项. |
| 成功的管道 | 管道的作者(如果他们具有成功管道的自定义通知设置). 如果管道先前失败,则将为失败后的第一个成功管道发送`Fixed pipeline`消息,然后为任何进一步成功的管道发送`Successful pipeline`消息. |
| 新史诗 |   |
| 接近史诗 |   |
| 重新开启史诗 |   |
此外,如果发布或合并请求的标题或描述发生了更改,则通知将通过`@username`发送到任何**新**提及的内容,就像在原始文本中提到的一样.
您不会收到有关您自己创建的问题,合并请求或里程碑的通知(除非由于问题而定). 仅当其他人对您创建或提及的内容进行评论或添加更改时,您才会收到自动通知.
如果开放的合并请求由于冲突而变得不可合并,则将通知其原因. 如果用户还将合并请求设置为一旦管道成功就自动合并,则该用户也会收到通知.
## Filtering email[](#filtering-email "Permalink")
通知电子邮件包括特定于 GitLab 的标题. 您可以根据这些标头的内容过滤通知电子邮件,以更好地管理您的通知. 例如,您可以过滤特定项目的所有电子邮件,在该项目中您将被分配合并请求或问题.
下表列出了所有特定于 GitLab 的电子邮件标题:
| Header | Description |
| --- | --- |
| `X-GitLab-Group-Id` | 组的 ID. 仅在史诗的通知电子邮件中显示. |
| `X-GitLab-Group-Path` | 组的路径. 仅在史诗的通知电子邮件中显示. |
| `X-GitLab-Project` | 通知所属的项目的名称. |
| `X-GitLab-Project-Id` | 项目的 ID. |
| `X-GitLab-Project-Path` | 项目的路径. |
| `X-GitLab-(Resource)-ID` | 通知所针对的资源的 ID. 该资源例如可以是`Issue``MergeRequest``Commit`或其他此类资源. |
| `X-GitLab-Discussion-ID` | 注释所属的线程的 ID,用于注释的通知电子邮件中. |
| `X-GitLab-Pipeline-Id` | 通知所针对的管道的 ID,在管道的通知电子邮件中. |
| `X-GitLab-Reply-Key` | 支持通过电子邮件回复的唯一令牌. |
| `X-GitLab-NotificationReason` | 通知原因. 可以`mentioned``assigned``own_activity` . |
| `List-Id` | The path of the project in an RFC 2919 mailing list identifier. This is useful for email organization with filters, for example. |
### X-GitLab-NotificationReason[](#x-gitlab-notificationreason "Permalink")
`X-GitLab-NotificationReason`标头包含`X-GitLab-NotificationReason`的原因. 该值是按优先级顺序的以下值之一:
* `own_activity`
* `assigned`
* `mentioned`
通知的原因也包含在通知电子邮件的页脚中. 例如有原因的电子邮件`assigned`都会有这句话的注脚:
* `You are receiving this email because you have been assigned an item on <configured GitLab hostname>.`
**注意:**正在考虑将其他事件的通知包含在`X-GitLab-NotificationReason`标头中. 有关详细信息,请参见此[相关问题](https://gitlab.com/gitlab-org/gitlab/-/issues/20689) .
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册