Help us learn about your current experience with the documentation. Take the survey.

创建项目

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

您有多种方式创建项目。可以创建空白项目、使用内置或自定义模板创建项目，或通过 git push 创建项目。

创建空白项目

要创建空白项目：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 选择 创建空白项目。
  3. 输入项目详情：
    1. 项目名称：输入您的项目名称。 更多信息，请参见命名规则。
    2. 项目路径：输入您的项目路径。GitLab 使用该路径作为 URL 路径。
    3. 项目部署目标（可选）：如果要将项目部署到特定环境，请选择相应的部署目标。
    4. 可见性级别：选择适当的可见性级别。 有关用户的查看和访问权限。
    5. 使用 README 初始化仓库：选择此选项可初始化 Git 仓库、创建默认分支并启用此项目仓库的克隆。
    6. 启用静态应用安全测试 (SAST)：选择此选项可分析源代码中的已知安全漏洞。
    7. 启用密钥检测：选择此选项可分析源代码中的密钥和凭据，防止未授权访问。
  4. 选择 创建项目。

使用内置模板创建项目

内置模板会用文件填充新项目，帮助您快速上手。 这些模板来自 project-templates 和 pages 组。 任何人都可以为内置项目模板贡献内容。

要使用内置模板创建项目：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 选择 从模板创建。
  3. 选择 内置 标签页。
  4. 从模板列表中：
    • 要预览模板，选择 预览。
    • 要使用模板，选择 使用模板。
  5. 输入项目详情：
    • 项目名称：输入您的项目名称。
    • 项目路径：输入您的项目路径。GitLab 使用该路径作为 URL 路径。
    • 项目描述（可选）：输入项目描述。 字符限制为 500 个。
    • 可见性级别：选择适当的可见性级别。 有关用户的查看和访问权限。
  6. 选择 创建项目。

如果用户从模板创建项目，或导入项目， 他们将被显示为导入项目的作者，这些项目保留来自模板或导入的原始时间戳。 这可能导致项目看起来像是在用户账户创建之前就已存在。

导入的对象标记为 By <用户名> on <时间戳>。 在 GitLab 17.1 之前，标签后缀为 (imported from GitLab)。

使用 HIPAA 审计协议模板创建项目

HIPAA 审计协议模板包含美国卫生与公众服务部发布的 HIPAA 审计协议中的审计问题。

要使用 HIPAA 审计协议模板创建项目：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 选择 从模板创建。
  3. 选择 内置 标签页。
  4. 找到 HIPAA 审计协议 模板：
    • 要预览模板，选择 预览。
    • 要使用模板，选择 使用模板。
  5. 输入项目详情：
    • 项目名称：输入您的项目名称。
    • 项目路径：输入您的项目路径。GitLab 使用该路径作为 URL 路径。
    • 项目描述（可选）：输入项目描述。 字符限制为 500 个。
    • 可见性级别：选择适当的可见性级别。 有关用户的查看和访问权限。
  6. 选择 创建项目。

使用自定义模板创建项目

自定义项目模板可用于您的实例 和组。

要使用自定义模板创建项目：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 选择 从模板创建。
  3. 选择 实例 或 组 标签页。
  4. 从模板列表中：
    • 要预览模板，选择 预览。
    • 要使用模板，选择 使用模板。
  5. 输入项目详情：
    • 项目名称：输入您的项目名称。
    • 项目路径：输入您的项目路径。GitLab 使用该路径作为 URL 路径。
    • 项目描述（可选）：输入项目描述。字符限制为 500 个。
    • 可见性级别：选择适当的可见性级别。 有关用户的查看和访问权限。
  6. 选择 创建项目。

创建使用 SHA-256 哈希的项目

  • Status: Experiment

此功能的可用性由功能标志控制。 更多信息，请参见历史记录。 此功能可用于测试，但尚未准备好用于生产环境。

只有在创建项目时才能为项目选择 SHA-256 哈希。 Git 不支持稍后迁移到 SHA-256，或从 SHA-1 迁移回来。

要创建使用 SHA-256 哈希的项目：

  1. 在左侧边栏顶部，选择 新建（ plus ）和 新项目/仓库。
  2. 输入项目详情：
    • 项目名称：输入您的项目名称。
    • 项目路径：输入您的项目路径。GitLab 使用该路径作为 URL 路径。
    • 项目描述（可选）：输入项目描述。字符限制为 500 个。
    • 可见性级别：选择适当的可见性级别。 有关用户的查看和访问权限。
  3. 在 项目配置 区域，展开 实验性设置。
  4. 选择 使用 SHA-256 作为仓库哈希算法。
  5. 选择 创建项目。

为什么使用 SHA-256？

默认情况下，Git 使用 SHA-1 哈希算法 为提交、blob、树和标签等对象生成 40 字符 ID。当 Google 能够生成哈希碰撞 时， SHA-1 算法已被证明不安全。 由于 Git 存储对象的方式，Git 项目目前尚未受到此类攻击的影响。

在 SHA-256 仓库中，算法生成的是 64 字符 ID 而不是 40 字符 ID。 Git 项目在移除实验性标签后， 确定 SHA-256 功能可以安全使用。

联邦法规，如 NIST 和 CISA 指南， FedRamp 强制执行，已设定 2030 年为停止使用 SHA-1 的截止日期， 并鼓励机构尽可能提前迁移出 SHA-1。

相关主题