some changes for docker setup (#9)

* added SIGTERM handler for graceful docker shutdown

* added error message

* added example for bitcoind running on the host undockered

* added docker-compose and extended example

* added docker-compose section to README

* addes some note for rpcallowip

* added restart policy

* added DB folder for persistent data

* added $NETWORK as prefix for database path to not get in conflict with testnet setup

* used env variables for stratum and api ports

.env.example

@@ -1,4 +1,10 @@
+# bitcoin node running in your private network 192.168.1.0/24
 BITCOIN_RPC_URL=http://192.168.1.100
+
+# bitcoin node running undockered on the same PC
+# needs to add rpcallowip=172.16.0.0/12 to your bitcoin.conf
+#BITCOIN_RPC_URL=http://host.docker.internal
+
 BITCOIN_RPC_USER=
 BITCOIN_RPC_PASSWORD=
 BITCOIN_RPC_PORT=8332

README.md

@@ -53,14 +53,37 @@ Build container:
 $ docker build -t public-pool .
 ```
 
-Run container (with default configuration):
+Run container:
-
-```bash
-$ docker container run --name public-pool --rm -p 3333:3333 -p 3334:3334 -p 8332:8332 public-pool
-```
-
-Run container (with custom configuration):
 
 ```bash
 $ docker container run --name public-pool --rm -p 3333:3333 -p 3334:3334 -p 8332:8332 -v .env:.env public-pool
 ```
+
+### Docker Compose
+
+Build container:
+```bash
+$ docker compose build
+```
+
+Run container:
+```bash
+$ docker compose up -d
+```
+
+The docker-compose binds to `127.0.0.1` by default. To expose the Stratum services on your server change:
+```diff
+    ports:
+-      - "127.0.0.1:3333:3333/tcp"
+-      - "127.0.0.1:3334:3334/tcp"
++      - "3333"
++      - "3334"
+```
+
+**note**: To successfully connect to the bitcoin RPC you will need to add
+
+```
+rpcallowip=172.16.0.0/12
+```
+
+to your bitcoin.conf.

docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3.8'
+
+services:
+  public-pool:
+    container_name: public-pool
+    build:
+      context: .
+      dockerfile: Dockerfile
+    restart: unless-stopped
+    extra_hosts:
+      - "host.docker.internal:host-gateway"
+    ports:
+      - "127.0.0.1:${STRATUM_PORT}:${STRATUM_PORT}/tcp"
+      - "127.0.0.1:${API_PORT}:${API_PORT}/tcp"
+    volumes:
+      - "./${NETWORK}-DB:/public-pool/DB"
+      - "./.env:/public-pool/.env:ro"
+    environment:
+      - NODE_ENV=production
+

src/main.ts

@@ -43,6 +43,11 @@ async function bootstrap() {
     process.exit(0);
   });
 
+  process.on('SIGTERM', () => {
+    console.log(`Stopping services`);
+    process.exit(0);
+  });
+
   app.enableCors();
   useContainer(app.select(AppModule), { fallbackOnErrors: true });
 

src/services/bitcoin-rpc.service.ts

@@ -60,7 +60,7 @@ export class BitcoinRpcService {
                 }
             });
         } catch (e) {
-            console.log('Error getblocktemplate');
+            console.error('Error getblocktemplate:' ,e.message);
             throw new Error('Error getblocktemplate');
         }
         console.log(`getblocktemplate tx count: ${result.transactions.length}`);
@@ -71,7 +71,7 @@ export class BitcoinRpcService {
         try {
             return await this.client.getmininginfo();
         } catch (e) {
-            console.log('Error getmininginfo');
+            console.error('Error getmininginfo', e.message);
             return null;
         }