Docker: adding basic compose support

Author: mmahut

Dockerfile

@@ -0,0 +1,10 @@
+FROM rust:1.45.2 as builder
+WORKDIR /usr/src/
+RUN git clone https://github.com/ergoplatform/oracle-core.git
+WORKDIR /usr/src/oracle-core
+RUN cargo build --release
+RUN cargo install --path .
+
+FROM rust:1.45.2-slim
+COPY --from=builder /usr/local/cargo/bin/oracle-core /usr/local/bin/oracle-core
+CMD ["oracle-core"]

README.md

@@ -60,8 +60,50 @@ In order for an oracle pool to run, it must be first created/bootstrapped on-cha
 
 Check out the [Bootstrap doc](docs/Bootstrap.md) for detailed instructions about how to bootstrap an oracle pool and each of the oracles within it.
 
+# Running An Oracle Using Docker Compose
+It's possible to setup an oracle cluster using docker compose. We do not recommend this deployment for production, unless you know what you are doing.
+
+1. Before bringing the cluster up, we need to update the `apiKeyHash` value inside `docker/ergo.conf`. This key will be used for interaction with the API.
+
+2. After that is done, we can bring up the cluster.
+
+```
+docker-compose up -d
+```
+
+3. It will take a while until our Ergo `node` sync the blockchain. After it is done, we need to restore our wallet using the API key defined in the first step. As you can see, we need to define a wallet password as well.
+
+```
+$ curl -XPOST -H "api_key: hello" \
+       -d '{"pass": "123", "mnemonic": "all all all..."}' \
+       -H  "accept: application/json" \
+       -H  "Content-Type: application/json" \
+       http://localhost:9053/wallet/restore
+"OK"
+```
+
+4. Now we need to unlock the wallet using the password we defined in the step above.
+
+```
+$ curl -XPOST -H "api_key: hello" \
+       -d '{"pass": "123"}' \
+       -H  "accept: application/json" \
+       -H  "Content-Type: application/json" \
+       http://localhost:9053/wallet/unlock
+"OK"
+```
+
+5. Verify your wallet is on the tip and has some balance in it.
+
+```
+$ curl -XGET -H "api_key: hello" \
+       -H "accept: application/json" \
+       -H  "Content-Type: application/json" \
+       http://localhost:9053/wallet/balances
+```
+
 
 # Writing A New Connector
 If you are looking to create a new Oracle Pool for a new datapoint, you need to write a new Connector. This process has been greatly simplified thanks to [`Connector-lib`](connectors/connector-lib).
 
-Now within 15-20 lines of Rust code, you can easily create your own Connector that plugs right in to the Oracle Core.
+Now within 15-20 lines of Rust code, you can easily create your own Connector that plugs right in to the Oracle Core.

connectors/erg-usd-connector/Dockerfile

@@ -0,0 +1,10 @@
+FROM rust:1.45.2 as builder
+WORKDIR /usr/src/
+RUN git clone https://github.com/ergoplatform/oracle-core.git
+WORKDIR /usr/src/oracle-core/connectors/erg-usd-connector
+RUN cargo build --release
+RUN cargo install --path .
+
+FROM rust:1.45.2-slim
+COPY --from=builder /usr/local/cargo/bin/erg-usd-connector /usr/local/bin/erg-usd-connector
+CMD ["erg-usd-connector"]

docker-compose.yml

@@ -0,0 +1,34 @@
+version: "3"
+
+volumes:
+  ergo_node_storage:
+
+services:
+  node:
+    image: ergoplatform/ergo:v3.3.0
+    restart: unless-stopped
+    volumes:
+      - "ergo_node_storage:/home/ergo/.ergo"
+      - "${PWD}/docker/ergo.conf:/etc/ergo.conf"
+    command: --mainnet -c /etc/ergo.conf
+    ports:
+     - 9030:9030
+     - 9053:9053
+
+  oracle-core:
+    build: .
+    restart: unless-stopped
+    network_mode: "host"
+    volumes:
+      - "${PWD}/docker/oracle-config.yaml:/oracle-config.yaml"
+    depends_on:
+      - node 
+
+  erg-usd-connector:
+    build: connectors/erg-usd-connector/
+    restart: unless-stopped
+    network_mode: "host"
+    volumes:
+      - "${PWD}/docker/oracle-config.yaml:/oracle-config.yaml"
+    depends_on:
+      - oracle-core

docker/ergo.conf

@@ -0,0 +1,17 @@
+ergo {
+  directory = ${ergo.directory}"/.ergo"
+  node {
+    mining = false
+  }
+  wallet.secretStorage.secretDir = ${ergo.directory}"/wallet/keystore"
+}
+
+scorex {
+ restApi {
+    # Hex-encoded Blake2b256 hash of an API key. 
+    # Should be 64-chars long Base16 string.
+    # below is the hash of the string 'hello'
+    # replace with your actual hash 
+    apiKeyHash = "324dcf027dd4a30a932c441f365a25e86b173defa4b8e58948253471b81b72cf"
+  }
+}

docker/oracle-config.yaml

@@ -0,0 +1 @@
+../oracle-config.yaml