infra-faucet/README.md

# Description

This repo defines infrasctructure for Rinkeby and Ropsten Ethereum faucets.

The endpoints are:

* https://faucet-rinkeby.status.im/
* https://faucet-ropsten.status.im/

# Requirements

In order to use this you will need secrets(passwords, certs, keys) contained within the [infra-pass](https://github.com/status-im/infra-pass) repository. If you can't see it ask jakub@status.im to get you access for it.

In order for this to work first you need to install necessary Terraform plugins and get the right secrets from the [infra-pass](https://github.com/status-im/infra-pass) repo, to do that simply run:
```
make
# alternatively
make plugins
make secrets
```
This will put the necessary certificates, keys, and passwords are in place so you can deploy and configure hosts.

# Usage

To deploy hosts simply:
```
terraform plan
terraform apply
```
Then configure hosts:
```
ansible-playbook ansible/main.yml
```

# Details

Read up on the roles:

* [faucet](ansible/roles/faucet) - Faucet API for distributing funds
* [geth-miner](ansible/roles/geth-miner) - Geth miner instance for collecting funds

Read the [Terraform and Ansible](https://github.com/status-im/infra-docs/blob/master/articles/ansible_terraform.md) article in our `infra-docs` repo.

# Links

* https://github.com/status-im/faucet
* https://github.com/ethereum/go-ethereum/wiki/Mining
* https://cloud.google.com/compute/pricing#predefined
* https://github.com/status-im/status-cluster/tree/master/roles/faucet
* https://github.com/status-im/status-cluster/blob/master/miner.yml