ClusterCockpit/cc-docker
1
0
Fork 0
mirror of https://github.com/ClusterCockpit/cc-docker.git synced 2024-12-25 19:19:05 +01:00
Code Issues Packages Projects Releases Wiki Activity
A configurable docker compose setup for development and testing of ClusterCockpit
145 Commits 3 Branches 1 Tag 894 KiB
Shell 53.3%
Perl 33.5%
Dockerfile 12.4%
Makefile 0.8%
7d259dd1ba
Go to file
Christoph Kluge 7d259dd1ba Initial commit to rework cc-docker repo into development environment
2022-06-01 11:27:50 +02:00
.github reordered steps 2021-08-06 14:20:07 +02:00
cc-metric-store Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
data Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
templates Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
.gitignore Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
LICENSE Initial commit 2021-05-19 07:49:23 +02:00
README.md Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
setupDev.sh Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00
startDev.sh Initial commit to rework cc-docker repo into development environment 2022-06-01 11:27:50 +02:00

README.md

cc-docker

Please note: This repo is under ongoing construction

This is a docker-compose setup which provides a quickly started environment for ClusterCockpit development and testing, using the modules cc-backend (GoLang) and cc-frontend (Svelte). A number of services is readily available as docker container (nats, cc-metric-store, InfluxDB, LDAP), or easily added by manual configuration (MySQL).

It includes the following containers:

  • nats (Default)
  • cc-metric-store (Default)
  • influxdb (Optional)
  • openldap (Default)
  • mysql (Optional, Manual)
  • phpmyadmin (Optional, Manual)

The setup comes with fixture data for a Job archive, cc-metric-store checkpoints, InfluxDB, MySQL, and a LDAP user directory.

Known Issues

  • docker-compose installed on Ubuntu (18.04, 20.04) via apt-get can not correctly parse docker-compose.yml due to version differences. Install latest version of docker-compose from https://docs.docker.com/compose/install/ instead.
  • You need to ensure that no other web server is running on ports 8080 (cc-backend), 8081 (phpmyadmin), 8084 (cc-metric-store), 8086 (nfluxDB), 4222 and 8222 (Nats), or 3306 (MySQL). If one or more ports are already in use, you habe to adapt the related config accordingly.
  • Existing VPN connections sometimes cause problems with docker. If docker-compose does not start up correctly, try disabling any active VPN connection. Refer to https://stackoverflow.com/questions/45692255/how-make-openvpn-work-with-docker for further information.

Configuration Templates

Located in ./templates

  • docker-compose.yml.ccms: Docker-Compose file to setup cc-metric-store metric database and LDAP containers (Default). Used in setupDev.sh.
  • docker-compose.yml.influxdb: Docker-Compose file to setup influxDB metric database and LDAP containers. Used in setupDev.sh.
  • docker-compose.yml.mysql: Docker-Compose configuration template if additional MySQL and phpmyadmin containers are desired.
  • env.ccms: Environment variables for setup with cc-metric-store metric database and LDAP containers (Default). Used in setupDev.sh.
  • env.influxdb: Environment variables for setup with influxDB metric database and LDAP containers. Used in setupDev.sh.
  • env.mysql: Additional environment variables required if additional MySQL and phpmyadmin containers are desired.

Setup

  1. $ ./setupDev.sh [help|ccms|influxdb]: NOTICE The script will download files of a total size of 338MB (mostly for the InfluxDB data).

    • help: Displays help.
    • ccms: Copies according docker-compose.yml and env-file to root directory, downloads cc-metric-store checkpoint data, and builds containers.
    • influxdb: Copies according docker-compose.yml and env-file to root directory, downloads influxDB data, and builds containers.

  2. After that from the root of the cc-docker sandbox you can start up the containers and launch cc-backend with: $ ./startDev.sh

  3. By default, you can access cc-backend in your browser at http://localhost:8080. You can shut down the cc-backend server by pressing CTRL-C, remember to also shut down all containers via docker-compose down afterwards.

Usage

Credentials for the preconfigured demo user are:

  • User: demo
  • Password: AdminDev

You can also login as regular user using any credential in the LDAP user directory at ./data/ldap/users.ldif.

The job archive with 1867 jobs originates from the second half of 2020. Roughly 2700 jobs from the first week of 2021 are loaded with data from InfluxDB. Some views of ClusterCockpit (e.g. the Users view) show the last week or month. To show some data there you have to set the filter to time periods with jobs (August 2020 to January 2021).