Skip to content

Latest commit

 

History

History
40 lines (35 loc) · 1.88 KB

CONTRIBUTING.md

File metadata and controls

40 lines (35 loc) · 1.88 KB
Raw

Contributing

  1. Create only head Dolibarr version for each Major release in file versions.sh.
  2. Keep only one Dockerfile.template file, use sed value replacement in update.sh
  3. Keep most up to date PHP version that matches each Dolibarr releases.
  4. Be careful about supported PHP versions, try to avoid deprecated PHP version, but only if it doesn't break rule #3.
  5. Run the update.sh script
  6. check the README.md, to ensure it is well formatted (on some environment Supported Tags could be broken)
  7. Commit all content in images directory
  8. Open a pull request with a polite and well described content ^_^

How to create images

All is done through the update.sh script, Dolibarr version to build are stored in versions.sh Ensure that the var DOLIBARR_VERSIONS in versions.sh is having all versions you want to build. Run the script.

Tips

You can ask the script to build and push version for you: just add DOCKER_BUILD=1 and DOCKER_PUSH=1 in command line.

$> DOCKER_BUILD=1 DOCKER_PUSH=1 ./update.sh

Test your local copy before PR

For convenience, you can use the test.sh script, it will build and run containers based on existing Dockerfile in images directory. (You'd better run update.sh before)

$> ./test.sh <DOLIBARR_VERSION> <PHP_VERSION>
  • DOLIBARR_VERSION : (Mandatory) the version you want to build and run.
  • PHP_VERSION : (Optional) the Dolibarr version with this PHP version you want to run specifically, if omitted it will use the most up to date PHP version.

If you want to run Dolibarr 14.0.3 with PHP 7.4

$> ./test.sh 14.0.3 7.4

If you want to run Dolibarr 14.0.3 with most up-to-date PHP version

$> ./test.sh 14.0.3

Here are links for running containers :