Skip to content

帮助文档
帮助文档

GitCode / 帮助文档

通知 1778
Star 578
Fork 457
帮助文档
帮助文档
提交 53d02cd2 编写于 作者: Lab机器人's avatar Lab机器人
浏览文件
操作

issue_actions

上级 b86874ee
展开全部 显示空白变更内容
内联 并排
Showing with 123 addition and 280 deletion
SUMMARY.md
浏览文件 @ 53d02cd2
......@@ -47,7 +47,7 @@
* [关联Issue](docs/user/project/issues/crosslinking.md)
* [截止日期](docs/user/project/issues/due-date.md)
* [看板](docs/user/project/kanban.md)
* [Issue操作](docs/user/project/issues/actions.md)
* [操作Issue](docs/user/project/issues/actions.md)
* [标签](docs/user/project/label.md)
* [管理Issue](docs/user/project/issues/manage.md)
* [里程碑](docs/user/project/milestone.md)
......
_book/index.html
浏览文件 @ 53d02cd2
......@@ -12,7 +12,6 @@
<link rel="stylesheet" href="gitbook/style.css">
......@@ -34,14 +33,6 @@
<link rel="stylesheet" href="gitbook/gitbook-plugin-mermaid-gb3/mermaid/mermaid.css">
<link rel="stylesheet" href="gitbook/gitbook-plugin-advanced-emoji/emoji-website.css">
<link rel="stylesheet" href="gitbook/gitbook-plugin-highlight/website.css">
......@@ -71,9 +62,6 @@
......@@ -798,7 +786,7 @@
<a href="docs/user/project/issues/actions.html">
Issue操作
操作Issue
</a>
......@@ -1270,13 +1258,12 @@
<script>
var gitbook = gitbook || [];
gitbook.push(function() {
gitbook.page.hasChanged({"page":{"title":"首页","level":"1.1","depth":1,"next":{"title":"概览","level":"1.2","depth":1,"path":"docs/overview.md","ref":"docs/overview.md","articles":[]},"dir":"ltr"},"config":{"plugins":["favicon","back-to-top-button","popup","theme-fexa","-sharing","sharing-plus","tbfed-pagefooter","chapter-fold","-lunr","-search","search-pro","mermaid-gb3","advanced-emoji","livereload"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"tbfed-pagefooter":{"copyright":"Copyright &copy CODECHINA 2020","modify_label":"该文件修订时间：","modify_format":"YYYY-MM-DD HH:mm:ss"},"chapter-fold":{},"livereload":{},"search-pro":{},"sharing-plus":{"qq":false,"all":["facebook","google","twitter","instapaper","linkedin","pocket","stumbleupon"],"douban":false,"facebook":true,"weibo":false,"instapaper":false,"whatsapp":false,"hatenaBookmark":false,"twitter":true,"messenger":false,"line":false,"vk":false,"pocket":true,"google":false,"viber":false,"stumbleupon":false,"qzone":false,"linkedin":false},"popup":{},"theme-fexa":{"search-placeholder":"输入关键字搜索","logo":"/docs/img/logo.png","favicon":"","url":"/"},"fontsettings":{"theme":"white","family":"sans","size":2},"highlight":{},"mermaid-gb3":{},"favicon":{"shortcut":"/docs/img/logo-s.png","bookmark":"/docs/img/logo-s.png","appleTouch":"/docs/img/logo-s.png","appleTouchMore":{"120x120":"","180x180":"/docs/img/logo-s.png"}},"back-to-top-button":{},"advanced-emoji":{"embedEmojis":false},"sharing":{"douban":true,"facebook":false,"google":false,"qq":true,"qzone":true,"twitter":false,"weibo":true,"all":["douban","facebook","google","instapaper","linkedin","twitter","weibo","messenger","qq","qzone","viber","whatsapp"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"Miykael","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{"themeFexa":{"nav":[{"url":"/","target":"_blank","name":"开始使用"}]}},"title":"CODEChina帮助文档","language":"zh-hans","links":{"sidebar":{}},"gitbook":"*","description":"CODEChina开源社区用户使用及帮助文档"},"file":{"path":"README.md","mtime":"2020-09-01T02:50:43.664Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2020-09-04T05:47:40.539Z"},"basePath":".","book":{"language":""}});
gitbook.page.hasChanged({"page":{"title":"首页","level":"1.1","depth":1,"next":{"title":"概览","level":"1.2","depth":1,"path":"docs/overview.md","ref":"docs/overview.md","articles":[]},"dir":"ltr"},"config":{"plugins":["favicon","back-to-top-button","popup","theme-fexa","-sharing","sharing-plus","tbfed-pagefooter","chapter-fold","-lunr","-search","search-pro","livereload"],"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"pluginsConfig":{"tbfed-pagefooter":{"copyright":"Copyright &copy CODECHINA 2020","modify_label":"该文件修订时间：","modify_format":"YYYY-MM-DD HH:mm:ss"},"chapter-fold":{},"livereload":{},"search-pro":{},"sharing-plus":{"qq":false,"all":["facebook","google","twitter","instapaper","linkedin","pocket","stumbleupon"],"douban":false,"facebook":true,"weibo":false,"instapaper":false,"whatsapp":false,"hatenaBookmark":false,"twitter":true,"messenger":false,"line":false,"vk":false,"pocket":true,"google":false,"viber":false,"stumbleupon":false,"qzone":false,"linkedin":false},"popup":{},"theme-fexa":{"search-placeholder":"输入关键字搜索","logo":"/docs/img/logo.png","favicon":"","url":"/"},"fontsettings":{"theme":"white","family":"sans","size":2},"highlight":{},"favicon":{"shortcut":"/docs/img/logo-s.png","bookmark":"/docs/img/logo-s.png","appleTouch":"/docs/img/logo-s.png","appleTouchMore":{"120x120":"","180x180":"/docs/img/logo-s.png"}},"back-to-top-button":{},"sharing":{"douban":true,"facebook":false,"google":false,"qq":true,"qzone":true,"twitter":false,"weibo":true,"all":["douban","facebook","google","instapaper","linkedin","twitter","weibo","messenger","qq","qzone","viber","whatsapp"]},"theme-default":{"styles":{"website":"styles/website.css","pdf":"styles/pdf.css","epub":"styles/epub.css","mobi":"styles/mobi.css","ebook":"styles/ebook.css","print":"styles/print.css"},"showLevel":false}},"theme":"default","author":"Miykael","pdf":{"pageNumbers":true,"fontSize":12,"fontFamily":"Arial","paperSize":"a4","chapterMark":"pagebreak","pageBreaksBefore":"/","margin":{"right":62,"left":62,"top":56,"bottom":56}},"structure":{"langs":"LANGS.md","readme":"README.md","glossary":"GLOSSARY.md","summary":"SUMMARY.md"},"variables":{"themeFexa":{"nav":[{"url":"/","target":"_blank","name":"开始使用"}]}},"title":"CODEChina帮助文档","language":"zh-hans","links":{"sidebar":{}},"gitbook":"*","description":"CODEChina开源社区用户使用及帮助文档"},"file":{"path":"README.md","mtime":"2020-09-01T02:50:43.664Z","type":"markdown"},"gitbook":{"version":"3.2.2","time":"2020-09-04T09:55:19.962Z"},"basePath":".","book":{"language":""}});
});
</script>
</div>
<script src="gitbook/gitbook.js"></script>
<script src="gitbook/theme.js"></script>
......@@ -1301,10 +1288,6 @@
<script src="gitbook/gitbook-plugin-mermaid-gb3/book/plugin.js"></script>
<script src="gitbook/gitbook-plugin-livereload/plugin.js"></script>
......@@ -1317,8 +1300,6 @@
<script src="gitbook/gitbook-plugin-mermaid-gb3/mermaid/mermaid.min.js"></script>
</body>
</html>
book.json
浏览文件 @ 53d02cd2
......@@ -19,9 +19,7 @@
"chapter-fold",
"-lunr",
"-search",
"search-pro",
"mermaid-gb3",
"advanced-emoji"
"search-pro"
],
"variables": {
"themeFexa":{
......
docs/.DS_Store
浏览文件 @ 53d02cd2
无法预览此类型文件
docs/user/project/import/by-url.md
浏览文件 @ 53d02cd2
# 通过URL导入[](#通过URL导入 "Permalink")
您可以通过提供 Git URL 来导入现有存储库：
您可以通过提供 Git URL 来导入现有的代码仓库：
1. 在您的 GitLab 仪表板中，单击" **新建项目".**
1. 在您的仪表板中，单击" **新建项目"**
2. 切换到**导入项目**选项卡
3. 点击**按 URL 回购**按钮
4. 填写" Git 存储库 URL"和其余项目字段
3. 点击**按 URL Repo**按钮
4. 填写" Git 代码仓库 URL"和其余项目字段
5. 单击**创建项目**开始导入过程
6. 完成后，您将被重定向到新创建的项目
[![Import project by repo URL](img/731943edb4428a3eb27c86d8d454d0e0.png)](img/import_projects_from_repo_url.png)
\ No newline at end of file
[![Import project by repo URL](img/import_projects_from_repo_url.png)](img/import_projects_from_repo_url.png)
\ No newline at end of file
docs/user/project/import/github.md
浏览文件 @ 53d02cd2
# 从Github导入[](#从Github导入 "Permalink")
使用导入器，您可以将 GitHub 存储库导入 GitLab.com 或自管理的 GitLab 实例.
使用导入器，您可以将 GitHub 代码仓库导入 CODEChina。
## Overview[](#overview "Permalink")
**注意：**这些说明适用于 GitLab.com 上的用户，但是如果您是自助 GitLab 实例的管理员，或者要从 GitHub Enterprise 导入，则必须启用[GitHub 集成](../../../integration/github.html) . GitHub 集成是从 GitHub Enterprise 导入的唯一方法. 如果您使用的是 GitLab.com，则可以使用[个人访问令牌](#using-a-github-token)导入 GitHub 存储库，但不建议使用此方法，因为该方法无法将所有用户活动（例如问题和请求请求）与匹配的 GitLab 用户相关联. 如果您是自我管理的 GitLab 实例的管理员，则还可以使用[GitHub Rake 任务](../../../administration/raketasks/github_import.html)从 GitHub 导入项目，而不受 Sidekiq worker 的限制.
## 概览[](#overview "Permalink")
导入了项目的以下方面：
* 仓库描述（GitLab.com＆7.7+）
* Git 存储库数据（GitLab.com＆7.7+）
* 问题（GitLab.com 和 7.7+）
* 拉取请求（GitLab.com＆8.4+）
* Wiki 页面（GitLab.com＆8.4+）
* 里程碑（GitLab.com＆8.7+）
* 标签（GitLab.com 和 8.7+）
* 发行说明说明（GitLab.com 和 8.12+）
* 拉取请求评论评论（GitLab.com＆10.2+）
* 定期发布和请求请求注释
保留对拉取请求和问题的引用（GitLab.com＆8.7+），并且每个导入的存储库都保持可见性级别，除非该[可见性级别受到限制](../../../public_access/public_access.html#restricting-the-use-of-public-or-internal-projects) ，在这种情况下，它默认为默认项目可见性.
## How it works[](#how-it-works "Permalink")
导入问题和请求请求时，导入程序会尝试在 GitLab 实例的数据库中查找其 GitHub 作者和受让人（请注意，请求请求在 GitLab 中称为"合并请求"）.
For this association to succeed, each GitHub author and assignee in the repository must meet one of the following conditions prior to the import:
* 以前使用 GitHub 图标登录到 GitLab 帐户.
* 有一个 GitHub 帐户，其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 GitLab 帐户的电子邮件地址匹配.
如果在 GitLab 的数据库中未找到项目中引用的用户，则将项目创建者（通常是启动导入过程的用户）设置为作者/受让人，但是会添加关于该问题的注释，其中提及原始 GitHub 作者.
如果不存在任何新的名称空间（组），或者如果采用了名称空间，则导入器会创建存储库，该存储库将在启动导入过程的用户的名称空间下导入. 命名空间/存储库名称也可以使用适当的权限进行编辑.
进口商还将在与未完成拉取请求相关的项目的分支上导入分支. 这些分支将以类似于`GH-SHA-username/pull-request-number/fork-name/branch`的命名方案导入. 与 GitHub 存储库相比，这可能导致分支中的差异.
有关更多技术细节，您可以参考[GitHub Importer](../../../development/github_importer.html "使用 GitHub 导入器")开发人员文档.
有关导入过程的概述，请参阅[从 GitHub 迁移到 GitLab](https://youtu.be/VYOXuOg9tQI)的视频.
## Import your GitHub repository into GitLab[](#import-your-github-repository-into-gitlab "Permalink")
### Using the GitHub integration[](#using-the-github-integration "Permalink")
在开始之前，请确保要映射到 GitLab 用户的所有 GitHub 用户都具有以下任一条件：
* 使用 GitHub 图标登录的 GitLab 帐户-或-
* 一个 GitLab 帐户，其电子邮件地址与 GitHub 用户的[公共电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)匹配
用户匹配尝试将按该顺序进行，并且如果两种方法均未识别到用户，则该活动将与执行导入的用户帐户相关联.
**注意：**如果您使用的是自助式 GitLab 实例，或者要从 GitHub Enterprise 导入，则此过程要求您已配置[GitHub 集成](../../../integration/github.html) .
1. 在顶部导航栏中，单击**+** ，然后选择**新建项目** .
2. 选择**导入项目**选项卡，然后选择**GitHub** .
3. 选择第一个按钮以**列出您的 GitHub 存储库** . 您将被重定向到[GitHub 上](https://github.com)的页面以授权 GitLab 应用程序.
4. 点击**授权 gitlabhq** . 您将被重定向回 GitLab 的 Import 页面，并列出所有 GitHub 存储库.
5. 继续[选择要导入的存储库](#selecting-which-repositories-to-import) .
### Using a GitHub token[](#using-a-github-token "Permalink")
**注意：**不建议使用个人访问令牌导入项目. 如果您是 GitLab.com 用户，则可以使用个人访问令牌从 GitHub 导入项目，但是该方法无法将所有用户活动（例如问题和请求请求）与匹配的 GitLab 用户关联. 如果您是自我管理的 GitLab 实例的管理员，或者要从 GitHub Enterprise 导入，则不能使用个人访问令牌. 建议所有用户使用[GitHub 集成方法（上述）](#using-the-github-integration) . 在" [如何工作"](#how-it-works)部分中了解更多信息.
如果您不使用 GitHub 集成，则仍可以通过 GitHub 执行授权以授予 GitLab 访问您的存储库的权限：
1. 转到[https://github.com/settings/tokens/new](https://github.com/settings/tokens/new)
2. 输入令牌描述.
3. 选择回购范围​​.
4. Click **生成令牌**.
5. 复制令牌哈希.
6. 返回到 GitLab 并将令牌提供给 GitHub 导入器.
7. 点击**列出您的 GitHub 存储库**按钮，并等待 GitLab 读取您的存储库信息. 完成后，将带您到导入器页面以选择要导入的存储库.
### Selecting which repositories to import[](#selecting-which-repositories-to-import "Permalink")
在授权访问 GitHub 存储库后，您将重定向到 GitHub 导入程序页面，并列出 GitHub 存储库.
1. 默认情况下，建议的存储库名称空间与 GitHub 中存在的名称匹配，但是根据您的权限，您可以选择在继续导入任何名称之前编辑这些名称.
2. 选择任意数量的存储库旁边的**导入**按钮，或选择**导入所有存储库** . 此外，您可以按名称过滤项目. 如果应用了过滤器，则" **导入所有存储库"**仅导入匹配的存储库.
3. " **状态"**列显示每个存储库的导入状态. 您可以选择让页面保持打开状态，它将实时更新，也可以稍后返回.
4. 导入存储库后，单击其 GitLab 路径以打开其 GitLab URL.
[![Github importer page](img/67f7d8117f3d6bf60fe4d5e03bca7b6e.png)](img/import_projects_from_github_importer_v12_3.png)
## Mirroring and pipeline status sharing[](#mirroring-and-pipeline-status-sharing "Permalink")
根据您的 GitLab 层，可以设置[项目镜像](../repository/repository_mirroring.html) ，以使导入的项目与其 GitHub 副本保持同步.
* 仓库描述
* Git 存储库数据
* Issue
* 拉取请求
* Wiki
* 里程碑
* 标签
* Release
* 拉取请求评论
* 定期发布和请求注释
此外，您可以配置 GitLab 以通过[GitHub Project Integration](../integrations/github.html)将管道状态更新发送回 GitHub.
保留对拉取请求和问题的引用，并且每个导入的存储库都保持可见性级别，除非该[可见性级别受到限制](../../../public_access/public_access.html#restricting-the-use-of-public-or-internal-projects) ，在这种情况下，它默认为默认项目可见性。
如果使用[CI / CD 作为外部存储库](../../../ci/ci_cd_for_external_repos/index.html)导入项目，则会自动配置以上两项.
## 实现原理[](#how-it-works "Permalink")
## Improving the speed of imports on self-managed instances[](#improving-the-speed-of-imports-on-self-managed-instances "Permalink")
导入 Issue 和拉取请求时，导入程序会尝试在数据库中查找其 GitHub 作者和 指派人（请注意，拉取请求在 CODEChina 中被称为"合并请求"）。
**注意：**必须具有对 GitLab 服务器的管理员访问权限.
为了导入成功，在Github 项目导入前，至少需要项目中的每个作者和指派人都应该满足下列条件：
对于大型项目，可能需要一段时间才能导入所有数据. 为了减少必要的时间，您可以增加处理以下队列的 Sidekiq 工作程序的数量：
* 有一个 GitHub 帐户，其[主要电子邮件地址](https://help.github.com/en/github/setting-up-and-managing-your-github-user-account/setting-your-commit-email-address)与其 CODEChina 帐户的电子邮件地址匹配。
* `github_importer`
* `github_importer_advance_stage`
如果在 CODEChina 的数据库中未找到项目中引用的用户，则会将项目创建者（通常是启动导入的用户）设置为作者/指派人，但是对于该项目中 Issue 的评论，还是会提及到 Github 原作者。
For an optimal experience, it’s recommended having at least 4 Sidekiq processes (each running a number of threads equal to the number of CPU cores) that *only* process these queues. It’s also recommended that these processes run on separate servers. For 4 servers with 8 cores this means you can import up to 32 objects (e.g., issues) in parallel.
如果导入项目的命名空间不存在，则导入项目时会创建新的命名空间/组织；如果名称空间已经被占用，则会将该项目导入至启动导入过程的用户的命名空间里，命名空间/代码仓库名称也可以由具有权限的用户进行编辑。
减少克隆存储库所花费的时间可以通过增加存储 Git 存储库（适用于您的 GitLab 实例）的磁盘的网络吞吐量，CPU 容量和磁盘性能（例如，使用高性能 SSD）来完成. 增加 Sidekiq 工作人员的数量*不会*减少克隆存储库所花费的时间.
\ No newline at end of file
有关更多技术细节，您可以参考使用 GitHub 导入器开发人员文档。
\ No newline at end of file
docs/user/project/issues/actions.md
浏览文件 @ 53d02cd2
此差异已折叠。
Markdown is supported
0% 或 .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑！
想要评论请 注册 或