Gitlab使用流程.pptx

单击此处编辑母版标题样式,单击此处编辑母版文本样式,第二级,第三级,第四级,第五级,2019/6/23,#,Gitlab,使用流程,（内部公开文件）,1,账号申请,客户端,安装,SSH key,使用,(Mac),SSH key,使用（,Windows,）,新建项目规则,项目检出,check,创建分支,branch,代码提交,Commit,代码拉取,Pull,代码推送,Push,代码标签,tag,代码冲突解决,创建忽略文件,Git Flow,实战,2,一、账号申请,1.,开发人员提供以下资料给管理员：,姓名（用于展示用户姓名）,邮箱（用于接收密码接收推送通知等）,2.,收到重置密码邮件以后进行密码重置,密码需要设置,8,位以及以上，建议使用自己的姓名,+,数字组成比如,3.,登录,在浏览器输入：,http,:/szltech.f3322.org:15280,/,进入到,gitlab,登录页，输入用户名（自己姓名的全拼），以及密码可以进入系统。,登录成功后，用户的操作按钮在页面右上角,3,二,、客户端安装,统一使用,SourceTree,软件进行代码开发的管理,下载地址：,/,客户端支持,windows,和苹果系统,若无法下载，请自行搜索下载应用,4,SSHkey,使用（,Mac,）,第三章,5,三、,SSHkey,使用（,Mac,）,1,）生成,SSH key,1.,打开终端命令行,2,.,输入以下内容：,ssh-keygen,-t rsa-C,“,邮箱地址,“,3.,要求输入密码的时候，直接回车即可,4.,然后查看生成的,SSH Key,cat/.ssh/id_rsa.pub,5.,把这个,SSH key,的内容添加到,Gitlab,个人设置中（请参见下一步）,2,4,3,1,6,三、,SSHkey,使用（,Mac,）,1.,打开,Gitlab,登录自己的账户,，,进入,用户设置，找到,SSH,keys,2.,点击,右侧,Add SSH Key,3.,输入上一步生成的,key,4.,点击,Add key,即可添加成功一个,key,2,3,2,）,Gitlab,配置,SSH keys,7,SSH key,使用（,Windows,）,第四章,8,SSH,key,使用（,Windows,）,1,）生成,SSH key,1.,点击创建,SSH,秘钥,2.,点击,Generate,后，,3.,用鼠标在进度条下方来回滑动,4.,生成的,key,点击,Save public key,和,save private key,，保存好公钥,私钥（重要）,1,2,3,4,9,SSH key,使用（,Windows,）,1.,打开,Gitlab,登录自己的账户,，,进入,用户设置，找到,SSH,keys,2.,点击,右侧,Add SSH Key,3.,输入上一步生成的,key,4.点击,Add key,即可添加成功一个,key,2,3,2,）,Gitlab,配置,SSH keys,10,SSH key,使用,（,Windows,）,1.,启用,source tree,的工具，点击“选项”,2.,选择上次生成的,SSH,秘钥,3.,点击“确定”,即,可添加成功,3,）客户端导入私钥,1,1,3,2,11,SSH key,使用,（,Windows,）,1.,启用,source tree,的工具，点击“启动,SSH,助手”,2.,如果没有弹出,SSH,助手，则看系统托盘是否有,3.,点击“,Add Key,”,4.,选择之前导出的私钥,5.,添加成功后，查看公钥跟,Gitlab,网页添加的,相同，则说明成功,4,）,SSH,助手配置,1,1,3,2,4,5,12,新建项目规则,第五章,13,1,）创建项目组,1.,当有新项目需要进行代码提交时，首先通过管理员创建一个项目的分组,2.,点击“,New Group,”,3.,在输入框输入英文的组名,：如,igwfmc,14,2,）项目组增加用户,1.,点击“,Groups,”,2.,选择相应项目名称，如“,igwfmc,”,3.,选择需要添加的用户和用户角色,角色一般选择“,developer,”,1,2,3,15,3,）创建新项目,1.,点击,“,Projects,”,2.,选择新增项目“,New Project,3.,分别新建,:,igwfmc_iOS,、,igwfmc_android,、,igwfmc_server,、,Igwfmc_H5(,如果有,),等几个项目,项目的,namespace,都要属于,igwfmc,的,项目,组。,1,2,3,3,16,项目检出,第六章,17,1,）获取项目,SSH,地址或者,HTTP,地址,用户可以通过首页“,Projects,”，查看所有参与的项目，点击相应的项目，进入项目的详情页,项目详情页最上面，就是本项目的,SSH,和,HTTP,地址,Tips,：,点击狐狸头，可以从任何界面回到本页,1,2,18,2,）打开,git,客户端，克隆项目,MAC,版本,Windows,版本,19,3,）克隆,项目,MAC,版本,Windows,版本,Tips,：,从高级选项可以选择检出的分支,不过一定要检出,Master,分支,方便后续的分支开发,20,创建分支,第七章,21,1,）打开,Source Tree,客户端,选择需要创建分支的版本,22,2,）点击分支按钮，输入分支名称，即可创建分支,23,2,）新分支创建成功需要提交分支信息,Tips,：,创建新分支后需要,先,推送一次，是为了在远端创建分支,24,代码,Commit,第八章,25,1,）,IDE,中保存代码,，,打开,SourceTree,点击工作副本，把“未暂存文件”的,Checkbox,选中文件会全部进入“已暂存文件”列表,1,2,Tips,：,1.,点击文件可以看到该文件的修改内容,2.,仅勾选,“未暂存文件”,列表中的一个文件，可以单独把一个文件放到“已暂存文件”中,26,2,）提交（,Commit,）,该操作仅是把版本保存到本地版本列表中，其他用户暂时还看不见。,确定所有需要提交的文件全部在“已暂存文件”之后,点击“提交”按钮，输入修改的主要内容，即可提交。,1,2,27,3,）提交成功,提交成功后，可以通过点击相应的分支，查看当前版本类图,备注：,1.,超前一个版本：是距离我们从远端检出（,check,）下来以后，提交的代码超前于这个版本,2.,落后,6,个版本：是远端有,6,个提交内容没有更新,Tips,：,Commit,代码，仅是对于本地代码,而言的，所以,commit,以后，任何其他,人是看不见的,28,代码,Pull,第九章,29,1,）点击“拉取”按钮,点击拉取，勾选需要获取到的分支，即可从服务器中获取最新代码。,2,Tips,：,1.,要养成每次开发前，都先拉取最新代码的习惯,2.,不要选择立即提交合并的改动，因为可能会有代码冲突，这样的版本,Commit,没有意义，一定要没有冲突了再手动提交一次,1,30,代码,Push,第十章,31,1,）点击“推送”按钮,点击推送，勾选需要推送到的分支，即可推送到服务器中。,2,Tips,：,1.,当,Commit,代码以后，应用一般会出现几个版本需要推送的提示（如没有，可以尝试刷新）,。,2,.,如果此时有需要拉取的数据没有拉取，则提示失败,1,32,创建,Tag,第十一章,33,1,）点击“标签”按钮,每发布一个稳定版本时，通常会加上一个标签,2,Tips,：,1.,点击推送标签，即可对远端进行同步,2.Tag,通常用来记录里程碑版本,1,34,代码冲突解决,第十二章,35,1,）冲突解决,Git,也会出现冲突，冲突标记跟,SVN,相似，一般都是通过多人协作，手动解决。,devolop:index.html,可以看到,=,隔开的上半部分，是,hotfix,分支中的内容，下半部分是在,develop,分支中的内容。解决冲突的办法无非是二者选其一或者由你亲自整合到一起。比如你可以通过把这段内容替换为下面这样来解决：,123,Tips,：,推荐,修改前先从服务器上更新文件到,本地减少冲突。,Pull,时不要立即提交（,Commit,）合并，避免因为冲突而需要多产生一个版本,36,创建忽略文件,第十三章,37,1,）创建文件,使用,IDE,开发，容易出现,IDE,的各种配置信息或者各种,Build,文件,，,这些文件是不需要放到代码库中保存的，所以每个,git,项目新建成功后，需要新增一个忽略文件。,两个文件都要这个给,git,项目的跟目录下，目录结构如下：,Tips,：,1.README,文件也是需要创建的文件。这个相当于项目的简介首页，可以记录项目的版本发布历程，代码规范，代码命名规范，代码目录结构说明等。,一,个项目中可以有多个,.md,文件,2.Gitignore,文件前面的“,.,”不要忽略，该文件是手动创建的,38,1,）,Eclipse Android,忽略实例,#built application files,*.,apk,*.,ap_,#,files for the dex VM,*.,dex,#,Java class files,*.,class,#,generated files,bin,/gen/,#,Eclipse,project,files,.,classpath,.,project,#,Proguard folder generated by Eclipse,proguard,/,#,Intellij project files,*.iws,.idea/workspace.,xml,.idea/tasks.xml,39,1,）,Xcode,开发忽略文件实例,.,DS_Store,build/*,*.xcuserdatad,Pods,*.xcuserstate,Podfile.lock,.name,xcode.xml,scope_settings.xml,workspace.xml,vcs.xml,encodings.xml,misc.xml,modules.xml,OrientFund.iml,#ignore svn document,.svn/*,40,Git Flow,实战,第十四章,41,1,）项目中必备分支,主干,分支,Master,：,随时可供在生产环境中部署的代码，建议伴有标签（,TAG,）,Develop,：,每天需要提交和合并的代码，功能逐渐完成的代码开发分支,辅助分支,Feature,：,新功能分支，辅助,develop,分支。主要用于实验性且效果不好的代码变更。或者用于项目组新成员接手开发新功能等,。分支可以合并到,develop,分支，或者直接丢弃。,命名,规范：,feature-,*,Release当基本版本完成，准备提交时到,APP Store,的等待时间，本分支可以做小,BUG,的修复。成功通过,APP Store,审核后，必须合并到,Master,分支，并记录标签（,Tag,），如果有,BUGfix,，则还需合并到,Develop,分支。此版本的作用是项目二期可以继续在,develop,分支开始开发。,命名规范：,release-*,Hotfix:,对于线上版本（,Master,分支）的,BUG,修改的辅助分支，必须合并回,master,分支和,develop,分支。,命名惯例：,hotfix-*,42,2,）工作流程图,创建项目,创建,Master,分支、,develop,分支,在,develop,分支不断开发和迭代版本,0.1,功能，如果有需要创建,feature,开发，则创建并最终选择是否合并到,develop,分支,Develop,分支的,0.1,版本开发完成，创建,release-0.1,分支，打包发布给测试人员测试，并进行在,develop,分支上继续开发,0.2,版本。,测试人员发现,release-0.1,版本,bug,，相关开发人员直接在该分支上修改，并打包给测试人员继续测试。其他人员继续在,develop,分支开发新功能。,V0.1,测试完成，发给用户查看，打包,release-0.1,给用户。用户如果有需要修改的需求或者,BUG,，项目经理把需求和,BUG,分开。需求问题需要告知客户,要,等下一个小版本。比较小的,BUG,问题，选择性的修改或者放到下一版本。如果用户要求一定要看到修改，则一定要合并到,develop,分支。,同,上一,步骤，发布,release-0.2,版本，此时可以删除,release-0.1,分支。直到最后发布,release-1.0,版本后。,Develop,理论上可以继续开发,二,期功能。,Release-1.0,版本跟进回归测试的,bug,，最终确定发布，并通过,APP Store,审核以后，把,release-1.0,合并到,develop,分支和,Master,分支，并添加一个标签,Tag,（,V1.0,）,如果有,1.0,版本上线以后，发现了一下,BUG,，则需要通过,Tag1.0,创建一个分支,hotfix-issue001,进行修复，知道提交审核通过，把分支合并到,Master,分支和,develop,分支，并给,Master,添加标签（,V,实际版本号）,43,