ubuntu部署cita

一，具体介绍安装的网址：https://docs.nervos.org/cita/#/

二，平台，建议使用ubuntu 18.04，使用docker部署cita。其中docker必须安装在64位的机器上，目前不支持32位的。

　　　2.1　　ubuntu 18.04安装docker步骤

　　　　　　2.1.1 　　卸载旧版本，其中旧版本的Docker被称为dokcer-engine或者docker　　　　

$ sudo apt-get remove docker 
               docker-engine 
               docker.io

　　　　　　2.1.2 　　由于 apt 源使用 HTTPS 以确保软件下载过程中不被篡改。因此，我们首先需要添加使用 HTTPS 传输的软件包以及 CA 证书。

$ sudo apt-get update

$ sudo apt-get install 
    apt-transport-https 
    ca-certificates 
    curl 
    software-properties-common

　　　　　　2.1.3　　为了确认所下载软件包的合法性，需要添加软件源的 GPG 密钥。

$ curl -fsSL https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu/gpg | sudo apt-key add -

　　　　　　2.1.4　　然后，我们需要向 source.list 中添加 Docker 软件源

$ sudo add-apt-repository 
    "deb [arch=amd64] https://mirrors.ustc.edu.cn/docker-ce/linux/ubuntu 
    $(lsb_release -cs) 
    stable"

　　　　 2.1.5 　　更新 apt 软件包缓存，并安装 docker-ce：

$ sudo apt-get update

$ sudo apt-get install docker-ce

　　2.2　　官网上接受可以使用脚本来安装docker，但是安装过程很慢。

$ curl -fsSL get.docker.com -o get-docker.sh
$ sudo sh get-docker.sh --mirror Aliyun

　　2.3　　可以配置国内镜像加速来加快docker拉取镜像的速度

　　　　　　2.3.1　　对于使用 systemd 的系统，请在 /etc/docker/daemon.json 中写入如下内容（如果文件不存在请新建该文件）（如果你没有增删改／etc／docker／的权限，使用 sudo chmod -R 777 docker来改变docker文件夹的权限。然后可以使用vim编辑daemon.json ， vi不好用）。　　　

{
  "registry-mirrors": [
    "https://registry.docker-cn.com"
  ]
}

　　　　　　然后重启docker服务器　　　　

$ sudo systemctl daemon-reload
$ sudo systemctl restart docker

　　　　2.3.2　　检查加速器是否生效，在命令行执行 sudo docker info ，如果在命令行出现如下内容，说明配置成功　　　　　　

Registry Mirrors:
 https://registry.docker-cn.com/

三， 获取Docker镜像：https://hub.docker.com/r/cita/cita-build/

　　　在命令行执行 sudo docker pull cita/cita-build

四， 获取cita源码

　　从 Github 仓库下载 CITA 的源代码，然后切换到 CITA 的源代码目录（安装git的方法：）

git clone https://github.com/cryptape/cita.git
cd cita
git submodule init
git submodule update

五，编译，有两种方式，在cita源代码的根目录下执行　　　

　　sudo ./env.sh make debug

　　或者

　　sudo  ./env.sh make release

　　这个过程很慢，需要等待一段时间。那编译生成的文件在目录target/install下，生产环境下只需要这个目录即可。

六，生成节点配置

　　 　　首先切换到如下目录　　　　　

　　　　　　cd target/install

　　　　文件create_cita_config.py使用生成节点配置文件的。可以执行下面的命令生成一个demo，demo中有4个本地节点

sudo ./env.sh ./scripts/create_cita_config.py create --nodes "127.0.0.1:4000,127.0.0.1:4001,127.0.0.1:4002,127.0.0.1:4003"

　　配置节点 ：

　　sudo  ./env.sh ./bin/cita setup test-chain/0

　　启动节点：　　

sudo  ./daemon.sh ./bin/cita start test-chain/0

　　终止节点运行：　　

sudo  ./env.sh ./bin/cita stop test-chain/0

七，测试

　　除了上述的基本操作命令，为了方便用户对 Demo 进行相关测试，我们在目录cita/tests/integreate_test下提供了一些测试脚本。以下命令在源码根目录下运行。

　　启动四个节点：　　

sudo   ./env.sh tests/integrate_test/cita_start.sh

　　终止四个节点：

sudo  ./env.sh ./tests/integrate_test/cita_stop.sh　

　　基本功能测试：4 个节点启动并成功出块，基本功能测试然后停止 4 个节点：　　　

sudo  ./env.sh ./tests/integrate_test/cita_basic.sh

　　发送交易测试：

sudo  ./env.sh ./tests/integrate_test/cita_transactiontest.sh

　　模拟网络异常情况下的功能测试：

sudo  ./env.sh ./tests/integrate_test/cita_byzantinetest.sh