Workspace Configuration Options
Deleted records
| Key | Type | Description | Default value |
|---|---|---|---|
DELETED_ACTIVITY_EXPIRY_ENABLED | bool | Move ended executions to the trash bin after a timeout. | true |
DELETED_ACTIVITY_EXPIRY_TIME_MINUTES | int | The number of minutes before an ended execution will be moved to the trash bin. | 20160 |
DELETED_RETENTION_TIME_ACTIVITIES_ENABLED | bool | Permanently delete activities from the trash bin after a timeout. | true |
DELETED_RETENTION_TIME_ACTIVITIES_MINUTES | int | The number of minutes before activities are permanently deleted from the trash bin. | 20160 |
DELETED_RETENTION_TIME_RESOURCES_ENABLED | bool | Permanently delete resources from the trash bin after a timeout. | true |
DELETED_RETENTION_TIME_RESOURCES_MINUTES | int | The number of minutes before resources are permanently deleted from the trash bin. | 20160 |
Email integration
| Key | Type | Description | Default value |
|---|---|---|---|
SMTP_CHARSET | str | The charset being used to encode email messages. | utf-8 |
SMTP_FROM | str | The email address used in the "from" field of outgoing messages. | Cloudomation info@cloudomation.com |
SMTP_HOST | str | The host to use to send emails. | |
SMTP_PASSWORD | password | The password to authenticate against the SMTP host. | |
SMTP_PORT | int | The port to connect to at SMTP_HOST. | 25 |
SMTP_USER | str | The username to authenticate against the SMTP host. | |
SMTP_USE_STARTTLS | bool | If to use the STARTTLS command to upgrade an unencrypted SMTP connection. | false |
SMTP_USE_TLS | bool | If to use transport-layer-security (TLS) to connect to the SMTP host. | false |
Git integration
| Key | Type | Description | Default value |
|---|---|---|---|
GIT_SYNC_REFRESH_INTERVAL_MINUTES | int | The number of minutes to wait between pulling changes from git. | 10 |
Logging
| Key | Type | Description | Default value |
|---|---|---|---|
LOGGING_EXPIRY_ENABLED | bool | Permanently remove log entries after a timeout. | true |
LOGGING_EXPIRY_TIME_MINUTES | int | The number of minutes before log entries are permanently removed. | 20160 |
Notifications
| Key | Type | Description | Default value |
|---|---|---|---|
NOTIFY_DISK_USAGE_CHECK_ENABLED | bool | Notify about disk usage exceeding configured limits. | true |
NOTIFY_DISK_USAGE_CHECK_INTERVAL_MINUTES | int | The number of minutes to wait between checks of disk usage. | 60 |
NOTIFY_DISK_USAGE_FREE_GIB_ERROR_LIMIT | int | If free disk space GiB is below this amount an error notification is generated. | 1 |
NOTIFY_DISK_USAGE_FREE_GIB_WARNING_LIMIT | int | If free disk space GiB is below this amount a warning notification is generated. | 5 |
NOTIFY_DISK_USAGE_PERCENT_ERROR_LIMIT | int | If disk usage exceeds this percentage an error notification is generated. | 90 |
NOTIFY_DISK_USAGE_PERCENT_WARNING_LIMIT | int | If disk usage exceeds this percentage a warning notification is generated. | 75 |
NOTIFY_LICENSE_CHECK_ENABLED | bool | Notify about license usage exceeding configured limits. | true |
NOTIFY_LICENSE_CHECK_INTERVAL_MINUTES | int | The number of minutes to wait between checks of license usage. | 1440 |
NOTIFY_LICENSE_CONNECTION_USAGE_PERCENT_ERROR_LIMIT | int | If connection usage exceeds this percentage an error notification is generated. | 100 |
NOTIFY_LICENSE_CONNECTION_USAGE_PERCENT_WARNING_LIMIT | int | If connection usage exceeds this percentage a warning notification is generated. | 90 |
NOTIFY_LICENSE_STORAGE_USAGE_PERCENT_ERROR_LIMIT | int | If storage usage exceeds this percentage an error notification is generated. | 100 |
NOTIFY_LICENSE_STORAGE_USAGE_PERCENT_WARNING_LIMIT | int | If storage usage exceeds this percentage a warning notification is generated. | 90 |
Security
| Key | Type | Description | Default value |
|---|---|---|---|
CAPTCHA_ALLOWED_HOST_NAMES | str | A comma-separated list of host names which are accepted as captcha sources. | localhost |
LOGIN_TOKEN_VALIDITY_HOURS | int | The maximum number of hours a user stays signed in before having to re-authenticate. | 720 |
User Interface
| Key | Type | Description | Default value |
|---|---|---|---|
MAX_OPEN_RECORDS_PER_PROJECT | int | The maximum number of records a user can have opened in each project. When this number is exceeded, the oldest opened record will be closed. | 7 |
MESSAGE_LIST_SUBMITTED_LIMIT | int | How many submitted messages to display in the messages popover | 10 |
MESSAGE_LIST_UNSUBMITTED_LIMIT | int | How many unsubmitted messages to display in the messages popover | 10 |
VISUALIZATION_MAX_NODES | int | The maximum number of nodes shown in the dependency visualization graph. | 200 |
VISUALIZATION_REFRESH_INTERVAL_SECONDS | int | The number of seconds between refreshes of the dependency visualization graph. | 5 |
Internals
| Key | Type | Description | Default value |
|---|---|---|---|
DB_KEEPALIVE_INTERVAL_SECONDS | int | The number of seconds to wait between checking database connectivity. | 20 |
DB_KEEPALIVE_TIMEOUT_SECONDS | int | The number of seconds after which a workspace process is considered "dead". | 60 |
DELETED_ACTIVITY_EXPIRY_BATCH_SIZE | int | How many expired activities to move to the trash bin at once. | 100 |
DELETED_ACTIVITY_EXPIRY_INTERVAL_MINUTES | int | The number of minutes to wait between checks for ended executions. | 5 |
DELETED_RETENTION_TIME_BATCH_SIZE | int | How many records to permanently delete from the trash bin at once. | 100 |
DELETED_RETENTION_TIME_INTERVAL_MINUTES | int | The number of minutes to wait between checks for permanently deleting records from the trash bin. | 100 |
EXECUTIONS_MAX_PARALLEL | int | The maximum number of executions one process is handling simultaneous. | 20 |
GRAPHQL_QUERY_COMPLEXITY_LIMIT | int | The maximum "cost" of a single graphql query. TODO: document how cost is calculated... | 2000 |
LOGGING_CURRENT_LEVELS | str | A comma-separated list of logger names, followed by a colon and a log-level. Possible log-levels are: * ERROR * WARNING * INFO * DEBUG * NOTSET: inherit the log level from the parent logger possible logger names include: (defaults are NOTSET unless specified otherwise) * <empty string>: the root logger. other loggers will inherit the flag from the root logger unless configured otherwise * sqlalchemy: all sqlalchemy logging. default level: WARN * sqlalchemy.engine: database queries * sqlalchemy.pool: database pool operations * aiohttprest: API * common: common methods * connector_types: Cloudomation connectors * connector_types.<connector_type>: a specific connector * resources: Cloudomation resources * resources.<resource name>: a specific resource * sarest: database layer * workspace: workspace processes * workspace.engine: the execution engine | :WARNING,cloudomation:INFO |
LOGGING_EXPIRY_BATCH_SIZE | int | How many log entries to remove at once. | 100 |
LOGGING_EXPIRY_INTERVAL_MINUTES | int | The number of minutes to wait between checks for expired log entries. | 5 |
LOGGING_FORMAT | str | One of "text" or "json". Setting LOGGING_FORMAT to "json" will produce machine-readable log lines. | text |
LOGGING_LEVELS_RESET_MINUTES | int | The number of minutes after which the configuration LOGGING_CURRENT_LEVELS is reset to the default value once it was changed. | 10 |
MEMORY_TRACING_FRAMES | int | Memory tracing frame count. Zero (0) disables tracing. | 0 |
MEMORY_TRACING_INTERVAL_SECONDS | int | How many seconds to wait before taking another snapshot. | 3600 |
MEMORY_TRACING_SAVE_DIRECTORY | str | The directory to save tracing dumps to. | /tmp |
RESUMER_CLEAN_ARCHIVED_EXECUTION_DUMPS_ENABLED | bool | Delete execution dumps of archived executions. | true |
RESUMER_CLEAN_ORPHANED_ACTIVITIES_ENABLED | bool | Delete partial activities. | true |
RESUMER_CLEAN_ORPHANED_IDENTITIES_ENABLED | bool | Delete partial identities. | true |
RESUMER_CLEAN_ORPHANED_RECORDS_ENABLED | bool | Delete partial records. | true |
RESUMER_CLEAN_ORPHANED_RESOURCES_ENABLED | bool | Delete partial resources. | true |
RESUMER_NOTIFY_LOST_EXECUTION_ENABLED | bool | Resume active executions after workspace restart. WARNING: disabling this will impact functionality of the workspace. | true |
RESUMER_NOTIFY_LOST_LOCK_ENABLED | bool | Resume executions waiting for a lock. WARNING: disabling this will impact functionality of the workspace. | true |
RESUMER_NOTIFY_LOST_SCHEDULE_ENABLED | bool | Ensure enabled schedules have a schedule execution. WARNING: disabling this will impact functionality of the workspace. | true |
RESUMER_NOTIFY_LOST_SYNC_CONFIG_ENABLED | bool | Resume executions waiting for a remote workspace. WARNING: disabling this will impact functionality of the workspace. | true |
RESUMER_POLL_DELAY_SECONDS | int | The number of seconds between activity checks. | 30 |
RESUMER_POLL_SLOW_DELAY_SECONDS | int | The number of seconds between database cleanup routine runs. | 1800 |
RESUMER_RESUME_SCHEDULED_ENABLED | bool | Resume executions waiting for a timeout. WARNING: disabling this will impact functionality of the workspace. | true |
SAVEPOINT_RETENTION | str | Savepoint retention behaviour. Possible values are: * ALL: keep all savepoints of an execution * LAST: keep the last implicit and all explicit savepoints. | LAST |
SCHEDULE_MIN_INTERVAL_FAILED_SECONDS | int | If a schedule fails to execute wait this many seconds before creating a new one. | 60 |
SCHEDULE_MIN_INTERVAL_SUCCEEDED_SECONDS | int | If a schedule succeeds wait this many seconds before creating a new one. | 60 |