docs/社区使用指南/Gitee使用指南.md

74 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

---
title: Gitee使用指南
description:
published: true
date: 2022-07-20T12:41:42.072Z
tags:
editor: markdown
2022-05-17 15:19:34 +08:00
dateCreated: 2022-03-11T03:17:16.426Z
---
2021-11-18 15:42:08 +08:00
# Gitee使用指南
openKylin社区的参与者可以使用Gitee来参与到优麒麟社区项目中通过提交BUG/Issue、获取项目、提交推送这几个角度来简单介绍如何使用Gitee。
2021-11-18 15:42:08 +08:00
## 通过GItee提交BUG/Issue
在openKylin社区项目使用过程中有体验不佳、使用存在BUG的情况时通过Gitee的Issue功能向相关的项目提交你的问题。
2021-11-18 15:42:08 +08:00
![新建issue.png](/社区使用指南/img/新建issue.png)
2021-11-18 15:42:08 +08:00
点击新建Issue并在描述里添加该问题的详细描述包括ISO版本、复现手法、复现步骤等信息提交Issue请遵守《Issue报告规范》完成相关信息填写后点击创建。完成这一过程即向优麒麟社区项目提交一次Issue。
## 通过Gitee获取项目
在Gitee上注册账号并登录后用户可以选择先上传自己的SSH公钥和仓库"只读"权限的 SSH Key 相比,账户的 SSH Key 同时具备推送/拉取的权限,对用户创建/参与的仓库均能使用,使用起来更加方便。
通过选择用户头像 -> 菜单“修改资料”然后选择“SSH公钥”填写一个便于识别的标题然后输入用户的SSH公钥没有SSH公钥的用户可以通过以下步骤添加公钥。
Linux操作系统或Mac操作系统用户可以打开终端输入
> $ ssh-keygen -t rsa -C “*youremail@youremail.com*”
生成属于你的密钥,再使用命令:
> $ cat ~/.ssh/id_rsa.pub
在终端输出你的密钥,将其复制到:
![新增ssh密钥.png](/社区使用指南/img/新增ssh密钥.png)
2021-11-18 15:42:08 +08:00
即可。Windows操作系统用户打开Git Bash在控制台中输入以下命令:
> $ ssh-keygen -t rsa -C “*youremail@youremail.com*”
在完成密码输入后 [c盘>用户>自己的用户名>.ssh] 目录下公钥已经生成将id_rsa.pub文件输出后拷贝到指定位置即可。
在设置完SSH后可以直接使用进入想要参与的openKylin项目页面中点击克隆并在选中SSH后点击复制
2021-11-18 15:42:08 +08:00
![ Gitee使用指南-clone项目 ](./img/clone项目.png)
进入系统后视用户操作系统情况打开终端或控制台,输入:
> $ git clone <粘贴内容>
回车即可获取项目源码。
没有添加SSH密钥的用户可以直接使用HTTPS链接进行复制
进入系统后视用户操作系统情况打开终端或控制台,输入:
> $git clone <粘贴内容>
即可获取项目源码。
## 通过Gitee向项目提交推送
openKylin社区项目的参与者众多提交代码请参考遵守《代码合并与提交》。
如果需要向openKylin社区项目提供代码首先应当fork该项目建立自己的Gitee仓库。
2021-11-18 15:42:08 +08:00
在合理的修改代码并上传到自己的的仓库后,点击 <span style="background: #fe7300; padding:5px;border-radius:4px;color:white;">+ Pull Requests</span> 开始提交你的修改pr。
![ Gitee使用指南-提交pr ](./img/提交pr.png)
请注意提交时的分支是否正确确认无误后进入提交界面。补充好这次提交的相关信息后点击创建恭喜你完成了一次向openKylin的贡献。
2021-11-18 15:42:08 +08:00
以上就是Gitee基本使用欢迎各位向openKylin贡献力量本指南也在持续更新中...