8.0 KiB
部署你自己的测试网
这篇文章介绍了三种创建gaiad节点的测试网的方式，每种针对不同的使用场景：
- 单节点，本地的，手动的测试网
- 多节点，本地的，自动的测试网
- 多节点，远程的，自动的测试网
支持代码可以在networks目录中找到，还可以在local或remote子目录中找到。
注意：
remote网络引导教程可能与最新版本不同步，不可完全依赖。
可获取的Docker镜像
如果你需要使用或部署gaia作为容器，你可以跳过build步骤并使用官方镜像，$TAG标识你感兴趣的版本：
docker run -it -v ~/.gaiad:/root/.gaiad -v ~/.gaiacli:/root/.gaiacli tendermint:$TAG gaiad initdocker run -it -p 26657:26657 -p 26656:26656 -v ~/.gaiad:/root/.gaiad -v ~/.gaiacli:/root/.gaiacli tendermint:$TAG gaiad start- ...
docker run -it -v ~/.gaiad:/root/.gaiad -v ~/.gaiacli:/root/.gaiacli tendermint:$TAG gaiacli version
相同的镜像也可以用于构建你自己的docker-compose栈
单节点，本地的，手动的测试网
本教程可帮助你创建一个在本地运行网络的验证人节点，以进行测试和其他相关的用途。
需要
创建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) 1000000000stake,1000000000validatortoken
# 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目录中运行如下命令:
需要
编译
编译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"
terraform和ansible都会使用到。
创建一个远程网络
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