1. 安装 Git
首先要确保系统中已经安装了 Git。打开终端,输入以下命令进行安装:
sudo apt update
sudo apt install git
安装完成后,使用以下命令验证 Git 是否安装成功:
git --version
2. 配置 Git 用户名和邮箱
在使用 Git 之前,需要配置用户名和邮箱,这会在提交代码时记录你的身份信息。在终端中输入以下命令进行配置:
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
3. 生成 SSH 密钥(可选但推荐)
使用 SSH 密钥可以更安全、方便地与 GitLab 进行通信。在终端中输入以下命令生成 SSH 密钥:
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"
按照提示连续按回车键,直到密钥生成完成。默认情况下,密钥会生成在 ~/.ssh/id_rsa
和 ~/.ssh/id_rsa.pub
文件中。
然后,将公钥添加到 GitLab 账户中。使用以下命令查看公钥内容:
cat ~/.ssh/id_rsa.pub
复制输出的内容,登录 GitLab 网站,进入个人设置 -> SSH 密钥,将公钥粘贴到相应的输入框中并保存。
4. 下载代码(克隆仓库)
如果你需要从 GitLab 下载代码,可以使用 git clone
命令。在终端中,进入你想要存放代码的目录,然后执行以下命令:
cd /path/to/your/directory
git clone git@gitlab.com:username/repository.git
如果你没有使用 SSH 密钥,也可以使用 HTTPS 协议进行克隆:
git clone https://gitlab.com/username/repository.git
这里的 username
是 GitLab 账户名,repository
是仓库名称。执行命令后,Git 会自动将代码下载到当前目录下。
5. 上传代码
如果你已经有本地代码需要上传到 GitLab 仓库,可以按照以下步骤操作:
5.1 创建新的 GitLab 仓库
登录 GitLab 网站,点击右上角的“+”号,选择“New project”,按照提示创建一个新的仓库。
5.2 初始化本地仓库
在终端中,进入你的本地代码目录,使用以下命令初始化 Git 仓库:
cd /path/to/your/local/code
git init
5.3 添加文件到暂存区
使用以下命令将所有文件添加到暂存区:
git add .
如果你只想添加特定的文件,可以使用以下命令:
git add filename
5.4 提交文件到本地仓库
使用以下命令将暂存区的文件提交到本地仓库,并添加提交信息:
git commit -m "Initial commit"
5.5 将本地仓库与 GitLab 仓库关联
使用以下命令将本地仓库与 GitLab 仓库关联:
git remote add origin git@gitlab.com:username/repository.git
如果你使用的是 HTTPS 协议,可以使用以下命令:
git remote add origin https://gitlab.com/username/repository.git
5.6 推送代码到 GitLab 仓库
使用以下命令将本地仓库的代码推送到 GitLab 仓库:
git push -u origin master
如果你使用的是其他分支,可以将 master
替换为相应的分支名。
通过以上步骤,你就可以在 Ubuntu 系统下完成 GitLab 的代码上传和下载操作。
=============================添加仓库==================================
在 Ubuntu 系统下,你无法直接通过 git
命令在 GitLab 上创建远程仓库,但可以借助 GitLab 的 API 或者在浏览器操作创建,之后再使用 git
与该远程仓库进行交互。下面为你详细介绍这两种方式:
方法一:通过浏览器创建远程 GitLab 仓库
1. 创建 GitLab 仓库
- 打开浏览器,访问你的 GitLab 实例(如
https://gitlab.com
),登录你的账户。 - 点击界面右上角的 “+” 图标,在下拉菜单中选择 “New project”。
- 在创建项目页面填写相关信息:
- Project name:填写仓库的名称。
- Project description:可对仓库进行简要描述(可选)。
- Visibility level:选择仓库的可见性,如公开(Public)、内部(Internal)或私有(Private)。
- 完成信息填写后,点击 “Create project” 按钮,即可成功创建远程仓库。
2. 将本地项目与远程仓库关联
- 初始化本地仓库:打开终端,进入你的本地项目目录,使用以下命令初始化一个新的 Git 仓库:
cd /path/to/your/local/project
git init
- 添加远程仓库地址:将刚刚在 GitLab 上创建的远程仓库地址添加到本地仓库,命令如下(使用 SSH 地址示例):
git remote add origin git@gitlab.com:your_username/your_project.git
如果使用 HTTPS 地址,则为:
git remote add origin https://gitlab.com/your_username/your_project.git
- 添加文件到暂存区并提交:
git add .
git commit -m "Initial commit"
- 推送本地代码到远程仓库:
git push -u origin master
这里假设使用的是 master
分支,若使用其他分支,将 master
替换为相应分支名。
方法二:使用 GitLab API 创建远程仓库
1. 获取个人访问令牌
- 登录 GitLab 账户,点击右上角头像,选择 “Settings”。
- 在左侧菜单中选择 “Access Tokens”。
- 填写令牌名称、过期日期,并勾选所需权限(如
api
)。 - 点击 “Create personal access token” 按钮,复制生成的令牌,注意令牌只会显示一次,需妥善保存。
2. 使用 curl
命令调用 API 创建仓库
在终端中使用以下 curl
命令创建仓库,将 your_token
替换为你刚刚获取的个人访问令牌,your_username
替换为你的 GitLab 用户名,your_project_name
替换为你要创建的仓库名称:
curl --request POST --header "PRIVATE-TOKEN: your_token" "https://gitlab.com/api/v4/projects?name=your_project_name&namespace_id=$(curl --header "PRIVATE-TOKEN: your_token" "https://gitlab.com/api/v4/users?username=your_username" | grep -o '"id": [0-9]*' | grep -o '[0-9]*')"
3. 将本地项目与新创建的远程仓库关联
后续步骤与通过浏览器创建仓库后关联本地项目的步骤相同,即初始化本地仓库、添加远程仓库地址、添加文件到暂存区并提交、推送本地代码到远程仓库。