2022-09-19 16:16:05 +02:00
{
"$schema" : "http://json-schema.org/draft/2020-12/schema" ,
2022-09-20 10:27:23 +02:00
"$id" : "embedfs://config.schema.json" ,
2022-09-19 16:16:05 +02:00
"title" : "cc-backend configuration file schema" ,
"type" : "object" ,
2023-04-18 07:43:21 +02:00
"properties" : {
2022-09-19 16:16:05 +02:00
"addr" : {
"description" : "Address where the http (or https) server will listen on (for example: 'localhost:80')." ,
"type" : "string"
} ,
"user" : {
"description" : "Drop root permissions once .env was read and the port was taken. Only applicable if using privileged port." ,
"type" : "string"
} ,
"group" : {
"description" : "Drop root permissions once .env was read and the port was taken. Only applicable if using privileged port." ,
"type" : "string"
} ,
"disable-authentication" : {
"description" : "Disable authentication (for everything: API, Web-UI, ...)." ,
"type" : "boolean"
} ,
"embed-static-files" : {
"description" : "If all files in `web/frontend/public` should be served from within the binary itself (they are embedded) or not." ,
"type" : "boolean"
} ,
"static-files" : {
"description" : "Folder where static assets can be found, if embed-static-files is false." ,
"type" : "string"
} ,
"db-driver" : {
"description" : "sqlite3 or mysql (mysql will work for mariadb as well)." ,
"type" : "string" ,
"enum" : [
"sqlite3" ,
"mysql"
]
} ,
"db" : {
"description" : "For sqlite3 a filename, for mysql a DSN in this format: https://github.com/go-sql-driver/mysql#dsn-data-source-name (Without query parameters!)." ,
"type" : "string"
} ,
"job-archive" : {
2023-04-18 07:43:21 +02:00
"description" : "Configuration keys for job-archive" ,
"type" : "object" ,
"properties" : {
"kind" : {
"description" : "Backend type for job-archive" ,
"type" : "string" ,
"enum" : [
"file" ,
"s3"
]
} ,
"path" : {
"description" : "Path to job archive for file backend" ,
"type" : "string"
} ,
2023-05-09 09:34:03 +02:00
"compression" : {
"description" : "Setup automatic compression for jobs older than number of days" ,
"type" : "integer"
} ,
2023-04-18 07:43:21 +02:00
"retention" : {
"description" : "Configuration keys for retention" ,
"type" : "object" ,
"properties" : {
"policy" : {
"description" : "Retention policy" ,
"type" : "string" ,
"enum" : [
"none" ,
"delete" ,
"move"
]
} ,
2023-05-11 09:40:13 +02:00
"includeDB" : {
"description" : "Also remove jobs from database" ,
"type" : "boolean"
} ,
2023-05-09 09:34:03 +02:00
"age" : {
"description" : "Act on jobs with startTime older than age (in days)" ,
2023-04-18 07:43:21 +02:00
"type" : "integer"
} ,
2023-05-09 09:34:03 +02:00
"location" : {
2023-04-18 07:43:21 +02:00
"description" : "The target directory for retention. Only applicable for retention move." ,
"type" : "string"
}
} ,
"required" : [
"policy"
]
}
} ,
"required" : [
"kind"
]
2022-09-19 16:16:05 +02:00
} ,
"disable-archive" : {
"description" : "Keep all metric data in the metric data repositories, do not write to the job-archive." ,
"type" : "boolean"
} ,
"validate" : {
"description" : "Validate all input json documents against json schema." ,
"type" : "boolean"
} ,
"session-max-age" : {
"description" : "Specifies for how long a session shall be valid as a string parsable by time.ParseDuration(). If 0 or empty, the session/token does not expire!" ,
"type" : "string"
} ,
"jwt-max-age" : {
"description" : " S p e c i f i e s f o r h o w l o n g a J W T t o k e n s h a l l b e v a l i d a s a s t r i n g p a r s a b l e b y t i m e . P a r s e D u r a t i o n ( ) . I f 0 o r e m p t y , t h e s e s s i o n / t o k e n d o e s n o t e x p i r e ! " ,
"type" : "string"
} ,
"https-cert-file" : {
"description" : "Filepath to SSL certificate. If also https-key-file is set use HTTPS using those certificates." ,
"type" : "string"
} ,
"https-key-file" : {
"description" : "Filepath to SSL key file. If also https-cert-file is set use HTTPS using those certificates." ,
"type" : "string"
} ,
"redirect-http-to" : {
"description" : "If not the empty string and addr does not end in :80, redirect every request incoming at port 80 to that url." ,
"type" : "string"
} ,
"stop-jobs-exceeding-walltime" : {
"description" : "If not zero, automatically mark jobs as stopped running X seconds longer than their walltime. Only applies if walltime is set for job." ,
"type" : "integer"
} ,
2023-03-01 16:34:59 +01:00
"short-running-jobs-duration" : {
"description" : "Do not show running jobs shorter than X seconds." ,
"type" : "integer"
} ,
2022-09-19 16:16:05 +02:00
"" : {
"description" : "" ,
"type" : "string"
} ,
"ldap" : {
"description" : "For LDAP Authentication and user synchronisation." ,
"type" : "object" ,
"properties" : {
"url" : {
"description" : "URL of LDAP directory server." ,
"type" : "string"
} ,
"user_base" : {
"description" : "Base DN of user tree root." ,
"type" : "string"
} ,
"search_dn" : {
"description" : "DN for authenticating LDAP admin account with general read rights." ,
"type" : "string"
} ,
"user_bind" : {
"description" : "Expression used to authenticate users via LDAP bind. Must contain uid={username}." ,
"type" : "string"
} ,
"user_filter" : {
"description" : "Filter to extract users for syncing." ,
"type" : "string"
} ,
"sync_interval" : {
"description" : "Interval used for syncing local user table with LDAP directory. Parsed using time.ParseDuration." ,
"type" : "string"
} ,
"sync_del_old_users" : {
"description" : "Delete obsolete users in database." ,
"type" : "boolean"
}
} ,
"required" : [
"url" ,
"user_base" ,
"search_dn" ,
"user_bind" ,
"user_filter"
]
} ,
"clusters" : {
"description" : "Configuration for the clusters to be displayed." ,
"type" : "array" ,
"items" : {
"type" : "object" ,
"properties" : {
"name" : {
"description" : "The name of the cluster." ,
"type" : "string"
} ,
"metricDataRepository" : {
"description" : "Type of the metric data repository for this cluster" ,
"type" : "object" ,
"properties" : {
"kind" : {
"type" : "string" ,
"enum" : [
2022-11-05 08:22:44 +01:00
"influxdb" ,
2022-09-19 16:16:05 +02:00
"prometheus" ,
2022-09-20 12:21:20 +02:00
"cc-metric-store" ,
"test"
2022-09-19 16:16:05 +02:00
]
} ,
"url" : {
"type" : "string"
} ,
"token" : {
"type" : "string"
}
} ,
"required" : [
"kind" ,
"url"
]
} ,
"filterRanges" : {
"description" : "This option controls the slider ranges for the UI controls of numNodes, duration, and startTime." ,
"type" : "object" ,
"properties" : {
"numNodes" : {
"description" : "UI slider range for number of nodes" ,
"type" : "object" ,
"properties" : {
"from" : {
"type" : "integer"
} ,
"to" : {
"type" : "integer"
}
} ,
"required" : [
"from" ,
"to"
]
} ,
"duration" : {
"description" : "UI slider range for duration" ,
"type" : "object" ,
"properties" : {
"from" : {
"type" : "integer"
} ,
"to" : {
"type" : "integer"
}
} ,
"required" : [
"from" ,
"to"
]
} ,
"startTime" : {
"description" : "UI slider range for start time" ,
"type" : "object" ,
"properties" : {
"from" : {
"type" : "string" ,
"format" : "date-time"
} ,
"to" : {
"type" : "null"
}
} ,
"required" : [
"from" ,
"to"
]
}
} ,
"required" : [
"numNodes" ,
"duration" ,
"startTime"
]
}
} ,
"required" : [
"name" ,
"metricDataRepository" ,
"filterRanges"
] ,
"minItems" : 1
}
} ,
"ui-defaults" : {
"description" : "Default configuration for web UI" ,
"type" : "object" ,
"properties" : {
"plot_general_colorBackground" : {
"description" : "Color plot background according to job average threshold limits" ,
"type" : "boolean"
} ,
"plot_general_lineWidth" : {
"description" : "Initial linewidth" ,
"type" : "integer"
} ,
"plot_list_jobsPerPage" : {
"description" : "Jobs shown per page in job lists" ,
"type" : "integer"
} ,
"plot_view_plotsPerRow" : {
"description" : "Number of plots per row in single job view" ,
"type" : "integer"
} ,
"plot_view_showPolarplot" : {
"description" : "Option to toggle polar plot in single job view" ,
"type" : "boolean"
} ,
"plot_view_showRoofline" : {
"description" : "Option to toggle roofline plot in single job view" ,
"type" : "boolean"
} ,
"plot_view_showStatTable" : {
"description" : "Option to toggle the node statistic table in single job view" ,
"type" : "boolean"
} ,
"system_view_selectedMetric" : {
"description" : "Initial metric shown in system view" ,
"type" : "string"
} ,
"analysis_view_histogramMetrics" : {
"description" : "Metrics to show as job count histograms in analysis view" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
} ,
"analysis_view_scatterPlotMetrics" : {
"description" : "Initial scatter plto configuration in analysis view" ,
"type" : "array" ,
"items" : {
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 2 ,
"maxItems" : 2
} ,
"minItems" : 1
}
} ,
"job_view_nodestats_selectedMetrics" : {
"description" : "Initial metrics shown in node statistics table of single job view" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
} ,
"job_view_polarPlotMetrics" : {
"description" : "Metrics shown in polar plot of single job view" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
} ,
"job_view_selectedMetrics" : {
"description" : "" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
} ,
"plot_general_colorscheme" : {
"description" : "Initial color scheme" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
} ,
"plot_list_selectedMetrics" : {
"description" : "Initial metric plots shown in jobs lists" ,
"type" : "array" ,
"items" : {
"type" : "string" ,
"minItems" : 1
}
}
} ,
"required" : [
"plot_general_colorBackground" ,
"plot_general_lineWidth" ,
"plot_list_jobsPerPage" ,
"plot_view_plotsPerRow" ,
"plot_view_showPolarplot" ,
"plot_view_showRoofline" ,
"plot_view_showStatTable" ,
"system_view_selectedMetric" ,
"analysis_view_histogramMetrics" ,
"analysis_view_scatterPlotMetrics" ,
"job_view_nodestats_selectedMetrics" ,
"job_view_polarPlotMetrics" ,
"job_view_selectedMetrics" ,
"plot_general_colorscheme" ,
2023-03-01 16:34:59 +01:00
"plot_list_selectedMetrics"
2022-09-19 16:16:05 +02:00
]
}
} ,
"required" : [
"clusters"
]
}
