管理项目
大多数在极狐GitLab 中的工作都在项目中完成。文件和代码保存在项目中，大多数功能也在项目范围内。
项目概览
- 项目创建日期引入于 GitLab 16.10。
当你选择一个项目时，项目概览页面会显示该项目的内容：
- 仓库中的文件
- 项目信息（描述）
- 主题
- 徽章
- 项目的星标数、分叉数、提交次数、分支数、标签数、版本数和环境数
- 项目存储大小
- 可选的文件和配置
-
README或索引文件- Wiki 页面
- 许可证
- 更新日志
- 贡献指南
- Kubernetes 集群
- CI/CD 配置
- 集成
- GitLab Pages
- 创建日期
对于公共项目以及具有查看项目代码权限的内部和私有项目成员，项目概览页面会显示：
-
README或索引文件。 - 项目仓库中的目录列表。
对于没有查看项目代码权限的用户，概览页面将显示：
- Wiki 首页。
- 项目中的议题列表。
使用项目 ID 访问项目
- 项目 ID 已移动至 GitLab 16.7 的操作菜单。
你可以通过项目的 ID 来访问项目，而不使用项目名称，网址格式为 https://gitlab.example.com/projects/<id>。
例如，如果在你的个人命名空间 alex 中有一个名为 my-project 的项目，ID 为 123456，你可以通过以下方式访问该项目：
- https://gitlab.example.com/alex/my-project
- https://gitlab.example.com/projects/123456
https://gitlab.example.com/-/p/<id> 来访问该端点。如果你想通过极狐GitLab API 与项目进行交互，可能还需要用到项目 ID。
复制项目 ID 的步骤如下：
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 在项目概览页面的右上角，选择 更多操作。
- 选择 复制项目ID。
查看实例中的所有项目
要查看极狐GitLab 实例中的所有项目：
- 在左侧边栏选择 搜索或转到。
- 选择 探索。
在左侧边栏中，项目 已被选中，显示出该实例中的所有项目列表。
如果你没有身份验证，列表中只会显示公共项目。
查看你是成员的项目
要查看你是成员的项目：
- 在左侧边栏选择 搜索或转到。
- 选择 查看我的所有项目。
在左侧边栏，项目 被选中，列表中 您的 标签下会显示你是成员的所有项目。
查看个人项目
个人项目是指在你的个人命名空间下创建的项目。
例如，如果你创建一个用户名为 alex 的账户，并在该用户名下创建一个名为 my-project 的项目，则该项目的 URL 为 https://gitlab.example.com/alex/my-project。
要查看你的个人项目：
- 在左侧边栏选择 搜索或转到。
- 选择 查看我的所有项目。
- 选择 个人 标签。
或者
- 在左侧边栏选择你的头像，然后选择你的用户名。
- 在左侧边栏选择 个人项目。
查看星标的项目
要查看你已星标的项目：
- 在左侧边栏选择 搜索或转到。
- 选择 查看我的所有项目。
- 选择 已加星标 标签。
或者
- 在左侧边栏选择你的头像，然后选择你的用户名。
- 在左侧边栏选择 星标项目。
编辑项目名称和描述
使用项目的常规设置来编辑你的项目详情。
前提条件：
- 你必须至少拥有该项目的 Maintainer 角色。
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 选择 设置 > 通用。
- 在 项目名称 文本框中输入项目名称。请参阅 项目名称限制。
- 可选。在 项目描述 文本框中输入项目描述。描述限制为 2000 个字符。
- 选择 S保存更改。
添加项目头像
为项目添加头像，以帮助视觉上识别项目。如果未添加头像，GitLab 将显示项目名称的第一个字母作为默认头像。
要添加项目头像，可以使用以下任一方法：
添加 logo 到仓库
如果你没有在项目设置中上传头像，GitLab 会在仓库中查找名为 logo 的文件，并将其作为项目的默认头像。
前提条件：
- 你必须至少拥有该项目的 Maintainer 角色。
- 文件大小必须不超过 200 KB，理想的图片大小为 192 x 192 像素。
- 文件名必须为
logo，并且扩展名为.png、.jpg或.gif，例如：logo.gif。
将 logo 文件添加为项目头像：
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 在项目仓库的根目录中上传 logo 文件。
在项目设置中上传头像
前提条件：
- 你必须至少拥有该项目的 Maintainer 角色。
- 文件大小必须不超过 200 KB，理想的图片大小为 192 x 192 像素。
- 图片必须为以下文件类型之一：
.bmp.gif.ico.jpeg.png.tiff
在项目设置中上传头像：
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 选择 设置 > 通用。
- 在 项目头像 部分，选择 选择文件。
- 选择你的头像文件。
- 选择 保存更改。
星标项目
你可以将常用的项目加星标，方便以后查找。 要星标一个项目：
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 在页面右上角选择 星标。
删除项目
- 极狐GitLab 16.0 中，专业版和旗舰版本的默认项目删除行为改为延迟删除。
- 极狐GitLab 16.0 中，专业版和旗舰版本的默认删除行为改为延迟删除，适用于 JihuLab.com 和 私有化部署。
你可以标记项目为删除。删除项目后：
- 个人命名空间中的项目会立即删除。
- 群组中的项目会在保留期过后删除。
前提条件：
- 你必须是该项目的 Owner 角色。
- 所有者必须允许删除项目。
删除项目步骤：
- 在左侧边栏选择 搜索或转到 并找到你的项目。
- 选择 设置 > 通用。
- 展开 高级。
- 在 删除此项目 部分选择 删除项目。
- 在确认对话框中输入项目名称，并选择 是的，删除项目。
此操作会删除项目及所有相关资源（如问题和合并请求）。
你也可以通过 Rails 控制台删除项目。
延迟项目删除
- 在极狐GitLab 15.1 版本中，启用个人命名空间中的项目删除延迟。
- 在极狐GitLab 15.3 版本中，禁用个人命名空间中的项目删除延迟。
- 在极狐GitLab 16.0 版本中，默认启用了延迟删除，并移除了立即删除选项，适用于 JihuLab.com 和 私有化部署。
先决条件：
- 您必须拥有该项目的所有者角色。
在组内的项目（非个人命名空间）可以在延迟期后删除。
在私有化部署实例中，组管理员可以定义删除延迟期，范围为 1 到 90 天。
在 SaaS 中，默认的保留期为七天，且不可调整。
您可以查看待删除的项目，并使用 Rails 控制台查找待删除的项目。
如果安排项目删除的用户在删除发生之前失去对该项目的访问权限（例如，通过离开项目、角色降级或被禁止访问该项目），
则删除任务将会恢复并解档该项目，因此该项目将不再被安排删除。
立即删除项目
- 在极狐GitLab 16.0 版本中，移除了在 管理 区域和作为组设置的立即删除项目选项，适用于 JihuLab.com 和私有化部署。
如果您不想等待延迟删除，可以立即删除项目。为此，请重新执行删除项目的步骤。
在第一次删除项目的过程中，项目将会被移动到延迟删除队列，并在保留期结束后自动删除。
如果在此延迟删除期间执行第二次删除操作，项目将立即被删除。
先决条件：
- 您必须拥有该项目的所有者角色。
- 项目必须已标记为待删除。
要立即删除已标记为删除的项目：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 设置 > 常规。
- 展开 高级。
- 在 删除此项目 部分，选择 删除项目。
- 在确认对话框中，输入项目名称并选择 是，删除项目。
查看待删除的项目 (PREIMUM ALL)
要查看所有待删除项目的列表：
- 在左侧边栏中，选择 搜索或转到。
- 选择 查看我所有的项目。
- 选择 待删除 标签。
每个项目显示：
- 项目被标记为删除的时间。
- 项目计划最终删除的时间。
- 一个 恢复 链接，用于停止项目最终删除。
恢复项目 (PREIMUM ALL)
先决条件：
- 您必须拥有该项目的所有者角色。
- 项目必须已标记为待删除。
要恢复已标记为删除的项目：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 设置 > 常规。
- 展开 高级。
- 在 恢复项目 部分，选择 恢复项目。
存档项目
- 页面删除功能在极狐GitLab 17.5 版本中引入。
当您存档项目时，部分功能将变为只读。这些功能仍然可访问，但不可编辑。
- 仓库
- 包
- 问题
- 合并请求
- 功能标志
- 拉取镜像
- 所有其他项目功能
存档项目的活动流水线调度不会变为只读。
如果项目已经部署了 Pages，它们将被删除，包括任何自定义域，并且 Pages 链接将不再可访问。
存档项目将：
- 在项目页面上标记为
已存档标签。 - 在您的工作 页面和 浏览项目 页面中的 未激活 标签中列出。
- 变为只读。
先决条件：
- 停用或删除该项目的任何活动流水线调度。
要存档项目：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 设置 > 常规。
- 展开 高级。
- 在 存档项目 部分，选择 存档项目。
- 确认选择 确定。
取消存档项目
当您取消存档项目时，将解除只读限制，项目将重新出现在项目列表中。
先决条件：
- 您必须是管理员或拥有该项目的所有者角色。
- 找到已存档的项目。
- 在左侧边栏中，选择 搜索或转到。
- 选择 查看我所有的项目。
- 选择 浏览项目。
- 在 排序项目 下拉列表中，选择 显示已存档的项目。
- 在 按名称筛选 字段中，输入项目名称。
- 选择项目链接。
- 在左侧边栏中，选择 设置 > 常规。
- 在 高级 下，选择 展开。
- 在 取消存档项目 部分，选择 取消存档项目。
- 确认选择 确定。
已部署的 Pages 不会恢复，您必须重新运行流水线。
当项目取消存档后，其拉取镜像过程将自动恢复。
查看项目动态
要查看项目的活动：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 管理 > 动态。
-
可选：要按贡献类型筛选活动，选择一个标签：
- 全部：项目成员的所有贡献。
- 推送事件：项目中的推送事件。
- 合并事件：项目中已接受的合并请求。
- 议题事件：项目中打开和关闭的问题。
- 评论：项目成员发布的评论。
- 设计：项目中添加、更新和移除的设计。
- 团队：项目中加入或离开的成员。
在项目中搜索
要在项目中搜索，在左侧边栏中选择 搜索或转到。
GitLab 会在您输入时进行筛选。
您还可以查找您标星的项目（已标星的项目）。
您可以通过 探索 来探索 GitLab.cn 上的所有公开和内部项目，并可以按可见性筛选，
通过 热门、按 最多星标 排序，或查看 全部 项目。
您可以按以下方式对项目进行排序：
- 名称
- 创建日期
- 更新日期
- 星标数量
按语言筛选项目
- 在极狐GitLab 15.9 版本中，引入了按编程语言筛选项目的功能，并默认启用此标志
project_language_search。- 在极狐GitLab 15.9 版本中 GA，并移除了功能标志
project_language_search。
您可以按使用的编程语言筛选项目。为此：
- 在左侧边栏中，选择 搜索或转到。
- 选择：
- 查看我的所有项目，以筛选您的项目。
- 浏览项目，以筛选您可以访问的所有项目。
- 在项目列表上方，选择 搜索或筛选结果。
- 从 语言 下拉列表中，选择您要筛选的编程语言。
将显示使用所选语言的项目列表。
查看仅您拥有的项目
要查看仅您拥有的项目：
- 在左侧边栏中，选择 搜索或转到。
- 选择：
- 查看我的所有项目，以筛选您的项目。
- 浏览项目，以筛选您可以访问的所有项目。
- 在项目列表上方，选择 搜索或筛选结果。
- 从 角色 下拉列表中，选择 所有者。
重命名仓库
一个项目的仓库名称定义了其 URL 和在 GitLab 安装路径中的位置。
先决条件：
- 您必须是管理员或拥有该项目的维护者或所有者角色。
要重命名仓库：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 选择 设置 > 常规。
- 展开 高级。
- 在 更改路径 文本框中，编辑路径。
- 选择 更改路径。
离开项目
- 在极狐GitLab 16.7 版本中，离开项目的按钮移动到了操作菜单中。
当您离开项目时：
- 您将不再是项目成员，无法进行贡献。
- 所有分配给您的问题和合并请求将会取消分配。
先决条件：
要离开项目：
- 在左侧边栏中，选择 搜索或转到 并找到您的项目。
- 在项目概览页面的右上角，选择 操作 ()。
- 选择 离开项目，然后再次选择 离开项目。
向项目添加合规框架 (PREIMUM ALL)
您可以向拥有 合规框架 的组中的项目添加合规框架。
通过 LDAP 管理项目访问
您可以使用 LDAP 管理组成员身份。
您无法通过 LDAP 组管理项目访问，但可以使用以下方法。
先决条件：
- 您必须 将 LDAP 与 GitLab 集成。
- 您必须是管理员。
- 创建一个组来跟踪项目的成员身份。
- 为该组设置 LDAP 同步。
- 要使用 LDAP 组管理项目访问， 将同步的 LDAP 组作为成员添加到项目中。
项目别名 (PREIMUM ALL)
极狐GitLab 仓库通常通过命名空间和项目名称访问。然而，在将频繁访问的仓库迁移到 GitLab 时，您可以使用项目别名以原始名称访问这些仓库。通过项目别名访问仓库可以降低迁移仓库时的风险。
此功能仅在 Git 通过 SSH 访问时可用。并且，只有 GitLab 管理员才能创建项目别名，且只能通过 API 创建。有关更多信息，请参阅
项目别名 API 文档。
管理员为项目创建别名后，您可以使用该别名克隆仓库。例如，如果管理员为 https://gitlab.com/gitlab-org/gitlab 项目创建了别名 gitlab，
您可以通过 git clone git@gitlab.com:gitlab.git 克隆该项目，而不是 git clone git@gitlab.com:gitlab-org/gitlab.git。