Skip to main content

Access via the OKD Web Interface

danger

This guide is for advanced users only. If you are not comfortable working through the terminal, editing code, or overriding default options, please do not proceed. If you are unsure whether you require the functionality outlined in this guide, please reach out via the community forums.

Accessing your project

  1. Access the OpenShift portal and login with your CERN account: https://drupal.cern.ch/k8s/cluster/projects.

  2. Select the project (i.e. website) whose WebDAV you wish to access.

Selecting a project via the OpenShift interface.

Selecting a project via the OpenShift interface.

  1. If not already selected, change to Administrator by clicking the drop-down menu on the left-hand side.

Selecting Administrator via the OpenShift interface.

Selecting Administrator via the OpenShift interface.

  1. Also in the menu on the left-hand side, unfold Operators and choose Installed Operators.

Selecting operators via the OpenShift interface.

Selecting Operators via the OpenShift interface.

  1. Click on Create Drupal Website (and validate that you are indeed in the correct project).

Selecting a project via the OpenShift interface.

Clicking 'Create Drupal Website' via the OpenShift interface.

The button may have a confusing name, but clicking it takes you to the following page with a list of current sites.

  1. Select "Current namespace only" and after select your website.

Selecting the website via the OpenShift interface.

Selecting the website via the OpenShift interface.

  1. Under the YAML tab at the top, you'll be able to edit specific configurations.

Selecting YAML via the OpenShift interface.

Running commands inside a specific website

  1. On the shown yaml, validate this is indeed the site you want to make your changes. This can be done by cross checking the "siteUrl" field ("spec" > "siteUrl"). If this includes the site you want to manage please memorize the field "metadata" > "name"

  2. Go on the page Workloads > Pods and filter by "Running". You'll reach a page with a url such as https://drupal.cern.ch/k8s/ns/my-site/core~v1~Pod?rowFilter-pod-status=Running. Select the one that starts with the "metadata" > "name" field you memorized above. Pods names follow the naming convention "drupalsite-name-hash-hash2".

For example, for a primary drupal site is named "my-site", there will be a matching pod named "my-site-7d596b9f58-mmctx". The hashes change frequently, please don't memorize them.

  1. Click on the pod selected and then select the Terminal tab. For example, the above leads me to https://drupal.cern.ch/k8s/ns/my-site/pods/my-site-7d596b9f58-mmctx/terminal

  2. On the dropdown "connecting to ... nginx" select php-fpm.

  3. You can now run any necessary commands inside. Common commands are "drush updb" to run all required updates, followed by "drush cr" to refresh caches.