1. Git 快速入门
----------------------------

1.1 Git 环境准备
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

局域网访问GitLab仓库
============================

**注册账户**

GitLab 服务器IP 196.168.110.103

可直接访问 https://192.168.110.103/


.. image:: image/gitlab001.png
	:alt: gitlab001.png
	:align: center

点击高级，选择继续访问

.. image:: image/gitlab002.png
	:alt: gitlab002.png
	:align: center

跳转到登录页面，第一次访问需要注册账号。点击下方Register进入注册页面。

.. image:: image/gitlab003.png
	:alt: gitlab003.png
	:align: center

注册账号时，建议用自己的名字，方便管理。
注：邮箱可自定义(格式： xxx@xxx.com)，不要与gitee和github上的邮箱重复。

.. image:: image/gitlab004.png
	:alt: gitlab004.png
	:align: center

注册完毕通知管理员分配权限。

**修改 hosts 文件**

在系统目录 C:\Windows\System32\drivers\etc 添加 hosts 文件

文件内容如下：


.. code-block:: sh

    192.168.110.103 gitlab.example.com


保存，即可通过 https://gitlab.example.com/ 访问仓库

公网访问GitLab仓库
============================

直接通过 https://81.71.148.58:4433/ 访问仓库 4433 为端口

或在 C:\Windows\System32\drivers\etc 添加 hosts 文件，文件内容如下：

.. code-block:: sh

    139.159.225.105 gitlab.example.com


保存，即可通过 https://gitlab.example.com:4433/ 访问仓库

安装 Git 软件
============================

`Git 客户端下载 <https://www.git-scm.com/downloads>`_

默认安装就OK，一般装完后鼠标右键菜单会增加 Git GUI Here/Git Bash Here，

Git Bash Here 就是 Windows 下命令行工具，界面如下：

.. image:: image/quickstart002.png
	:alt: quickstart002.png
	:align: center

配置 SSH
============================

打开 git 工具，输入如下内容，其他全部默认，

.. code-block:: sh

    ssh-keygen -t rsa -C 'xxx@xxx.com' 
    //xxx@xxx.com为你的邮箱


然后我们找到生成的SSH秘钥，将其添加到 github/gitee 上，。

.. code-block:: sh

    cd ~/.ssh //切换目录 默认在/c/Users/xxx/ xxx为计算机用户名
    ls //可以看到id_rsa id_rsa.pub id_rsa.pub为公钥
    cat id_rsa.pub //将输出内容拷贝粘贴到 git-->设置-->SSH公钥 github/gitee/gitlab 都差不多


.. image:: image/quickstart003.png
	:alt: quickstart003.png
	:align: center

1.2 Git Quick Start
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Git 是 Linus Torvalds 为了帮助管理 Linux内核开发而开发的一个开放源码的版本控制软件。 

Git 是一个开源的分布式版本控制系统，用于敏捷高效地处理任何或小或大的项目。

Git 与常用的版本控制工具 CVS, Subversion等不同，它采用了分布式版本库的方式，不必服务器端软件支持。 

Git 不仅仅是个版本控制系统，它也是个内容管理系统(CMS)，工作管理系统等，写书写博客、机械、电子。

Git 工作流程
============================

我们通过git软件将本地代码仓库和远端仓库关联起来，通过命令行实现代码上传下载、版本控制。

.. image:: image/quickstart001.png
	:alt: quickstart001.png
	:align: center

克隆已有仓库
============================

首先需要在git客户端登录，

.. code-block:: sh

    //xxx为你 github/gitee/gitlab 账户
    git config --global user.name "xxx"
    //xxx@xxx.com为你注册 github/gitee/gitlab 使用的邮箱
    git config --global user.email "xxx@xxx.com" 


然后打开 git bash 执行克隆仓库命令如下，git clone + 仓库地址（可以是https也可以是ssh）：

.. code-block:: sh

    git clone git@gitlab.example.com:lumicare/doc/gitlab.git

.. image:: image/quickstart004.png
	:alt: quickstart004.png
	:align: center
 

至此仓库克隆完成。你可以在这个仓库对文件进行增删改查，并同步到GitLab服务器。

创建新仓库
============================

进入自己有权限的组，点击 new project 。 

.. image:: image/createwarehouse001.png
	:alt: createwarehouse001.png
	:align: center

创建空仓库，

.. image:: image/createwarehouse002.png
	:alt: createwarehouse002.png
	:align: center

填写仓库相关的信息，点击创建即可。

.. image:: image/createwarehouse003.png
	:alt: createwarehouse003.png
	:align: center

空白仓库如下所示：

.. image:: image/createwarehouse004.png
	:alt: createwarehouse004.png
	:align: center

点击 clone ，复制仓库地址，

.. image:: image/createwarehouse005.png
	:alt: createwarehouse005.png
	:align: center

使用 git 客户端即可克隆新建的仓库。

.. image:: image/createwarehouse006.png
	:alt: createwarehouse006.png
	:align: center

提交拉取代码
============================

.. code-block:: sh

    # 添加改动
    git add . 
    # 添加commit
    git commit -m "xxxxx" //xxxxx为你提交的注释
    # 提交代码，将本地仓库提交到服务器
    git push

.. code-block:: sh

    # 拉取代码，将服务器仓库的代码同步到本地
    git pull