Installation

The application is provided as docker images that can easily be hosted either with docker-compose on a workload VM or via Helm Chart on a Kubernetes cluster. The images (web + nginx) are published to DockerHub and bin.swisscom.com.

Below we explain two differnet ways on how to install the ESC Scheduler.

Workload VM + Docker-Compose

Prerequisites

• An unmanaged RHEL 8 U1 machine in ESC (or similar)
• Docker and Docker-Compose installed on the VM
• Connectivity from the VM to ESC (vRA)
• Optional: Connectivity from the VM to an AD / LDAP server

Download & Install

1. On your server, create a folder (e.g. called vm-scheduler)

2. Download this docker-compose.yml file into that folder (right-click -> "Save as")

3. Create a file named .env within that folder with the following content:

   MYSQL_ROOT_PASSWORD=setAsecurePassword
   MYSQL_DATA_VOLUME_PATH=/tmp/vm_scheduler/mysqld
   SECRET_KEY=setArandomKey
   INITIAL_ADMIN_PASSWORD=admin
   INITIAL_USER_PASSWORD=password
   ALLOWED_HOSTS=localhost,yourdomain.com,0.0.0.0
   
   # OPTIONAL - for LDAP integration
   LDAP_SERVER_URI=
   LDAP_BASE_DN=
   LDAP_GROUP_DN=
   LDAP_SUPERUSER_GROUP_DN=
   LDAP_BIND_DN=
   LDAP_BIND_PASSWORD=
   LDAP_START_TLS=
   LDAP_IGNORE_CERT=
   LDAP_CERTIFICATE_PATH=
   LDAP_WITH_LOCAL_AUTH=
   

4. Change the values to your liking, see the configuration page for detailed information on each option.

5. Download & run the containers with the following command:

   docker-compose pull && docker-compose up -d
   

6. Visit the application at e.g. localhost:80 (-> make sure the host is set in DJANGO_ALLOWED_HOSTS).

This is an information message

No internet access?

If your workload VM has no internet access, you have to manually save, copy & load the docker images to your workload VM.

Kubernetes Cluster + HELM Chart

Prerequisites

• A PKS Kubernetes Cluster on the ESC
• A machine that has access to the Kubernetes Cluster via kubectl
• kubectl and Helm installed on that machine
• kubectl / kubeconfig configured to use your Kubernetes cluster
• Connectivity from the Kubernetes Cluster to ESC (vRA)
• Optional: Connectivity from the Kubernetes Cluster to an AD / LDAP server

Download & Install

1. Download the Helm Chart from the Github Repository.

2. Change the values.yaml to your liking, see the configuration page for detailed information on each option.

3. Run helm install -f values.yaml vmscheduler .

This is an information message

No internet access?

If your Kubernetes cluster has no internet access, you have to either manually save, copy & load the docker images onto your worker nodes or setup a private registry that has access to the docker images.