|
|
# 新建项目[](#create-a-project "Permalink")
|
|
# 新建项目[](#create-a-project "Permalink")
|
|
|
|
|
|
|
|
GitLab 中的大多数工作都在一个[Project 中](../user/project/index.html)完成. 文件和代码保存在项目中，并且大多数功能都在项目范围内使用.
|
|
开发中大多数工作都在一个[项目](../user/project/index.html)完成，文件和代码都保存在项目中，并且大多数功能都将在项目范围内使用。
|
|
|
|
|
|
|
|
## Create a project in GitLab[](#create-a-project-in-gitlab "Permalink")
|
|
## 新建一个项目[](#create-a-project "Permalink")
|
|
|
|
|
|
|
|
要在 GitLab 中创建项目：
|
|
您可以按照以下步骤新建一个项目：
|
|
|
|
|
|
|
|
1. 在信息中心中，点击绿色的**新建项目**按钮或使用导航栏中的加号图标. 这将打开" **新项目"**页面.
|
|
1. 点击导航栏中的加号图标并点击新建项目，这将打开" **新建项目"**页面
|
|
|
2. 在" **新建项目"**页面上，选择是否要：
|
|
2. 在" **新建项目"**页面上，可以选择：
|
|
|
* 创建一个[空白项目](#blank-projects) .
|
|
* 创建一个[空白项目](#blank-projects)
|
|
|
* 使用可用的[项目模板](#project-templates)之一创建一个项目.
|
|
* 使用可用的[项目模板](#project-templates)之一创建一个项目
|
|
|
* 如果已在您的 GitLab 实例上启用，则从其他存储库[导入项目](../user/project/import/index.html) . 如果不可用，请与您的 GitLab 管理员联系.
|
|
* 从其他第三方导入一个项目，目前支持 github 以及 url 导入这两种方式
|
|
|
* 运行[用于外部存储库的 CI / CD 管道](../ci/ci_cd_for_external_repos/index.html) .
|
|
|
|
|
|
|
|
|
|
**注意：**有关不能用作项目名称的单词列表，请参见[保留的项目和组名称](../user/reserved_names.html) .
|
|
**注意：**有关不能用作项目名称的单词列表，请参见[保留的项目和组名称](../user/reserved_names.html)
|
|
|
|
|
|
|
|
### Blank projects[](#blank-projects "Permalink")
|
|
### 空项目[](#blank-projects "Permalink")
|
|
|
|
|
|
|
|
要在" **新建项目"**页面上创建一个新的空白项目，请执行以下操作：
|
|
要在" **新建项目"**页面上创建一个新的空白项目，请执行以下操作：
|
|
|
|
|
|
|
|
1. 在" **空白项目"**选项卡上，提供以下信息：
|
|
1. 在" **空白项目"**选项卡上，提供以下信息：
|
|
|
* **项目名称**在**项目名称**字段中. 您不能使用特殊字符，但可以使用空格，连字符，下划线甚至表情符号. 添加名称时， **Project slug**将自动填充. slug 是 GitLab 实例将用作项目的 URL 路径的东西. 如果您要使用其他子弹，请先输入项目名称，然后再更改子弹.
|
|
* **项目名称**在**项目名称**字段中. 您不能使用特殊字符，但可以使用空格，连字符，下划线甚至表情符号；添加名称时， **项目 URL**将自动填充(仅在项目名称不含中文时会自动填充)
|
|
|
* **Project slug**字段中项目的路径. 这是 GitLab 实例将使用的项目的 URL 路径. 如果**项目名称**为空白，则当您填写**项目 slug**时，它将自动填充.
|
|
* **项目 URL**字段中项目的路径是项目的 URL 路径
|
|
|
* 使用" **项目描述"（可选）**字段，您可以为项目的仪表板输入描述，这将帮助其他人了解您的项目的含义. 尽管不是必需的，但这是个好主意.
|
|
* 使用" **项目描述"（可选）**字段，您可以为项目的仪表板输入描述，这将帮助其他人了解您的项目的含义；尽管不是必需的，但我们建议您还是填写上您的项目简介。
|
|
|
* 更改" **可见性级别"**会修改用户的项目[查看和访问权限](../public_access/public_access.html) .
|
|
* 更改" **可见性级别"**会修改用户的项目[查看和访问权限](../public_access/public_access.html)
|
|
|
* 选择**使用 README 初始化存储库**选项将创建一个 README 文件，以便 Git 存储库被初始化，具有默认分支并可以被克隆.
|
|
* 选择**使用 README 初始化存储库**选项将创建一个 README 文件，以便 Git 存储库被初始化，具有默认分支并可以被克隆
|
|
|
2. Click **建立专案**.
|
|
2. 点击 **新建项目**
|
|
|
|
|
|
|
|
### Project templates[](#project-templates "Permalink")
|
|
### 项目模板[](#project-templates "Permalink")
|
|
|
|
|
|
|
|
项目模板可以使用必要的文件预填充新项目，以使您快速入门.
|
|
项目模板可以使用必要的文件预填充新项目，以使您快速入门。
|
|
|
|
|
|
|
|
有两种类型的项目模板：
|
|
有两种类型的项目模板：
|
|
|
|
|
|
|
|
* [内置模板](#built-in-templates) ，来自以下组：
|
|
* [内置模板](#built-in-templates) ，来自以下组：
|
|
|
* [`project-templates`](https://gitlab.com/gitlab-org/project-templates)
|
|
* [`project-templates`](https://gitlab.com/gitlab-org/project-templates)
|
|
|
* [`pages`](https://gitlab.com/pages)
|
|
* [`pages`](https://gitlab.com/pages)
|
|
|
* [自定义项目模板](#custom-project-templates-premium) ，用于由 GitLab 管理员和用户配置的自定义模板.
|
|
* [自定义项目模板](#custom-project-templates-premium)
|
|
|
|
|
|
|
|
#### Built-in templates[](#built-in-templates "Permalink")
|
|
#### 内置模板[](#built-in-templates "Permalink")
|
|
|
|
|
|
|
|
内置模板是项目模板，它们是：
|
|
内置模板是项目模板，它们是：
|
|
|
|
|
|
|
|
* 在[`project-templates`](https://gitlab.com/gitlab-org/project-templates)和[`pages`](https://gitlab.com/pages)组中开发和维护.
|
|
* 在[`project-templates`](https://gitlab.com/gitlab-org/project-templates)和[`pages`](https://gitlab.com/pages)组中开发和维护
|
|
|
* 与 GitLab 一起发布.
|
|
* 与 GitLab 一起发布
|
|
|
|
|
|
|
|
要在" **新建项目"**页面上使用内置模板，请执行以下操作：
|
|
要在" **新建项目"**页面上使用内置模板，请执行以下操作：
|
|
|
|
|
|
|
|
1. 在" **从模板创建"**选项卡上，选择" **内置"**选项卡.
|
|
1. 在" **从模板创建"**选项卡上，选择" **内置模板"**选项卡
|
|
|
2. 从可用的内置模板列表中，单击：
|
|
2. 从可用的内置模板列表中，单击：
|
|
|
* **预览**按钮以查看模板源本身.
|
|
* **预览**按钮以查看模板源本身
|
|
|
* **使用模板**按钮开始创建项目.
|
|
* **使用模板**按钮开始创建项目
|
|
|
3. 通过填写项目的详细信息来完成创建项目. 该过程与创建[空白项目](#blank-projects)相同.
|
|
3. 通过填写项目的详细信息来完成创建项目， 该过程与创建[空白项目](#blank-projects)相同
|
|
|
|
|
|
|
|
##### Enterprise templates[](#enterprise-templates-ultimate "Permalink")
|
|
#### 自定义项目模板[](#custom-project-templates-premium "Permalink")
|
|
|
|
|
|
|
|
GitLab 正在开发企业模板，以帮助您根据选定的法规标准简化审核管理. 这些模板会自动导入与每个法规要求相对应的问题.
|
|
自定义项目可以从**实例**选项卡，或在[组级别](../user/group/custom_project_templates.html)从**组**选项卡，在**从模板**标签上的**创建** ，创建过程与内置模板创建项目基本一致。 |
|
|
|
|
\ No newline at end of file |
|
|
要使用企业模板创建新项目，请在" **新建项目"**页面上：
|
|
|
|
|
|
|
|
|
|
1. 在" **从模板创建"**选项卡上，选择" **内置"**选项卡.
|
|
|
|
|
2. 从可用的内置企业模板列表中，单击：
|
|
|
|
|
* **预览**按钮以查看模板源本身.
|
|
|
|
|
* **使用模板**按钮开始创建项目.
|
|
|
|
|
3. 通过填写项目的详细信息来完成创建项目. 该过程与创建[空白项目](#blank-projects)相同.
|
|
|
|
|
|
|
|
|
|
可用的企业模板包括：
|
|
|
|
|
|
|
|
|
|
* HIPAA 审核协议模板（在 GitLab 12.10 中[引入](https://gitlab.com/gitlab-org/gitlab/-/issues/13756) ）
|
|
|
|
|
|
|
|
|
|
**提示：**您可以按照[以下步骤](https://gitlab.com/gitlab-org/project-templates/contributing)改进现有的内置模板或在[`project-templates`](https://gitlab.com/gitlab-org/project-templates)和[`pages`](https://gitlab.com/pages)组中添加新的[`project-templates`](https://gitlab.com/gitlab-org/project-templates) .
|
|
|
|
|
|
|
|
|
|
#### Custom project templates[](#custom-project-templates-premium "Permalink")
|
|
|
|
|
|
|
|
|
|
[Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/6860) in [GitLab Premium](https://about.gitlab.com/pricing/) 11.2.
|
|
|
|
|
|
|
|
|
|
Creating new projects based on custom project templates is a convenient option for quickly starting projects.
|
|
|
|
|
|
|
|
|
|
自定义项目可以在[实例级别](../user/admin_area/custom_project_templates.html)从**实例**选项卡，或在[组级别](../user/group/custom_project_templates.html)从**组**选项卡，在**从模板**标签上的**创建** .
|
|
|
|
|
|
|
|
|
|
要在" **新建项目"**页面上使用自定义项目模板：
|
|
|
|
|
|
|
|
|
|
1. 在" **从模板创建"**选项卡上，选择" **实例"**选项卡或" **组"**选项卡.
|
|
|
|
|
2. 从可用的自定义模板列表中，单击：
|
|
|
|
|
* **预览**按钮以查看模板源本身.
|
|
|
|
|
* **使用模板**按钮开始创建项目.
|
|
|
|
|
3. 通过填写项目的详细信息来完成创建项目. 该过程与创建[空白项目](#blank-projects)相同.
|
|
|
|
|
|
|
|
|
|
## Push to create a new project[](#push-to-create-a-new-project "Permalink")
|
|
|
|
|
|
|
|
|
|
在 GitLab 10.5 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/issues/26388) .
|
|
|
|
|
|
|
|
|
|
当您在本地创建新的存储库时，无需直接在 GitLab 上手动创建一个新项目然后[在](start-using-git.html#clone-a-repository)本地[克隆该](start-using-git.html#clone-a-repository)存储库，而无需将其直接发送到 GitLab 即可创建新项目. 如果您具有关联的名称空间的访问权，则 GitLab 将在该 GitLab 名称空间下自动创建一个新项目，其可见性默认设置为 Private（您以后可以在[项目的设置中](../public_access/public_access.html#how-to-change-project-visibility)对其进行更改）.
|
|
|
|
|
|
|
|
|
|
这可以通过使用 SSH 或 HTTPS 来完成：
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
## Git push using SSH
|
|
|
|
|
git push --set-upstream git@gitlab.example.com:namespace/nonexistent-project.git master
|
|
|
|
|
|
|
|
|
|
## Git push using HTTPS
|
|
|
|
|
git push --set-upstream https://gitlab.example.com/namespace/nonexistent-project.git master
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
推送成功完成后，将显示一条远程消息，指示将遥控器和 URL 设置为新项目的命令：
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
remote:
|
|
|
|
|
remote: The private project namespace/nonexistent-project was created.
|
|
|
|
|
remote:
|
|
|
|
|
remote: To configure the remote, run:
|
|
|
|
|
remote: git remote add origin https://gitlab.example.com/namespace/nonexistent-project.git
|
|
|
|
|
remote:
|
|
|
|
|
remote: To view the project, visit:
|
|
|
|
|
remote: https://gitlab.example.com/namespace/nonexistent-project
|
|
|
|
|
remote:
|
|
|
|
|
``` |
|
|
|
\ No newline at end of file |
|
|
