|
1 | | -# Substrate-based Validator Node Ansible Setup |
| 1 | +# Cosmos-based Node Ansible Setup |
| 2 | + |
| 3 | +This repo is to set up the Cosmos-based node. It currently support: |
| 4 | + |
| 5 | +- Juno (mainnet and testnet) |
| 6 | +- Sifchain (betanet and testnet) |
| 7 | +- Evmos (testnet) |
| 8 | + |
| 9 | +## Summary |
| 10 | + |
| 11 | +You run one playbook and set up a node. For example: |
| 12 | + |
| 13 | +```bash |
| 14 | +ansible-playbook -i inventory juno_full_setup.yml -e "target=juno_testnet" |
| 15 | +``` |
| 16 | + |
| 17 | +But before you rush with this easy setup, you probably want to read on so you understand the structure of this Ansible program and all the features it offers. |
| 18 | + |
| 19 | +## Some Preparations |
| 20 | + |
| 21 | +First, make sure that you have a production inventory file with your confidential server info. You will start by copying the sample inventory file (included in the repo). The sample file gives you a good idea on how to define the inventory. |
| 22 | + |
| 23 | +```bash |
| 24 | +cp inventory.sample inventory |
| 25 | +``` |
| 26 | + |
| 27 | +Needless to say, you need to update the dummy values in the inventory file. For each node, you need to update the server IP. While you are free to keep the default, you might also want to update: |
| 28 | + |
| 29 | +1. ansible_user: The sample file assumes `ubuntu`. |
| 30 | +2. ansible_port: The sample file assumes `22`. But if you are like me, you will have a different ssh port other than `22` to avoid port sniffing. |
| 31 | +3. ansible_ssh_private_key_file: The sample file assumes `~/.ssh/id_rsa`, but you might have a different key location. |
| 32 | +4. log_monitor: Enter your monitor server IP. It is most likely a private IP address if you use a firewall around your private virtual cloud (VPC). |
| 33 | + |
| 34 | +It is beyond the scope of this guide to help you create a sudo user, alternate ssh port, create a private key, install Ansible on your machine, etc. You can do a quick online search and find the answers. In my experience, Digital Ocean have some quality guides on these topics. Stack Overflow can help you trouble-shoot if you are stuck. |
| 35 | + |
| 36 | +## Basic Cluster Structure |
| 37 | + |
| 38 | +The basic cluster structure is: |
| 39 | + |
| 40 | +1. Name each juno node as `juno_testnet`, `juno_mainnet`, etc. Group all Juno nodes into `juno` group. |
| 41 | +2. Name each juno node as `sifchain_testnet`, `sifchain_mainnet`, etc. Group all Sifchain nodes into `sifchain` group. |
| 42 | +3. ... |
| 43 | + |
| 44 | +The structure allows you to target `vars` to each node, or a group cluster, or the whole cluster. Make sure that you are familiar with the files in the `group_vars` folder. They follow this clustered structure closely. |
| 45 | + |
| 46 | +## Main Playbook |
| 47 | + |
| 48 | +The key Ansible playbook is `xxxxx_full_setup.yml` files. It will set up a fresh node from scratch. For example: |
| 49 | + |
| 50 | +```bash |
| 51 | +ansible-playbook -i inventory sifchain_full_setup.yml -e "target=sifchain_betanet" |
| 52 | +``` |
| 53 | + |
| 54 | +## Some Useful Commands |
| 55 | + |
| 56 | +block height |
2 | 57 |
|
3 | 58 | ```bash |
4 | 59 | watch -n 60 -d "curl -s http://localhost:26657/status | jq -r .result.sync_info.latest_block_height" |
5 | | -curl -s localhost:26657/net_info | jq -r .result.peers[].node_info.moniker |
| 60 | +``` |
| 61 | + |
| 62 | +Connected Peers |
| 63 | + |
| 64 | +```bash |
| 65 | +curl -s localhost:26657/net_info | jq -r '.result.peers[] | .node_info.moniker, .node_info.id, .node_info.listen_addr, .remote_ip' |
| 66 | +``` |
| 67 | + |
| 68 | +Check logs and cosmovisor status |
| 69 | + |
| 70 | +```bash |
| 71 | +journalctl -u cosmovisor.service -f |
6 | 72 | journalctl -u cosmovisor.service -f | grep "committed" |
7 | 73 | systemctl status cosmovisor |
8 | | -curl -s localhost:26657/net_info | jq -r '.result.peers[] | .node_info.moniker, .node_info.id, .node_info.listen_addr, .remote_ip' |
9 | | -curl -s localhost:26657/net_info | jq -r .result.peers[].node_info.moniker |
10 | | -watch -n 2 " curl -s localhost:26657/net_info | jq -r '.result.n_peers'" |
11 | 74 | ``` |
12 | 75 |
|
| 76 | +Sifchain: create validator |
| 77 | + |
| 78 | +```bash |
| 79 | +sifnoded tx staking create-validator \ |
| 80 | + --amount 1000000000000000000000rowan \ |
| 81 | + --commission-max-change-rate "0.01" \ |
| 82 | + --commission-rate "0.02" \ |
| 83 | + --commission-max-rate "0.1" \ |
| 84 | + --min-self-delegation "1" \ |
| 85 | + --website "https://polkachu.com" \ |
| 86 | + --identity "0A6AF02D1557E5B4" \ |
| 87 | + --details "Polkachu is the trusted staking service provider for blockchain projects. 100% refund for downtime slash. Contact us at [email protected]" \ |
| 88 | + --pubkey=$(sifnoded tendermint show-validator) \ |
| 89 | + --moniker 'Polkachu' \ |
| 90 | + --chain-id sifchain-1 \ |
| 91 | + --gas-adjustment="1.5" \ |
| 92 | + --gas="200000" \ |
| 93 | + --fees 100000000000000000rowan \ |
| 94 | + --from polkachu |
13 | 95 | ``` |
| 96 | + |
| 97 | +Sifchain: Delegate |
| 98 | + |
| 99 | +```bash |
| 100 | +sifnoded tx staking delegate sifvaloper1gp957czryfgyvxwn3tfnyy2f0t9g2p4pfj2j90 420000000000000000000rowan \ |
| 101 | + --chain-id sifchain-1 \ |
| 102 | + --from=polkachu \ |
| 103 | + --gas-adjustment="1.5" \ |
| 104 | + --gas="200000" \ |
| 105 | + --fees 100000000000000000rowan |
| 106 | +``` |
| 107 | + |
| 108 | +```bash |
14 | 109 | junod tx staking create-validator \ |
15 | | - --amount 6000000ujunox \ |
16 | | - --commission-max-change-rate "0.1" \ |
17 | | - --commission-max-rate "0.20" \ |
18 | | - --commission-rate "0.1" \ |
19 | | - --min-self-delegation "1" \ |
20 | | - --details "This is my validator" \ |
21 | | - --pubkey=$(junod tendermint show-validator) \ |
22 | | - --moniker '[Polkachu] 1% fee' \ |
23 | | - --chain-id uni \ |
24 | | - --gas-prices 0.025ujunox \ |
25 | | - --from polkachu |
26 | | -``` |
27 | | - |
28 | | -junod tx staking edit-validator --website="https://polkachu.com" --from=polkachu --gas-prices="0.025ujunox" --chain-id=uni |
29 | | -junod tx staking delegate junovaloper1gp957czryfgyvxwn3tfnyy2f0t9g2p4pvzc6k3 1390000ujunox --chain-id=uni --from=polkachu --gas-prices="0.025ujunox" |
| 110 | + --amount 6000000ujunox \ |
| 111 | + --commission-max-change-rate "0.1" \ |
| 112 | + --commission-max-rate "0.20" \ |
| 113 | + --commission-rate "0.1" \ |
| 114 | + --min-self-delegation "1" \ |
| 115 | + --details "This is my validator" \ |
| 116 | + --pubkey=$(junod tendermint show-validator) \ |
| 117 | + --moniker '[Polkachu] 1% fee' \ |
| 118 | + --chain-id uni \ |
| 119 | + --gas-prices 0.025ujunox \ |
| 120 | + --from polkachu |
| 121 | +``` |
0 commit comments