Feature: Add external database volume and external database connection

[nshandra]

📌 References

• Issue: Closes [d2-docker] External database storage or connection

📝 Implementation

Add parameters to d2-docker start to allow either:

• Store the DB in an external persistent volume
• Use an external DB instead of a container

Testing

External Persistent Volume Case

This case will store the DB volume at the specified absolute path.

./d2-docker-dev.sh --log-level=DEBUG start <data_image> --external-db-volume="/absolute/path/to/volume_dir"

External DB Case

This case needs a psql DB runnig in the machine hosting the dockers or in a accessible network.

This DB has to have the correct settings:

• /etc/postgresql/{ver}/main/postgresql.conf

  Set listen_addresses to:

  • '*' (easiest for testing)
  • 'localhost,172.17.0.1' (docker and DB in same system)
  • 'localhost,<reachable_ip>'

• /etc/postgresql/{ver}/main/pg_hba.conf

  Add an entry to allow the connection. Example:

  # Docker bridge subnet (check with: docker network inspect bridge)
  host    dhis2           dhis            172.17.0.0/16           scram-sha-256
  # LAN
  host    dhis2           dhis            192.168.0.0/24          scram-sha-256

Running d2-cloner:

./d2-docker-dev.sh --log-level=DEBUG start <data_image> --external-db-url="postgresql://user:pass@host:port/db"

#1ck80y8

[tokland]

@nshandra Sorry, I had this pending. Can you merge with development? (re-add me when done)

[nshandra]

@tokland done.

[tokland]

Features worked for me (only I had to add a trailing comma, probably a merge artifact)

In-line comments about the code:

[tokland]

All good as far as I can see and test 👍