marcelovani/drupalci
This is an alternative to DrupalCi that runs on Docker containers
3.2K
marcelovani/drupalci repository overview
DrupalCi
Runs Drupal webtests and php unit tests using Docker containers. This can be used with Git webhooks but its not ready yet.
Usage examples
The parameters for the runtests.php script are:
- --project Project or module name
- --version Project version or branch name [optional]. The format is the same as used in Composer
- --vcs Fork url [optional]
- --profile Drupal install profile [optional]
- --patches Specifies a list of patches to be applied. See example below.
- --dependencies List of test dependencies [optional] i.e. "drupal/link:* drupal/email:^1.0"
Drupal 9
Run tests from the a released version of AdsTxt module
docker pull marcelovani/drupalci:9-apache
docker run --name drupalci --rm marcelovani/drupalci:9-apache \
--project adstxt \
--version ^1.0.0
Drupal 8
Run tests from the a released version of Captcha Keypad module
docker pull marcelovani/drupalci:8-apache
docker run --name drupalci --rm marcelovani/drupalci:8-apache \
--project captcha_keypad \
--version ^1.0.0
Drupal 7
docker pull marcelovani/drupalci:7-apache
docker run --name drupalci --rm marcelovani/drupalci:7-apache \
--project captcha_keypad \
--version ^1.0.0
Interactive mode
The container will not run tests automatically. It is useful to perform manual tasks for the purposes of debugging.
Starting the server
docker run --rm --name drupalci -p 8080:80 -d marcelovani/drupalci:8-apache-interactive
Using a mounted folder for a custom module, in this example we are using adstxt module
docker run --rm --name drupalci -v ~/adstxt:/var/www/html/web/modules/contrib/adstxt -p 8080:80 -d marcelovani/drupalci:9-apache-interactive
Getting into the container
docker exec -it drupalci bash
Running tests manually
cd web
sudo -u www-data php core/scripts/drupal install minimal
sudo -u www-data php core/scripts/run-tests.sh --php /usr/local/bin/php --verbose --keep-results --color --concurrency "32" --repeat "1" --types "Simpletest,PHPUnit-Unit,PHPUnit-Kernel,PHPUnit-Functional" --sqlite sites/default/files/.ht.sqlite --url http://localhost --directory "modules/contrib/adstxt"
Opening in the browser
open http://localhost:8080
Stopping the container
docker stop drupalci
Forks and branches
To run tests from the a forked branch you can use --version with the branch. See Non feature branches. You can also specify the repository using --vcs.
docker pull marcelovani/drupalci:8-apache
docker run --name drupalci --rm marcelovani/drupalci:8-apache \
--project captcha_keypad \
--version dev-8.x-1.x \
--vcs https://github.com/marcelovani/captcha_keypad.git
Patches
You can provide a list of patches to be applied to the project.
docker pull marcelovani/drupalci:7-apache
docker run --name drupalci --rm marcelovani/drupalci:7-apache \
--project amp \
--version dev-1.x \
--patches https://www.drupal.org/files/issues/2019-02-11/amp-initial-page-load-3031306-18.patch
For multiple patches, each Url needs to be separated by comma.
docker run --name drupalci --rm marcelovani/drupalci:7-apache \
--project captcha_keypad \
--version dev-1.x \
--patches "https://www.example.com/fix-1.patch, https://www.example.com/fix-2.patch"
Dependencies
Used to install test dependencies or any additional package.
docker run --name drupalci --rm marcelovani/drupalci:7-apache \
--project amp \
--version dev-1.x \
--dependencies "drupal/media:* \
drupal/ctools:* \
drupal/token:* \
drupal/google_analytics:* \
drupal/dfp:* \
drupal/context:* \
drupal/adsense:*"
Checking the results
You can mount the verbose folder using -v, then you can see the generated output.
docker run -v ~/Downloads/artifacts:/artifacts --name drupalci --rm marcelovani/drupalci:8-apache \
--project sharerich \
--version dev-1.x \
--dependencies "drupal/token:*"
ls ~/Downloads/artifacts
Using is on your project
Copy the .circleci folder into your module, remame config.yml.example to config.yml and enable Circle CI for your project. When you make commits it will automatically trigger the build an you will be able to access the verbose results via Artifacts tab on Circle CI.
This is standard Docker stuff
Building images
make build
Building and deploying
make deploy
Jenkins
You can use these images on jenkins to automate your buildings
Tag summary
Content type
Image
Digest
sha256:131c5ca9c…
Size
341.8 MB
Last updated
about 1 month ago
docker pull marcelovani/drupalci:12-apache-interactive