Commit 80d7d65b authored by Konstantinos Samaras-Tsakiris's avatar Konstantinos Samaras-Tsakiris
Browse files

Merge branch '2-document-how-to-create-a-new-drupalsite-with-extra-composer-modules' into 'master'

Add docs for site creation with extra config repo

Closes #2

See merge request !2
parents 9722e52c e9121328
......@@ -77,16 +77,13 @@ Environment allows you to define alternative instances of the website with diffe
Version refers to the version and release of the CERN Drupal Distribution that will be deployed to serve this website. Changing this value triggers the website's update process.
* **Name**: Select the desired version of the branch of CERN Drupal Distribution.
* **Release Spec**: Specify the desired release version. The available releases are:
- `RELEASE-2021.06.16T08-09-55Z`
- `RELEASE-2021.06.07T21-48-18Z`
- `RELEASE-2021.06.01T15-27-02Z`
* **Release Spec**: Specify the release version. The available release is: `RELEASE-2021.06.16T08-09-55Z`.
![Screenshot](images/openshift_console-create_drupalsite_version_fill.png)
---
#### 8. Click on `Create` button
#### 9. Click on `Create` button
![Screenshot](images/openshift_console-create_button.png)
......
<div data-theme-toc="true"> </div>
# Creating a drupal site with extra drupal modules
You can create a drupal site with extra drupal modules by following a few simple steps.
For adding extra drupal modules to your site, you'll need to use:
- [Composer](https://getcomposer.org/): A tool for managing dependencies in PHP.
- A [GitLab repository](https://gitlab.cern.ch/help/user/project/repository/index.md): A place to store your code and change it with version control.
Note that this is the recommended workflow for adding drupal modules to your website, because you can fetch dependencies automatically and keep the website versioned.
This functionality will eventually be expanded to include site configuration as well. If you would like to add drupal modules without composer or git, please read [WebDAV file access]() guide. (available soon)
#### 1. Create a repository with `composer.json`
Every module that you want to install has to be included as a composer dependency. This can be done in two ways:
- by adding manually the right line in [composer.json](https://gitlab.cern.ch/drupal/paas/example-drupalsite-d8-extraconfig/-/blob/master/composer.json) under `require`.
- by running `composer require <module>`.
Afer, you need to create a repository and add the `composer.json` file, e.g. https://gitlab.cern.ch/drupal/paas/example-drupalsite-d8-extraconfig.git.
#### 2. Follow the [Creating a drupal site](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121) guide till [Step 7](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#7-click-on-environment-to-expand-the-options-panel-with-the-default-settings-9)
#### 3. Fill the `Extra configs repo` field
![Screenshot](images/openshift_console-create_drupalsite_extraconfig_repo.png)
---
#### 4. Continue with [Step 8](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#8-click-on-version-to-expand-the-options-panel-with-the-default-settings-10) and [Step 9](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121#9-click-on-create-button-11) of the [Creating a drupal site](https://drupal-community.web.cern.ch/t/creating-a-drupal-site/1121) guide
Your drupal site is ready.
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment