Permalink
Browse files

openshift requirements

  • Loading branch information...
Schnitzel committed Dec 18, 2018
1 parent 107a140 commit e27121899fb899d3839316ccc2ca977819e92958
Showing with 33 additions and 0 deletions.
  1. +2 −0 docs/administering_lagoon/install.md
  2. +30 −0 docs/administering_lagoon/openshift_requirements.md
  3. +1 −0 mkdocs.yml
@@ -4,6 +4,8 @@ Lagoon is not only capable to deploy into OpenShift, it actually runs in OpenShi

Luckily we can use the local development environment to kickstart another Lagoon in any OpenShift, running somewhere in the world.

Check the [Requirements for OpenShift by Lagoon](/administering_lagoon/openshift_requirements.md) before continuing.

This process consists of 3 main stages, which are in short:

1. Configure existing OpenShift
@@ -0,0 +1,30 @@
# OpenShift Requirements by Lagoon

Lagoon tries to run on a standard installation of OpenShift as possible, but it expects some things:


### OpenShift Version

Currently Lagoon is tested and supported with OpenShift 3.9.

### Permissions

In order to setup Lagoon in an OpenShift you need a cluster-admin account to run the initial setup via `make lagoon-kickstart`. With this Lagoon will create it's own Roles and Permissions and the cluster-admin is not needed anymore.

### PV StorageClasses

For deployment projects by Lagoon the following StorageClasses will be needed:

| Name | Used for | Description |
| -----| ------ |------|
| default | Single Pod mounts (mariadb, solr) | The default StorageClass will be used for any single pod mounts like mariadb, solr, etc. Suggested to use SSD based Storage |
| `bulk` | multi pod mounts (drupal files) | `bulk` StorageClass will be used whenever a project requests storage that needs to be mounted into multiple pods at the same time. Like nginx-php-persistent which will mount the same PVC in all nginx-php pods. Suggested to be on SSD but not required. |

Lagoon itself will create PVCs with the following StorageClasses:

| Name | Used for | Description |
| -----| ------ |------|
| `lagoon-elasticsearch` | `logs-db` | `logs-db` will create PVCs with the storageClass name `lagoon-elasticsearch` for persistent storage of the elasticsearch. Standard deployments of `logs-db` create an Elasticsearch Cluster with 3 `live` nodes. Strongly suggested to be on SSD. |
| `lagoon-logs-db-archive` | `logs-db` | Beside the `live` nodes, `logs-db` also creates 3 `archive` nodes. These are used for elasticsearch data which is older than 1 month. Therefore it should be much bigger than `lagoon-elasticsearch` but can run on regular HDD. |
| `lagoon-logs-forwarder` | `logs-forwarder` | Used by `logs-forwarder` fluentd to provide a persistent buffer. Default configurations of Lagoon create 3 `logs-forwarder` pods. Preferred to be on SSD, but not needed. |

@@ -35,6 +35,7 @@ pages:
- From amazee.io: using_lagoon/migrations/amazeeio.md
- Administration:
- Installing Lagoon: administering_lagoon/install.md
- OpenShift Requirements: administering_lagoon/openshift_requirements.md
- GraphQL API: administering_lagoon/graphql_api.md
- Development:
- Developing Lagoon: developing_lagoon/index.md

0 comments on commit e271218

Please sign in to comment.