GitLab - 创建项目

GitLab - 创建新项目

本章将指导你如何在 GitLab 中创建一个新项目并进行你的第一次推送（push）。GitLab 项目是你开发工作的核心，其中包含你的代码、问题（issues）、CI/CD 流水线（pipelines）等等。

通过 GitLab UI 创建项目

步骤 1：登录你的 GitLab 账户。在你的控制面板或点击顶部导航栏中的“+”图标，选择“New project/repository”（新建项目/仓库）。

步骤 2：你将看到几个创建项目的选项：

• Create blank project（创建空白项目）： 从一个空项目开始。你需要定义项目名称、可选描述、可见性级别（Private 私有, Internal 内部, or Public 公开），并可以选择是否用一个 README 文件初始化项目。
• Create from template（从模板创建）： GitLab 提供用于各种项目类型的内置模板（例如 Ruby on Rails, Spring, NodeJS Express），或者如果已配置，你也可以使用实例级或群组级的自定义模板。
• Import project（导入项目）： 从其他平台（如 GitHub, Bitbucket）迁移现有项目，或通过上传 Git 仓库 URL 进行导入。
• Run CI/CD for external repository（为外部仓库运行 CI/CD）： 连接外部仓库（例如 GitHub 上的仓库），以便在 GitLab 中运行 CI/CD，而无需完全迁移代码库。

步骤 3：对于一个新的空白项目，请提供以下详情：

• Project name（项目名称）： 项目的描述性名称。
• Project slug (Optional)（项目 slug (可选)）： 项目的 URL 友好路径。GitLab 通常会根据项目名称生成。
• Project description (Optional but recommended)（项目描述 (可选但推荐)）： 项目的简要概述。
• Visibility Level（可见性级别）：
• • Private（私有）： 只有项目成员才能看到和访问项目。
• • Internal（内部）： 你的 GitLab 实例上任何已登录用户都可以看到和访问项目（对于 GitLab.com 不适用，除非你是组织的一部分）。
• • Public（公开）： 项目对任何人可见，即使没有 GitLab 账户。
• Initialize repository with a README (Recommended)（用 README 初始化仓库 (推荐)）： 这将创建一个包含 README.md 文件的初始提交，使项目更容易立即被克隆。

点击“Create project”（创建项目）。GitLab 随后将设置你的新项目仓库。

将现有本地仓库推送到你的 GitLab 项目

如果你在 GitLab 中创建了一个空白项目（没有用 README 初始化），并且你有一个现有的本地 Git 仓库，你可以将其推送到 GitLab。如果你的 GitLab 项目已用 README 初始化，你应该先克隆（clone）它，添加你的文件，提交（commit），然后推送（push）。

假设你有一个本地仓库和一个空的 GitLab 项目：

步骤 1：在你的终端或命令提示符中导航到你的本地仓库目录。

cd /path/to/your/local-repo

步骤 2：将 GitLab 仓库添加为远程仓库（remote）。你可以在 GitLab 项目主页上的“Clone”（克隆）按钮下方找到仓库 URL（HTTPS 或 SSH）。

# Using HTTPS
git remote add origin https://gitlab.example.com/your-username/your-project-name.git

# Or using SSH
git remote add origin git@gitlab.example.com:your-username/your-project-name.git

步骤 3：将你的本地仓库分支推送到 GitLab。如果你的本地主分支命名为 master 而 GitLab 的默认分支是 main（或反之），你可能需要重命名分支或专门进行推送。

# Push all branches and tags
git push -u origin --all
git push -u origin --tags

-u 标志设置当前分支的上游远程仓库（upstream remote），这样将来的 git pull 和 git push 命令就可以在不指定 origin main 的情况下运行。

克隆并推送新的本地仓库到 GitLab

如果你开始时使用 README 初始化了你的 GitLab 项目，或者你想在本地全新开始：

步骤 1：将仓库克隆到你的本地系统。从你的 GitLab 项目页面获取克隆 URL（HTTPS 或 SSH）。

# Using HTTPS
git clone https://gitlab.example.com/your-username/your-project-name.git

# Or using SSH
git clone git@gitlab.example.com:your-username/your-project-name.git

cd your-project-name

步骤 2：创建或添加你的项目文件。例如，创建一个 README.md 文件（如果不存在），或者复制你的应用程序代码。

echo "# My New Project" >> README.md
# Or copy your existing project files here

步骤 3：将新文件添加到 Git 的暂存区（staging area）。

git add .  # Adds all new and modified files
# Or git add README.md specific_file.py

步骤 4：提交你的更改并附带描述性消息。

git commit -m "Initial commit with project setup"

-m 标志用于提交消息（commit message）。

步骤 5：将你的提交推送到 GitLab 上的远程仓库。如果你的本地分支名为 main（这是现代的默认命名），并且你克隆了项目，那么远程 origin 和上游分支（upstream branch）应该已经设置好了。

git push origin main  # Or 'master' if that's your branch name

推送完成后，刷新你在 GitLab 上的项目页面。你应该能看到你的文件和提交历史（commit history）。

最佳实践：默认分支名称

现代的 Git 工作流程，包括 GitLab 的默认设置，使用 main 作为默认分支名称而不是 master。如果你的本地 Git 配置仍然默认为 master，你可以全局或按项目更改它。GitLab 允许你在群组或实例设置中配置新项目的默认分支名称。

延伸阅读

探索更多关于 GitLab 中的项目管理信息：GitLab 项目文档。