From Source Code to Public Availability

Published by Christian Münch on

As user of n98-magerun you should be familiar with the easy self-upgrade command which is embedded in the tool. What’s not well known is the process behind any release of a new version. Since the tool is used in critical production environments, we added more and more steps to increase the stability and quality. This blog post describes who we release a new version.

Quality Assurance (QA)

If a new Pull Request on Github arrives or a new commit is pushed to develop or master branch, we start a Travis build job.

Travis CI Logo

Travis is a public available cloud CI-Server which is free for Open Source projects like n98-magerun. Travis itself is also an Open Source tool. Travis offers a paid plan for private projects. The company is based in Germany. So data protection according to GDRP is solved if you are from European Union. We use this service for free since years. So it’s fair to talk about Travis and their offered services.

If you are interested to see how the QA is configured… Have a look in the source code of our Github repo. The main entrypoint is the .travis.yml file.

The main purpose of the Travis jobs is to run automated tests against different Magento main versions to see if something breaks or is not compatible anymore.

Travis jobs of a git commit

Continuous Delivery (CI-CD)

I am a big fan of automation. Automation increases the quality as well. Any boring job which has to be done all the time should be automated. If something goes wrong, take it positive. This give you the change to optimize the automation process.

Any automation is triggered by a Github webhooks.
We use webhooks to start:

  • Packagist updates
  • Travis-CI pipeline
  • Drone-CI pipeline
Webhook triggers pipelines

As written before, we use Travis to run the tests. For new releases, we start a Drone-CI pipeline which creates a new phar file. The phar file will be signed via PGP. Then we upload the new phar file to the download portal and publish a new phar distribution as Composer package. Then we update the website with new version information, create a phive version, invalidate the CDN and send a success or failure E-Mail to notify me.

Successful drone-ci pipeline of a new n98-magerun2 release.


To receive data of a Github webhook, I wrote a small little tool in golang. It runs in a small Docker container and uses only ~13 Mbyte of memory. The purpose of the webhook proxy is to trigger a Drone-CI builds if necessary. There is a small piece of business logic which decides if a build should be triggered. We trigger a build if develop or a tag are pushed. If the develop branch is pushed, we create a “unstable” development version. If a tag is pushed, we create a new stable release.

I really like Drone-CI. For me the concept of Drone-CI is very lightweight and has the most integration of Docker to extend the pipeline by plugins.

Some month before we used Gitlab as CI. With drone-ci it was possible to speed up the process a lot. The complete build runs <1 minuten. We are so fast, because Drone-CI shares the “artifact folder” as Docker volume mount between all jobs in a pipeline.

Download Portal

The download portal is very important for you. This website is the place where we host all the phar files. Every download or update will be get the data from this website.

Last week, we got a request by Servebolt. They offered us a sponsorship for this critical infrastructure. That’s a really great news for all of us.

Servbolt Logo
Servebolt is a global hosting company, originated from Norway

During some hours we transferred everything into a cloud hosted, fully managed environment. The complete infrastructure is now managed via the backoffice of Servebolt. We have a simple PHP project but the company also offers special Magento hosting templates.

Servebold backoffice of

The complete setup and transfer of the website took only some hours. I used the interactive customer chat of Servebolt for interaction. The response times were really good.

Cloudflare CDN

The Servebolt sponsoring comes with a Cloudflare CDN integration. Servebolt is a official Cloudflare partner and so we use this service to cache all the phar files. This gives you the main adavantage to download the phar files from nearest server location.

The picture below show how much traffic we have with downloads. Most of the 271 GB/per week are phar files.

Traffic of week

It’s also interesting to see where most of the downloads come from.

Where downloads come from …


At this point we want to thank all the sponsors behind the tool.

  • netz98 – The company behind the tool
  • JetBrains – Thanks for sponsoring PhpStorm since years for contributors
  • Servebolt – Sponsor of the critical download infrastructure
  • Github – Thanks for hosting the code.
  • Travis – Thanks for running our tests
  • Drone-CI – Thanks for running the release jobs


Leave a Reply

Avatar placeholder

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.