## Documentation for deployment/upgrade/reset gear networks

For all operations we have workflows in github, which can be trigger manually or automatically by commit to master.

## *Vara-Network*

* **Build/Deploy**

This workflow builds a new gear binary for vara-network and deploys it on aws ec2 instances.

https://github.com/gear-tech/gear/blob/master/.github/workflows/CD-vara.yml

* **Deploy only**

This workflow only deploys last builded gear binary for vara-network on aws ec2 instances.

https://github.com/gear-tech/gear/blob/master/.github/workflows/vara-deploy-only.yml

* **Reset**

https://github.com/gear-tech/gear/actions/workflows/vara-reset-network.yml

This workflow deletes db and chain spec for vara-network for all aws ec2 instances, then deploys last builded gear binary for vara-network with new chain spec on aws ec2 instances.

> If you triger these workflows manually you need to choose vara-stage-1 branch in github.


For all playbooks in inventory listed ip hosts:

inventory: |
[gearNodes:children]
bootnode
nodes
[bootnode]
${{secrets.VARA_NODE}} name=vara-gear01 loki=yes loki_url=${{secrets.LOKI_URL}}
[nodes]
${{secrets.VARA_NODE_2}} name=vara-gear02 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.VARA_NODE_3}} name=vara-rpc-node rpc=yes unsafe=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.VARA_NODE_4}} name=vara-gear03 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.VARA_NODE_5}} name=vara-gear04 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}

So if you need to add/change/delete hosts please modify inventory in workflows

* **Backup** (In progress now)

https://github.com/gear-tech/builds/blob/master/.github/workflows/vara-backup.yml

Archive with db backup for download will be available here:

https://db.vara.rs/

## *Staging Testnet*

* **Build/Deploy** -

https://github.com/gear-tech/gear/actions/workflows/CD.yml

* **Upgrade-Runtime**

https://github.com/gear-tech/gear/actions/workflows/Runtime-upgrade-reset.yaml

* **Insert node keys**

https://github.com/gear-tech/gear/actions/workflows/CD-insert-keys.yml

> Also like for vara-network if you need to add/change/delete hosts please modify inventory in workflows

inventory: |
[gearNodes:children]
bootnode
nodes
[bootnode]
${{secrets.GEAR_NODE}} name=testnet-gear01 loki=yes loki_url=${{secrets.LOKI_URL}}
[nodes]
${{secrets.GEAR_NODE_2}} name=testnet-gear02 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.GEAR_NODE_3}} name=testnet-rpc-node rpc=yes unsafe=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.GEAR_NODE_4}} name=testnet-gear03 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.GEAR_NODE_5}} name=testnet-gear04 validator=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.ARCHIVE_NODE}} name=testnet-archive-node validator=yes archive_node=yes loki=yes loki_url=${{secrets.LOKI_URL}}
${{secrets.ARCHIVE_RPC_NODE}} name=testnet-archive-rpc-node rpc=yes unsafe=no archive_node=yes loki=yes loki_url=${{secrets.LOKI_URL}}