Cosmos-- 二.Gaia -- 11.部署你自己的测试网

cosmos主网即将上线，对文档做了大量更新。特地翻译了一下，方便小伙伴们阅览, 之后会持续更新

第二章Gaia:

1. Gaia是什么
2. 安装Gaia
3. 加入公共测试网
4. 在测试网中运行一个验证人
5. 验证人概览
6. 验证人安全
7. 验证人相关问题
8. 委托人指南(命令行操作)
9. Ledger Nano支持
10. Gaia客户端
11. 部署你自己的测试网

部署你自己的测试网

这篇文章介绍了三种创建gaiad节点的测试网的方式，每种针对不同的使用场景：

1. 单节点，本地的，手动的测试网
2. 多节点，本地的，自动的测试网
3. 多节点，远程的，自动的测试网

支持代码可以在networks目录中找到，还可以在local或remote子目录中找到。

注意：remote网络引导教程可能与最新版本不同步，不可完全依赖。

单节点，本地的，手动的测试网

本教程可帮助你创建一个在本地运行网络的验证人节点，以进行测试和其他相关的用途。

需要

• 安装gaia
• 安装 jq(可选的)

创建genesis文件并启动网络

# You can run all of these commands from your home directory
cd $HOME

# Initialize the genesis.json file that will help you to bootstrap the network
gaiad init --chain-id=testing testing

# Create a key to hold your validator account
gaiacli keys add validator

# Add that key into the genesis.app_state.accounts array in the genesis file
# NOTE: this command lets you set the number of coins. Make sure this account has some coins
# with the genesis.app_state.staking.params.bond_denom denom, the default is staking
gaiad add-genesis-account $(gaiacli keys show validator -a) 1000stake,1000validatortoken

# Generate the transaction that creates your validator
gaiad gentx --name validator

# Add the generated bonding transaction to the genesis file
gaiad collect-gentxs

# Now its safe to start `gaiad`
gaiad start

启动将会把gaiad相关的所有数据放在~/.gaiad目录。你可以检查所创建的genesis文件——~/.gaiad/config/genesis.json。同时gaiacli也已经配置完成并且有了一个拥有token的账户(stake和自定义的代币)。

多节点，本地的，自动的测试网

在networks/local目录中运行如下命令:

需要

• 安装gaia
• 安装docker
• 安装docker-compose

编译

编译gaiad二进制文件(linux)和运行localnet命令所需的tendermint/gaianode docker images。这个二进制文件将被安装到container中，并且可以更新重建image，因此您只需要构建一次image。

# Work from the SDK repo
cd $GOPATH/src/github.com/cosmos/cosmos-sdk

# Build the linux binary in ./build
make build-linux

# Build tendermint/gaiadnode image
make build-docker-gaiadnode

运行你的测试网

运行一个拥有4个节点的测试网络:

make localnet-start

此命令使用gaiadnode image创建了一个4节点网络。每个节点的端口可以在下表中找到：

Node ID	P2P Port	RPC Port
gaianode0	26656	26657
gaianode1	26659	26660
gaianode2	26661	26662
gaianode3	26663	26664

更新二进制文件，只需要重新编译并重启节点:

make build-linux localnet-start

配置

make localnet-start命令通过调用gaiad testnet命令在./build中创建了一个4节点测试网络的文件。输出./build目录下一些文件:

$ tree -L 2 build/
build/
├── gaiacli
├── gaiad
├── gentxs
│   ├── node0.json
│   ├── node1.json
│   ├── node2.json
│   └── node3.json
├── node0
│   ├── gaiacli
│   │   ├── key_seed.json
│   │   └── keys
│   └── gaiad
│       ├── ${LOG:-gaiad.log}
│       ├── config
│       └── data
├── node1
│   ├── gaiacli
│   │   └── key_seed.json
│   └── gaiad
│       ├── ${LOG:-gaiad.log}
│       ├── config
│       └── data
├── node2
│   ├── gaiacli
│   │   └── key_seed.json
│   └── gaiad
│       ├── ${LOG:-gaiad.log}
│       ├── config
│       └── data
└── node3
    ├── gaiacli
    │   └── key_seed.json
    └── gaiad
        ├── ${LOG:-gaiad.log}
        ├── config
        └── data

每个./build/nodeN目录被挂载到对应container的/gaiad目录。

日志输出

日志被保存在每个./build/nodeN/gaiad/gaia.log文件中。你也可以直接通过Docker来查看日志：

docker logs -f gaiadnode0

密钥&账户

你需要使用指定节点的gaiacli目录作为你的home来同gaiacli交互，并执行查询或者创建交易:

gaiacli keys list --home ./build/node0/gaiacli

现在账户已经存在了，你可以创建新的账户并向其发送资金！

提示

注意：每个节点的密钥种子放在./build/nodeN/gaiacli/key_seed.json中，可以通过gaiacli keys add --restore命令来回复。

特殊的二进制文件

如果你具有多个不同名称的二进制文件，则可以使用BINARY环境变量指定要运行的二进制文件。二进制文件的路径是相对于挂载的卷。例如：

# Run with custom binary
BINARY=gaiafoo make localnet-start

多节点，远程的，自动的测试网

应该从networks目录运行下面的命令。

Terraform & Ansible

使用Terraform在AWS上创建服务器然后用Ansible创建并管理这些服务器上的测试网来完成自动部署。

前提

• 在一台Linux机器上安装Terraform和Ansible
• 创建一个具有EC2实例创建能力的ASW API token
• 创建SSH密钥

export AWS_ACCESS_KEY_ID="2345234jk2lh4234"
export AWS_SECRET_ACCESS_KEY="234jhkg234h52kh4g5khg34"
export TESTNET_NAME="remotenet"
export CLUSTER_NAME= "remotenetvalidators"
export SSH_PRIVATE_FILE="$HOME/.ssh/id_rsa"
export SSH_PUBLIC_FILE="$HOME/.ssh/id_rsa.pub"

创建一个远程网络

SERVERS=1 REGION_LIMIT=1 make validators-start

测试网络的名称将由--chain-id定义，集群的名称则是AWS中服务器管理标识。该代码将在每个可用区中创建服务器数量的服务器，最多为REGION_LIMIT，从us-east-2开始。（us-east-1被排除在外）下面的BaSH脚本也是如此，但更便于输入。

./new-testnet.sh "$TESTNET_NAME" "$CLUSTER_NAME" 1 1

快速查询状态入口

make validators-status

删除服务器

make validators-stop

日志输出

你可以将日志发送到Logz.io，一个Elastic栈（Elastic搜索，Logstash和Kibana）服务提供商。你可以将节点设置为自动登录。创建一个帐户并从此页面上的说明中获取你的API密钥，然后：

yum install systemd-devel || echo "This will only work on RHEL-based systems."
apt-get install libsystemd-dev || echo "This will only work on Debian-based systems."

go get github.com/mheese/journalbeat
ansible-playbook -i inventory/digital_ocean.py -l remotenet logzio.yml -e LOGZIO_TOKEN=ABCDEFGHIJKLMNOPQRSTUVWXYZ012345

监控

你可以安装DataDog代理：

make datadog-install