CERN Drupal Distribution
A Composer package that defines the CERN Drupal Distribution: Drupal and a set of core modules, that are the common denominator of all websites deployed in the CERN Drupal service.
This composer project relies on an upstream recommended setup for Drupal sites. More info in cern-drupal-distribution-composer-project.md.
Customizing the composer project of my website
First refer to the DrupalSite docs.
Extra composer packages can be injected to a website by linking the DrupalSite to a git repo with a composer.json.
The injection happens with a source-to-image mechanism, triggered when the DrupalSite is deployed.
Sitebuilder/nginx images
This composer project is deployed through a sitebuilder image. Each DrupalSite instantiated at the CERN Drupal service deploys a sitebuilder and an nginx container.
The rest of the images directory includes configuration to build the images. The image tags depend on the release process
Versioning and Release
The precise contents of the images currently running a Drupal site can be linked to this repo.
Each branch in this repo starting with the letter v* is a stable version branch.
The branch's name corresponds to the spec.version.name field in the DrupalSite.
For a standard user, this is all that is needed to instantiate the Drupal site: the latest release (commit)
of the specified branch will be deployed automatically.
The resolved/currently running release (version + releaseSpec) can be found in DrupalSite.status.releaseID.current.
The following section gives a detailed description of the GitOps workflow of this repo.
GitOps (details)
The tip of the repo's history is the master branch.
At each point in time we also have some supported version branches (v8.9-1, v8.9-2 in this example):
master v8.9-2 v8.9-1
|
| | dev8.9-1-secfix3
|<----- |
|
|
| | | ----->|
| ------>|
| | (backported security fix)
|
|
| ------------->|
|
| dev-myfeature
|<--- |
| |
| --->|
|For each commit in a version branch the corresponding image tag is: <branch>-RELEASE.<date>
Development
Development happens on the master branch using feature branches (dev-myfeature in the example above).
Backporting happens in feature branches (dev8.9-1-secfix3) that branch out from the version branches.
Each non-version branch produces image tags with each commit of the format <branch>-<commit-sha>.
Testing
Eventually, CI should run a test suite for every commit against the drupal-stg cluster. CI should be a normal user that creates a DrupalSite with this version/release and runs tests against it.