How do I package a distribution on Drupal.org?

Question

I am getting some old and mixed documentation issues with building a release for a Drupal 8-based distribution Drupal.org.

The main documentation is How to package a distribution on Drupal.org, which says to use drush make to create a drupal-org.make file. However, when I try to run this command on my site, I get the following error message.

Make has been removed, in favor of Composer. Use the make-convert command in Drush 8 to quickly upgrade your build to Composer.

That's fine, since I am already using Composer for the project! But how do I actually then publish these dependencies on Drupal.org? Drupal.org is definitely not reading the composer.json file, and building the zip files.

Do I just have to manually make a git tag which includes all the files in the *vendoré directory, so that Drupal.org knows to build this?

I am running Drush version 9.5.2.

Answer 1

On Drupal.org, there isn't yet support for a distribution composer.json file, as reported on Support for distributions.

The package system used from Drupal.org, to be able to build the package files for a distribution, requires just two files: drupal-org.make and drupal-org-core.make. The latter is only necessary when using a Drupal release that is not official.

If your system doesn't allow you to create a .make file as required from Drupal.org, you can manually create it with any text editor, as long as you use the correct file format (see Example drupal.org make file), and you follow what reported in Drupal.org distribution packaging requirements. In particular, see the notes reported at the beginning.

• External libraries are validated against a whitelist of GPL-compatible libraries since all code distributed from Drupal.org must be GPL compatible
• Git clones from Drupal.org sandboxes (as opposed to full projects) are not supported
• Patches hosted on servers other than Drupal.org are not supported
• Modules and themes hosted on servers other than Drupal.org are not supported
• If you need to specify anything other than an official release of the Drupal core project itself, that needs to go into a separate drupal-org-core.make file
• If you request a specific Git revision you must also define the branch that revision came from

In future, some of those restrictions could be lift. There are feature requests / bugs opened in the packages.drupal.org issue queue.