From c5638b98d72fd1fb0c71de03b4e9dd676b763ef2 Mon Sep 17 00:00:00 2001 From: Omar Date: Wed, 16 Sep 2026 02:51:15 +0300 Subject: [PATCH 1/3] [SER-2815] Expose the remote-URL downloader settings Document Engine 1.19.0 makes its remote-URL downloader configurable, so the chart needs the matching values. Without them a customer following the reference architecture cannot reach the new settings at all. Adds `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, mapped to `DOWNLOADER_WORKER_POOL_SIZE`, `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` and `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. Defaults match what Document Engine used while these were hardcoded, so an existing deployment is unaffected. Companion to https://linear.app/nutrient/issue/SER-2815 --- charts/document-engine/CHANGELOG.md | 5 + charts/document-engine/Chart.yaml | 2 +- charts/document-engine/README.md | 551 +++++++++--------- .../document-engine/templates/configmap.yaml | 3 + charts/document-engine/values.schema.json | 11 + charts/document-engine/values.yaml | 9 + 6 files changed, 306 insertions(+), 275 deletions(-) diff --git a/charts/document-engine/CHANGELOG.md b/charts/document-engine/CHANGELOG.md index 9ff8d71e..ad2655a7 100644 --- a/charts/document-engine/CHANGELOG.md +++ b/charts/document-engine/CHANGELOG.md @@ -1,6 +1,7 @@ # Changelog - [Changelog](#changelog) + - [8.7.0 (2026-09-16)](#870-2026-09-16) - [8.6.3 (2026-09-02)](#863-2026-09-02) - [8.6.2 (2026-09-01)](#862-2026-09-01) - [8.6.1 (2026-08-25)](#861-2026-08-25) @@ -241,6 +242,10 @@ - [2.0.0](#200) - [Changed](#changed-68) +## 8.7.0 (2026-09-16) + +* Added `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, which control how many documents Document Engine fetches from a remote URL at once per pod and how long a fetch waits for a free slot. Requires Document Engine 1.19.0 or later. Defaults match the values Document Engine used previously, so an existing deployment is unaffected. + ## 8.6.3 (2026-09-02) * Removed the note in the `Clustering` section calling it experimental. Clustering is supported. diff --git a/charts/document-engine/Chart.yaml b/charts/document-engine/Chart.yaml index 46f43f5b..739db98f 100644 --- a/charts/document-engine/Chart.yaml +++ b/charts/document-engine/Chart.yaml @@ -4,7 +4,7 @@ type: application description: Document Engine is a backend software for processing documents and powering automation workflows. home: https://www.nutrient.io/sdk/document-engine icon: https://cdn.prod.website-files.com/65fdb7696055f07a05048833/66e58e33c3880ff24aa34027_nutrient-logo.png -version: 8.6.3 +version: 8.7.0 appVersion: "1.18.1" keywords: diff --git a/charts/document-engine/README.md b/charts/document-engine/README.md index 2a47de9f..a59c8544 100644 --- a/charts/document-engine/README.md +++ b/charts/document-engine/README.md @@ -1,6 +1,6 @@ # Document Engine Helm chart -![Version: 8.6.3](https://img.shields.io/badge/Version-8.6.3-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: 1.18.1](https://img.shields.io/badge/AppVersion-1.18.1-informational?style=flat-square) +![Version: 8.7.0](https://img.shields.io/badge/Version-8.7.0-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: 1.18.1](https://img.shields.io/badge/AppVersion-1.18.1-informational?style=flat-square) Document Engine is a backend software for processing documents and powering automation workflows. @@ -404,55 +404,58 @@ Note: | Key | Description | Default | |-----|-------------|---------| | [`config`](./values.yaml#L82) | General configuration, see more in [our guide](https://www.nutrient.io/guides/document-engine/configuration/options/) | | -| [`config.allowDocumentGeneration`](./values.yaml#L187) | `ALLOW_DOCUMENT_GENERATION` | `true` | -| [`config.allowDocumentUploads`](./values.yaml#L181) | `ALLOW_DOCUMENT_UPLOADS` | `true` | -| [`config.allowRemoteAssetsInGeneration`](./values.yaml#L190) | `ALLOW_REMOTE_ASSETS_IN_GENERATION` | `true` | -| [`config.allowRemoteDocuments`](./values.yaml#L184) | `ALLOW_REMOTE_DOCUMENTS` | `true` | -| [`config.asyncAdmissionQueueLimits`](./values.yaml#L153) | `ASYNC_ADMISSION_QUEUE_LIMITS` — optional comma-separated queue limits, for example `default=100`. Missing queues are unlimited. | `none` | -| [`config.asyncAdmissionQueues`](./values.yaml#L148) | `ASYNC_ADMISSION_QUEUES` — comma-separated async queues accepted by this node. Set to an empty string to reject async operation admission. | `"default"` | -| [`config.asyncJobEncryption`](./values.yaml#L162) | Async job metadata encryption settings. | [...](./values.yaml#L162) | -| [`config.asyncJobEncryption.externalSecret`](./values.yaml#L172) | Use an external secret for `ASYNC_JOB_ENCRYPTION_KEYS` | [...](./values.yaml#L172) | -| [`config.asyncJobEncryption.externalSecret.key`](./values.yaml#L178) | Secret key name for the async job encryption keyring | `"ASYNC_JOB_ENCRYPTION_KEYS"` | -| [`config.asyncJobEncryption.externalSecret.name`](./values.yaml#L175) | External secret name | `""` | -| [`config.asyncJobEncryption.keys`](./values.yaml#L167) | `ASYNC_JOB_ENCRYPTION_KEYS` — comma-separated `key_id:base64_key[:current]` entries for encrypting async job metadata. Required for async Build API requests with remote URLs or PDF passwords. | `none` | -| [`config.asyncJobMaxRetries`](./values.yaml#L141) | `ASYNC_JOB_MAX_RETRIES` | `2` | -| [`config.asyncJobRetryBackoffSeconds`](./values.yaml#L144) | `ASYNC_JOB_RETRY_BACKOFF_SECONDS` | `15` | -| [`config.asyncJobTimeoutSeconds`](./values.yaml#L138) | `ASYNC_JOB_TIMEOUT` in seconds | `600` | -| [`config.asyncJobsMetadataTtlSeconds`](./values.yaml#L135) | `ASYNC_JOBS_METADATA_TTL` in seconds. Must be greater than or equal to `config.asyncJobsTtlSeconds`. | `604800` | -| [`config.asyncJobsTtlSeconds`](./values.yaml#L132) | `ASYNC_JOBS_TTL` | `172800` | -| [`config.asyncWorkerQueues`](./values.yaml#L157) | `ASYNC_WORKER_QUEUES` — comma-separated async worker queues with concurrency, for example `default=5`. Set to an empty string to make this node skip async background work. | `"default=5"` | -| [`config.automaticLinkExtraction`](./values.yaml#L196) | `AUTOMATIC_LINK_EXTRACTION` | `false` | -| [`config.batchRender`](./values.yaml#L117) | Batch render request settings. | [...](./values.yaml#L117) | -| [`config.batchRender.maxConcurrency`](./values.yaml#L120) | `BATCH_RENDER_MAX_CONCURRENCY` | `4` | -| [`config.batchRender.maxPages`](./values.yaml#L123) | `BATCH_RENDER_MAX_PAGES` | `500` | -| [`config.batchRender.pageTimeoutSeconds`](./values.yaml#L126) | `BATCH_RENDER_PAGE_TIMEOUT_MS` in seconds | `120` | +| [`config.allowDocumentGeneration`](./values.yaml#L196) | `ALLOW_DOCUMENT_GENERATION` | `true` | +| [`config.allowDocumentUploads`](./values.yaml#L190) | `ALLOW_DOCUMENT_UPLOADS` | `true` | +| [`config.allowRemoteAssetsInGeneration`](./values.yaml#L199) | `ALLOW_REMOTE_ASSETS_IN_GENERATION` | `true` | +| [`config.allowRemoteDocuments`](./values.yaml#L193) | `ALLOW_REMOTE_DOCUMENTS` | `true` | +| [`config.asyncAdmissionQueueLimits`](./values.yaml#L162) | `ASYNC_ADMISSION_QUEUE_LIMITS` — optional comma-separated queue limits, for example `default=100`. Missing queues are unlimited. | `none` | +| [`config.asyncAdmissionQueues`](./values.yaml#L157) | `ASYNC_ADMISSION_QUEUES` — comma-separated async queues accepted by this node. Set to an empty string to reject async operation admission. | `"default"` | +| [`config.asyncJobEncryption`](./values.yaml#L171) | Async job metadata encryption settings. | [...](./values.yaml#L171) | +| [`config.asyncJobEncryption.externalSecret`](./values.yaml#L181) | Use an external secret for `ASYNC_JOB_ENCRYPTION_KEYS` | [...](./values.yaml#L181) | +| [`config.asyncJobEncryption.externalSecret.key`](./values.yaml#L187) | Secret key name for the async job encryption keyring | `"ASYNC_JOB_ENCRYPTION_KEYS"` | +| [`config.asyncJobEncryption.externalSecret.name`](./values.yaml#L184) | External secret name | `""` | +| [`config.asyncJobEncryption.keys`](./values.yaml#L176) | `ASYNC_JOB_ENCRYPTION_KEYS` — comma-separated `key_id:base64_key[:current]` entries for encrypting async job metadata. Required for async Build API requests with remote URLs or PDF passwords. | `none` | +| [`config.asyncJobMaxRetries`](./values.yaml#L150) | `ASYNC_JOB_MAX_RETRIES` | `2` | +| [`config.asyncJobRetryBackoffSeconds`](./values.yaml#L153) | `ASYNC_JOB_RETRY_BACKOFF_SECONDS` | `15` | +| [`config.asyncJobTimeoutSeconds`](./values.yaml#L147) | `ASYNC_JOB_TIMEOUT` in seconds | `600` | +| [`config.asyncJobsMetadataTtlSeconds`](./values.yaml#L144) | `ASYNC_JOBS_METADATA_TTL` in seconds. Must be greater than or equal to `config.asyncJobsTtlSeconds`. | `604800` | +| [`config.asyncJobsTtlSeconds`](./values.yaml#L141) | `ASYNC_JOBS_TTL` | `172800` | +| [`config.asyncWorkerQueues`](./values.yaml#L166) | `ASYNC_WORKER_QUEUES` — comma-separated async worker queues with concurrency, for example `default=5`. Set to an empty string to make this node skip async background work. | `"default=5"` | +| [`config.automaticLinkExtraction`](./values.yaml#L205) | `AUTOMATIC_LINK_EXTRACTION` | `false` | +| [`config.batchRender`](./values.yaml#L126) | Batch render request settings. | [...](./values.yaml#L126) | +| [`config.batchRender.maxConcurrency`](./values.yaml#L129) | `BATCH_RENDER_MAX_CONCURRENCY` | `4` | +| [`config.batchRender.maxPages`](./values.yaml#L132) | `BATCH_RENDER_MAX_PAGES` | `500` | +| [`config.batchRender.pageTimeoutSeconds`](./values.yaml#L135) | `BATCH_RENDER_PAGE_TIMEOUT_MS` in seconds | `120` | | [`config.daemonReadTimeoutSeconds`](./values.yaml#L100) | `PSPDFKITD_READ_TIMEOUT` in seconds | `120` | | [`config.daemonWriteTimeoutSeconds`](./values.yaml#L103) | `PSPDFKITD_WRITE_TIMEOUT` in seconds | `10` | | [`config.generationTimeoutSeconds`](./values.yaml#L106) | `PDF_GENERATION_TIMEOUT` in seconds | `20` | -| [`config.hoard`](./values.yaml#L245) | Hoard — internal caching service parameters | [...](./values.yaml#L245) | -| [`config.hoard.maxSizeMegaBytes`](./values.yaml#L248) | `HOARD_MAX_SIZE` — maximum size in millions of bytes | `100` | -| [`config.http2SharedRendering`](./values.yaml#L257) | Optimised rendering relying on HTTP/2 | [...](./values.yaml#L257) | -| [`config.http2SharedRendering.enabled`](./values.yaml#L260) | `HTTP2_SHARED_RENDERING_PROCESS_ENABLE` — enable shared rendering processes | `false` | -| [`config.ignoreInvalidAnnotations`](./values.yaml#L193) | `IGNORE_INVALID_ANNOTATIONS` | `true` | -| [`config.maxUploadSizeMegaBytes`](./values.yaml#L129) | `MAX_UPLOAD_SIZE_BYTES` in megabytes | `950` | -| [`config.minSearchQueryLength`](./values.yaml#L199) | `MIN_SEARCH_QUERY_LENGTH` | `3` | -| [`config.port`](./values.yaml#L278) | `PORT` for the Document Engine API | `5000` | -| [`config.proxy`](./values.yaml#L273) | Proxy settings, `HTTP_PROXY` and `HTTPS_PROXY` | `{"http":"","https":""}` | -| [`config.readAnnotationBatchTimeoutSeconds`](./values.yaml#L112) | `READ_ANNOTATION_BATCH_TIMEOUT` in seconds | `20` | -| [`config.remoteUrlFetch`](./values.yaml#L204) | Customer-controlled remote URL fetch policy. | [...](./values.yaml#L204) | -| [`config.remoteUrlFetch.allowEmbeddedCredentials`](./values.yaml#L218) | `REMOTE_URL_FETCH_ALLOW_EMBEDDED_CREDENTIALS` | `false` | -| [`config.remoteUrlFetch.allowedCidrs`](./values.yaml#L215) | `REMOTE_URL_FETCH_ALLOWED_CIDRS` — comma-separated CIDR ranges. | `none` | -| [`config.remoteUrlFetch.allowedHosts`](./values.yaml#L211) | `REMOTE_URL_FETCH_ALLOWED_HOSTS` — comma-separated DNS hostnames or wildcard DNS patterns. | `none` | -| [`config.remoteUrlFetch.policy`](./values.yaml#L207) | `REMOTE_URL_FETCH_POLICY` | `"public_only"` | -| [`config.replaceSecretsFromEnv`](./values.yaml#L283) | `REPLACE_SECRETS_FROM_ENV` — whether to consider environment variables, values and secrets for `JWT_PUBLIC_KEY`, `SECRET_KEY_BASE` and `DASHBOARD_PASSWORD` | `true` | +| [`config.hoard`](./values.yaml#L254) | Hoard — internal caching service parameters | [...](./values.yaml#L254) | +| [`config.hoard.maxSizeMegaBytes`](./values.yaml#L257) | `HOARD_MAX_SIZE` — maximum size in millions of bytes | `100` | +| [`config.http2SharedRendering`](./values.yaml#L266) | Optimised rendering relying on HTTP/2 | [...](./values.yaml#L266) | +| [`config.http2SharedRendering.enabled`](./values.yaml#L269) | `HTTP2_SHARED_RENDERING_PROCESS_ENABLE` — enable shared rendering processes | `false` | +| [`config.ignoreInvalidAnnotations`](./values.yaml#L202) | `IGNORE_INVALID_ANNOTATIONS` | `true` | +| [`config.maxUploadSizeMegaBytes`](./values.yaml#L138) | `MAX_UPLOAD_SIZE_BYTES` in megabytes | `950` | +| [`config.minSearchQueryLength`](./values.yaml#L208) | `MIN_SEARCH_QUERY_LENGTH` | `3` | +| [`config.port`](./values.yaml#L287) | `PORT` for the Document Engine API | `5000` | +| [`config.proxy`](./values.yaml#L282) | Proxy settings, `HTTP_PROXY` and `HTTPS_PROXY` | `{"http":"","https":""}` | +| [`config.readAnnotationBatchTimeoutSeconds`](./values.yaml#L121) | `READ_ANNOTATION_BATCH_TIMEOUT` in seconds | `20` | +| [`config.remoteUrlFetch`](./values.yaml#L213) | Customer-controlled remote URL fetch policy. | [...](./values.yaml#L213) | +| [`config.remoteUrlFetch.allowEmbeddedCredentials`](./values.yaml#L227) | `REMOTE_URL_FETCH_ALLOW_EMBEDDED_CREDENTIALS` | `false` | +| [`config.remoteUrlFetch.allowedCidrs`](./values.yaml#L224) | `REMOTE_URL_FETCH_ALLOWED_CIDRS` — comma-separated CIDR ranges. | `none` | +| [`config.remoteUrlFetch.allowedHosts`](./values.yaml#L220) | `REMOTE_URL_FETCH_ALLOWED_HOSTS` — comma-separated DNS hostnames or wildcard DNS patterns. | `none` | +| [`config.remoteUrlFetch.policy`](./values.yaml#L216) | `REMOTE_URL_FETCH_POLICY` | `"public_only"` | +| [`config.replaceSecretsFromEnv`](./values.yaml#L292) | `REPLACE_SECRETS_FROM_ENV` — whether to consider environment variables, values and secrets for `JWT_PUBLIC_KEY`, `SECRET_KEY_BASE` and `DASHBOARD_PASSWORD` | `true` | | [`config.requestTimeoutSeconds`](./values.yaml#L88) | Full request timeout in seconds (`SERVER_REQUEST_TIMEOUT`). Should be smaller than `terminationGracePeriodSeconds`, so a request cannot still be running when Kubernetes sends `SIGKILL`. | `60` | -| [`config.search`](./values.yaml#L223) | Full-text search settings. | [...](./values.yaml#L223) | -| [`config.search.ftsBuildOnWrite`](./values.yaml#L235) | `SEARCH_FTS_BUILD_ON_WRITE` | `false` | -| [`config.search.ftsEnabled`](./values.yaml#L226) | `SEARCH_FTS_ENABLED` | `false` | -| [`config.search.ftsEnrichment`](./values.yaml#L229) | `SEARCH_FTS_ENRICHMENT` | `"daemon"` | -| [`config.search.maxGlyphSidecarPageBytes`](./values.yaml#L232) | `SEARCH_MAX_GLYPH_SIDECAR_PAGE_BYTES` | `2000000` | -| [`config.tileMaxScale`](./values.yaml#L240) | `TILE_MAX_SCALE` — maximum allowed tile scale, calculated as requested tile size divided by actual page size. Must be greater than 1. When unset, no limit is enforced. | `unlimited` | -| [`config.trustedProxies`](./values.yaml#L270) | `TRUSTED_PROXIES` — comma-separated list of IP addresses or IP address ranges of trusted proxies. Setting to `default` will use private IP ranges. | `"default"` | +| [`config.search`](./values.yaml#L232) | Full-text search settings. | [...](./values.yaml#L232) | +| [`config.search.ftsBuildOnWrite`](./values.yaml#L244) | `SEARCH_FTS_BUILD_ON_WRITE` | `false` | +| [`config.search.ftsEnabled`](./values.yaml#L235) | `SEARCH_FTS_ENABLED` | `false` | +| [`config.search.ftsEnrichment`](./values.yaml#L238) | `SEARCH_FTS_ENRICHMENT` | `"daemon"` | +| [`config.search.maxGlyphSidecarPageBytes`](./values.yaml#L241) | `SEARCH_MAX_GLYPH_SIDECAR_PAGE_BYTES` | `2000000` | +| [`config.tileMaxScale`](./values.yaml#L249) | `TILE_MAX_SCALE` — maximum allowed tile scale, calculated as requested tile size divided by actual page size. Must be greater than 1. When unset, no limit is enforced. | `unlimited` | +| [`config.trustedProxies`](./values.yaml#L279) | `TRUSTED_PROXIES` — comma-separated list of IP addresses or IP address ranges of trusted proxies. Setting to `default` will use private IP ranges. | `"default"` | +| [`config.urlFetchPoolSize`](./values.yaml#L112) | `DOWNLOADER_WORKER_POOL_SIZE`. How many documents are fetched from a remote URL at once, per pod. | `16` | +| [`config.urlFetchQueueMaxSize`](./values.yaml#L118) | `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. | `128` | +| [`config.urlFetchQueueTimeoutSeconds`](./values.yaml#L115) | `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected with `503`. | `5` | | [`config.urlFetchTimeoutSeconds`](./values.yaml#L109) | `REMOTE_URL_FETCH_TIMEOUT` in seconds | `5` | | [`config.workerPoolMaxRestarts`](./values.yaml#L94) | Maximum number of restarts (`PSPDFKIT_WORKER_POOL_MAX_RESTARTS`) before supervisor starts throttling them. | `20` | | [`config.workerPoolMaxSeconds`](./values.yaml#L97) | Time window in which the supervisor monitors the number of restarts (`PSPDFKIT_WORKER_POOL_MAX_SECONDS`). | `60` | @@ -463,314 +466,314 @@ Note: | Key | Description | Default | |-----|-------------|---------| -| [`certificateTrust`](./values.yaml#L288) | [Certificate trust](https://www.nutrient.io/guides/document-engine/configuration/certificate-trust/) | | -| [`certificateTrust.customCertificates`](./values.yaml#L301) | ConfigMap and Secret references for trust configuration, stored in `/certificate-stores-custom` | `[]` | -| [`certificateTrust.digitalSignatures`](./values.yaml#L292) | CAs for digital signatures (`/certificate-stores/`) from ConfigMap and Secret resources. | `[]` | -| [`certificateTrust.downloaderTrustFileName`](./values.yaml#L311) | Override `DOWNLOADER_CERT_FILE_PATH` to set HTTP client trust. If empty, defaults to Mozilla's CA bundle. | `""` | +| [`certificateTrust`](./values.yaml#L297) | [Certificate trust](https://www.nutrient.io/guides/document-engine/configuration/certificate-trust/) | | +| [`certificateTrust.customCertificates`](./values.yaml#L310) | ConfigMap and Secret references for trust configuration, stored in `/certificate-stores-custom` | `[]` | +| [`certificateTrust.digitalSignatures`](./values.yaml#L301) | CAs for digital signatures (`/certificate-stores/`) from ConfigMap and Secret resources. | `[]` | +| [`certificateTrust.downloaderTrustFileName`](./values.yaml#L320) | Override `DOWNLOADER_CERT_FILE_PATH` to set HTTP client trust. If empty, defaults to Mozilla's CA bundle. | `""` | ### Database | Key | Description | Default | |-----|-------------|---------| -| [`database`](./values.yaml#L316) | Database | | -| [`database.connections`](./values.yaml#L325) | `DATABASE_CONNECTIONS` | `20` | -| [`database.enabled`](./values.yaml#L319) | Persistent storage enabled | `true` | -| [`database.engine`](./values.yaml#L322) | Database engine: only `postgres` is currently supported | `"postgres"` | -| [`database.migrationJob`](./values.yaml#L389) | Database migration jobs. | [...](./values.yaml#L389) | -| [`database.migrationJob.enabled`](./values.yaml#L392) | It `true`, results in `ENABLE_DATABASE_MIGRATIONS=false` in the main Document Engine container | `false` | -| [`database.postgres`](./values.yaml#L330) | PostgreSQL database settings | [...](./values.yaml#L330) | -| [`database.postgres.adminPassword`](./values.yaml#L351) | `PG_ADMIN_PASSWORD` | `"despair"` | -| [`database.postgres.adminUsername`](./values.yaml#L348) | `PG_ADMIN_USER` | `"postgres"` | -| [`database.postgres.database`](./values.yaml#L339) | `PGDATABASE` | `"document-engine"` | -| [`database.postgres.externalAdminSecretName`](./values.yaml#L360) | External secret for administrative database credentials, used for migrations: `PG_ADMIN_USER` and `PG_ADMIN_PASSWORD` | `""` | -| [`database.postgres.externalSecretName`](./values.yaml#L356) | Use external secret for database credentials. `PGUSER` and `PGPASSWORD` must be provided and, if not defined: `PGDATABASE`, `PGHOST`, `PGPORT`, `PGSSL` | `""` | -| [`database.postgres.host`](./values.yaml#L333) | `PGHOST`, if not set, and `cloudNativePG.enabled`, will rely on the Cluster | `""` | -| [`database.postgres.password`](./values.yaml#L345) | `PGPASSWORD` | `"despair"` | -| [`database.postgres.port`](./values.yaml#L336) | `PGPORT` | `5432` | -| [`database.postgres.tls`](./values.yaml#L365) | TLS settings | [...](./values.yaml#L365) | -| [`database.postgres.tls.commonName`](./values.yaml#L378) | Common name for the certificate (`PGSSL_CERT_COMMON_NAME`), defaults to `PGHOST` value | `""` | -| [`database.postgres.tls.enabled`](./values.yaml#L368) | Enable TLS (`PGSSL`) | `false` | -| [`database.postgres.tls.hostVerify`](./values.yaml#L374) | Negated `PGSSL_DISABLE_HOSTNAME_VERIFY` | `true` | -| [`database.postgres.tls.trustBundle`](./values.yaml#L382) | Trust bundle for PostgreSQL, sets `PGSSL_CA_CERTS`, mutually exclusive with `trustFileName` and takes precedence | `""` | -| [`database.postgres.tls.trustFileName`](./values.yaml#L385) | Path from `certificateTrust.customCertificates`, wraps around `PGSSL_CA_CERT_PATH` | `""` | -| [`database.postgres.tls.verify`](./values.yaml#L371) | Negated `PGSSL_DISABLE_VERIFY` | `true` | -| [`database.postgres.username`](./values.yaml#L342) | `PGUSER` | `"postgres"` | +| [`database`](./values.yaml#L325) | Database | | +| [`database.connections`](./values.yaml#L334) | `DATABASE_CONNECTIONS` | `20` | +| [`database.enabled`](./values.yaml#L328) | Persistent storage enabled | `true` | +| [`database.engine`](./values.yaml#L331) | Database engine: only `postgres` is currently supported | `"postgres"` | +| [`database.migrationJob`](./values.yaml#L398) | Database migration jobs. | [...](./values.yaml#L398) | +| [`database.migrationJob.enabled`](./values.yaml#L401) | It `true`, results in `ENABLE_DATABASE_MIGRATIONS=false` in the main Document Engine container | `false` | +| [`database.postgres`](./values.yaml#L339) | PostgreSQL database settings | [...](./values.yaml#L339) | +| [`database.postgres.adminPassword`](./values.yaml#L360) | `PG_ADMIN_PASSWORD` | `"despair"` | +| [`database.postgres.adminUsername`](./values.yaml#L357) | `PG_ADMIN_USER` | `"postgres"` | +| [`database.postgres.database`](./values.yaml#L348) | `PGDATABASE` | `"document-engine"` | +| [`database.postgres.externalAdminSecretName`](./values.yaml#L369) | External secret for administrative database credentials, used for migrations: `PG_ADMIN_USER` and `PG_ADMIN_PASSWORD` | `""` | +| [`database.postgres.externalSecretName`](./values.yaml#L365) | Use external secret for database credentials. `PGUSER` and `PGPASSWORD` must be provided and, if not defined: `PGDATABASE`, `PGHOST`, `PGPORT`, `PGSSL` | `""` | +| [`database.postgres.host`](./values.yaml#L342) | `PGHOST`, if not set, and `cloudNativePG.enabled`, will rely on the Cluster | `""` | +| [`database.postgres.password`](./values.yaml#L354) | `PGPASSWORD` | `"despair"` | +| [`database.postgres.port`](./values.yaml#L345) | `PGPORT` | `5432` | +| [`database.postgres.tls`](./values.yaml#L374) | TLS settings | [...](./values.yaml#L374) | +| [`database.postgres.tls.commonName`](./values.yaml#L387) | Common name for the certificate (`PGSSL_CERT_COMMON_NAME`), defaults to `PGHOST` value | `""` | +| [`database.postgres.tls.enabled`](./values.yaml#L377) | Enable TLS (`PGSSL`) | `false` | +| [`database.postgres.tls.hostVerify`](./values.yaml#L383) | Negated `PGSSL_DISABLE_HOSTNAME_VERIFY` | `true` | +| [`database.postgres.tls.trustBundle`](./values.yaml#L391) | Trust bundle for PostgreSQL, sets `PGSSL_CA_CERTS`, mutually exclusive with `trustFileName` and takes precedence | `""` | +| [`database.postgres.tls.trustFileName`](./values.yaml#L394) | Path from `certificateTrust.customCertificates`, wraps around `PGSSL_CA_CERT_PATH` | `""` | +| [`database.postgres.tls.verify`](./values.yaml#L380) | Negated `PGSSL_DISABLE_VERIFY` | `true` | +| [`database.postgres.username`](./values.yaml#L351) | `PGUSER` | `"postgres"` | ### Document lifecycle | Key | Description | Default | |-----|-------------|---------| -| [`documentLifecycle`](./values.yaml#L405) | Document lifecycle management | | -| [`documentLifecycle.bulkDocumentDeletionEnabled`](./values.yaml#L408) | `ENABLE_BULK_DOCUMENT_DELETION`: enable `/api/async/delete_documents` API endpoint | `false` | -| [`documentLifecycle.expirationJob`](./values.yaml#L412) | Regular job to remove documents from the database, requires `documentLifecycle.bulkDocumentDeletionEnabled` to be `true` | [...](./values.yaml#L412) | -| [`documentLifecycle.expirationJob.deletionPrefix`](./values.yaml#L425) | Only delete documents with IDs beginning with this prefix. Leave empty to delete all documents matching the time filter. | `"ephemeral"` | -| [`documentLifecycle.expirationJob.enabled`](./values.yaml#L415) | Enable the document expiration job | `false` | -| [`documentLifecycle.expirationJob.keepHours`](./values.yaml#L421) | Documents TTL in hours | `24` | -| [`documentLifecycle.expirationJob.schedule`](./values.yaml#L418) | Expiration job schedule in cron format | `"13 * * * *"` | -| [`documentLifecycle.expirationJob.serviceAccountName`](./values.yaml#L436) | Service account name to specify for the expiration jobs | `""` | +| [`documentLifecycle`](./values.yaml#L414) | Document lifecycle management | | +| [`documentLifecycle.bulkDocumentDeletionEnabled`](./values.yaml#L417) | `ENABLE_BULK_DOCUMENT_DELETION`: enable `/api/async/delete_documents` API endpoint | `false` | +| [`documentLifecycle.expirationJob`](./values.yaml#L421) | Regular job to remove documents from the database, requires `documentLifecycle.bulkDocumentDeletionEnabled` to be `true` | [...](./values.yaml#L421) | +| [`documentLifecycle.expirationJob.deletionPrefix`](./values.yaml#L434) | Only delete documents with IDs beginning with this prefix. Leave empty to delete all documents matching the time filter. | `"ephemeral"` | +| [`documentLifecycle.expirationJob.enabled`](./values.yaml#L424) | Enable the document expiration job | `false` | +| [`documentLifecycle.expirationJob.keepHours`](./values.yaml#L430) | Documents TTL in hours | `24` | +| [`documentLifecycle.expirationJob.schedule`](./values.yaml#L427) | Expiration job schedule in cron format | `"13 * * * *"` | +| [`documentLifecycle.expirationJob.serviceAccountName`](./values.yaml#L445) | Service account name to specify for the expiration jobs | `""` | ### Asset storage | Key | Description | Default | |-----|-------------|---------| -| [`assetStorage`](./values.yaml#L447) | Everything about storing and caching assets | | -| [`assetStorage.azure`](./values.yaml#L519) | Azure blob storage settings, in case `assetStorage.backendType` is set to `azure` | [...](./values.yaml#L519) | -| [`assetStorage.azure.container`](./values.yaml#L530) | `AZURE_STORAGE_DEFAULT_CONTAINER` | `""` | -| [`assetStorage.backendFallback`](./values.yaml#L466) | Asset storage fallback settings | [...](./values.yaml#L466) | -| [`assetStorage.backendFallback.enabled`](./values.yaml#L469) | `ENABLE_ASSET_STORAGE_FALLBACK` | `false` | -| [`assetStorage.backendFallback.enabledAzure`](./values.yaml#L478) | `ENABLE_ASSET_STORAGE_FALLBACK_AZURE` | `false` | -| [`assetStorage.backendFallback.enabledPostgres`](./values.yaml#L472) | `ENABLE_ASSET_STORAGE_FALLBACK_POSTGRES` | `false` | -| [`assetStorage.backendFallback.enabledS3`](./values.yaml#L475) | `ENABLE_ASSET_STORAGE_FALLBACK_S3` | `false` | -| [`assetStorage.backendType`](./values.yaml#L459) | Asset storage backend is only available if `database.enabled` is `true` Sets `ASSET_STORAGE_BACKEND`: `built-in`, `s3` or `azure` | `"built-in"` | -| [`assetStorage.fileUploadTimeoutSeconds`](./values.yaml#L462) | `FILE_UPLOAD_TIMEOUT_MS` in seconds | `30` | -| [`assetStorage.localCacheSizeMegabytes`](./values.yaml#L451) | Sets local asset storage value in megabytes Results in `ASSET_STORAGE_CACHE_SIZE` (in bytes) | `2000` | -| [`assetStorage.localCacheTimeoutSeconds`](./values.yaml#L455) | Sets local asset storage cache timeout in seconds Results in `ASSET_STORAGE_CACHE_TIMEOUT` (in milliseconds) | `5` | -| [`assetStorage.redis`](./values.yaml#L548) | Redis settings for caching and prerendering | [...](./values.yaml#L548) | -| [`assetStorage.redis.database`](./values.yaml#L566) | `REDIS_DATABASE` | `""` | -| [`assetStorage.redis.enabled`](./values.yaml#L551) | `USE_REDIS_CACHE` | `false` | -| [`assetStorage.redis.externalSecretName`](./values.yaml#L603) | External secret name. Must contain `REDIS_USERNAME` and `REDIS_PASSWORD` if they are needed, and _may_ set other values | `""` | -| [`assetStorage.redis.host`](./values.yaml#L560) | `REDIS_HOST` | `"{{ .Release.Name }}-redis-master"` | -| [`assetStorage.redis.password`](./values.yaml#L592) | `REDIS_PASSWORD` | `""` | -| [`assetStorage.redis.port`](./values.yaml#L563) | `REDIS_PORT` | `6379` | -| [`assetStorage.redis.sentinel`](./values.yaml#L571) | Redis Sentinel | [...](./values.yaml#L571) | -| [`assetStorage.redis.tls`](./values.yaml#L596) | TLS settings | | -| [`assetStorage.redis.tls.enabled`](./values.yaml#L599) | Enable TLS (`REDIS_SSL`) | `false` | -| [`assetStorage.redis.ttlSeconds`](./values.yaml#L557) | `REDIS_TTL` Time to live in seconds | `86400` | -| [`assetStorage.redis.useTtl`](./values.yaml#L554) | `USE_REDIS_TTL_FOR_PRERENDERING` | `true` | -| [`assetStorage.redis.username`](./values.yaml#L589) | `REDIS_USERNAME` | `""` | -| [`assetStorage.s3`](./values.yaml#L482) | S3 backend storage settings, in case `assetStorage.backendType` is set to `s3 | [...](./values.yaml#L482) | -| [`assetStorage.s3.bucket`](./values.yaml#L493) | `ASSET_STORAGE_S3_BUCKET` | `"document-engine-assets"` | -| [`assetStorage.s3.region`](./values.yaml#L496) | `ASSET_STORAGE_S3_REGION` | `"us-east-1"` | +| [`assetStorage`](./values.yaml#L456) | Everything about storing and caching assets | | +| [`assetStorage.azure`](./values.yaml#L528) | Azure blob storage settings, in case `assetStorage.backendType` is set to `azure` | [...](./values.yaml#L528) | +| [`assetStorage.azure.container`](./values.yaml#L539) | `AZURE_STORAGE_DEFAULT_CONTAINER` | `""` | +| [`assetStorage.backendFallback`](./values.yaml#L475) | Asset storage fallback settings | [...](./values.yaml#L475) | +| [`assetStorage.backendFallback.enabled`](./values.yaml#L478) | `ENABLE_ASSET_STORAGE_FALLBACK` | `false` | +| [`assetStorage.backendFallback.enabledAzure`](./values.yaml#L487) | `ENABLE_ASSET_STORAGE_FALLBACK_AZURE` | `false` | +| [`assetStorage.backendFallback.enabledPostgres`](./values.yaml#L481) | `ENABLE_ASSET_STORAGE_FALLBACK_POSTGRES` | `false` | +| [`assetStorage.backendFallback.enabledS3`](./values.yaml#L484) | `ENABLE_ASSET_STORAGE_FALLBACK_S3` | `false` | +| [`assetStorage.backendType`](./values.yaml#L468) | Asset storage backend is only available if `database.enabled` is `true` Sets `ASSET_STORAGE_BACKEND`: `built-in`, `s3` or `azure` | `"built-in"` | +| [`assetStorage.fileUploadTimeoutSeconds`](./values.yaml#L471) | `FILE_UPLOAD_TIMEOUT_MS` in seconds | `30` | +| [`assetStorage.localCacheSizeMegabytes`](./values.yaml#L460) | Sets local asset storage value in megabytes Results in `ASSET_STORAGE_CACHE_SIZE` (in bytes) | `2000` | +| [`assetStorage.localCacheTimeoutSeconds`](./values.yaml#L464) | Sets local asset storage cache timeout in seconds Results in `ASSET_STORAGE_CACHE_TIMEOUT` (in milliseconds) | `5` | +| [`assetStorage.redis`](./values.yaml#L557) | Redis settings for caching and prerendering | [...](./values.yaml#L557) | +| [`assetStorage.redis.database`](./values.yaml#L575) | `REDIS_DATABASE` | `""` | +| [`assetStorage.redis.enabled`](./values.yaml#L560) | `USE_REDIS_CACHE` | `false` | +| [`assetStorage.redis.externalSecretName`](./values.yaml#L612) | External secret name. Must contain `REDIS_USERNAME` and `REDIS_PASSWORD` if they are needed, and _may_ set other values | `""` | +| [`assetStorage.redis.host`](./values.yaml#L569) | `REDIS_HOST` | `"{{ .Release.Name }}-redis-master"` | +| [`assetStorage.redis.password`](./values.yaml#L601) | `REDIS_PASSWORD` | `""` | +| [`assetStorage.redis.port`](./values.yaml#L572) | `REDIS_PORT` | `6379` | +| [`assetStorage.redis.sentinel`](./values.yaml#L580) | Redis Sentinel | [...](./values.yaml#L580) | +| [`assetStorage.redis.tls`](./values.yaml#L605) | TLS settings | | +| [`assetStorage.redis.tls.enabled`](./values.yaml#L608) | Enable TLS (`REDIS_SSL`) | `false` | +| [`assetStorage.redis.ttlSeconds`](./values.yaml#L566) | `REDIS_TTL` Time to live in seconds | `86400` | +| [`assetStorage.redis.useTtl`](./values.yaml#L563) | `USE_REDIS_TTL_FOR_PRERENDERING` | `true` | +| [`assetStorage.redis.username`](./values.yaml#L598) | `REDIS_USERNAME` | `""` | +| [`assetStorage.s3`](./values.yaml#L491) | S3 backend storage settings, in case `assetStorage.backendType` is set to `s3 | [...](./values.yaml#L491) | +| [`assetStorage.s3.bucket`](./values.yaml#L502) | `ASSET_STORAGE_S3_BUCKET` | `"document-engine-assets"` | +| [`assetStorage.s3.region`](./values.yaml#L505) | `ASSET_STORAGE_S3_REGION` | `"us-east-1"` | ### Statefulness | Key | Description | Default | |-----|-------------|---------| -| [`persistence`](./values.yaml#L621) | Persistent storage settings for StatefulSet pods. Only used when `workloadType` is `StatefulSet`. | [...](./values.yaml#L621) | -| [`persistence.accessModes`](./values.yaml#L627) | PVC access modes | `["ReadWriteOnce"]` | -| [`persistence.annotations`](./values.yaml#L637) | Annotations for each PVC | `{}` | -| [`persistence.mountPath`](./values.yaml#L634) | Mount path inside the container | `"/srv/pspdfkit/assets"` | -| [`persistence.selectorLabels`](./values.yaml#L640) | Selector labels for PVCs | `{}` | -| [`persistence.size`](./values.yaml#L631) | PVC storage size | `"10Gi"` | -| [`persistence.storageClassName`](./values.yaml#L624) | Storage class for PVCs. Empty string uses cluster default. | `"standard"` | -| [`podManagementPolicy`](./values.yaml#L615) | Pod management policy for StatefulSet: `OrderedReady` or `Parallel`. Only used when `workloadType` is `StatefulSet`. | `"OrderedReady"` | -| [`workloadType`](./values.yaml#L610) | Workload type: `Deployment` or `StatefulSet`. When `StatefulSet`, persistent storage is provisioned per pod via volumeClaimTemplates. **Note:** Switching an existing release from Deployment to StatefulSet requires deleting the existing Deployment first, as Kubernetes cannot change a resource kind in-place. | `"Deployment"` | +| [`persistence`](./values.yaml#L630) | Persistent storage settings for StatefulSet pods. Only used when `workloadType` is `StatefulSet`. | [...](./values.yaml#L630) | +| [`persistence.accessModes`](./values.yaml#L636) | PVC access modes | `["ReadWriteOnce"]` | +| [`persistence.annotations`](./values.yaml#L646) | Annotations for each PVC | `{}` | +| [`persistence.mountPath`](./values.yaml#L643) | Mount path inside the container | `"/srv/pspdfkit/assets"` | +| [`persistence.selectorLabels`](./values.yaml#L649) | Selector labels for PVCs | `{}` | +| [`persistence.size`](./values.yaml#L640) | PVC storage size | `"10Gi"` | +| [`persistence.storageClassName`](./values.yaml#L633) | Storage class for PVCs. Empty string uses cluster default. | `"standard"` | +| [`podManagementPolicy`](./values.yaml#L624) | Pod management policy for StatefulSet: `OrderedReady` or `Parallel`. Only used when `workloadType` is `StatefulSet`. | `"OrderedReady"` | +| [`workloadType`](./values.yaml#L619) | Workload type: `Deployment` or `StatefulSet`. When `StatefulSet`, persistent storage is provisioned per pod via volumeClaimTemplates. **Note:** Switching an existing release from Deployment to StatefulSet requires deleting the existing Deployment first, as Kubernetes cannot change a resource kind in-place. | `"Deployment"` | ### Digital signatures | Key | Description | Default | |-----|-------------|---------| -| [`documentSigningService`](./values.yaml#L645) | Signing service parameters | | -| [`documentSigningService.cadesLevel`](./values.yaml#L671) | `DIGITAL_SIGNATURE_CADES_LEVEL` | `"b-lt"` | -| [`documentSigningService.certificateCheckTime`](./values.yaml#L674) | `DIGITAL_SIGNATURE_CERTIFICATE_CHECK_TIME` | `"current_time"` | -| [`documentSigningService.defaultSignatureLocation`](./values.yaml#L665) | `DEFAULT_SIGNATURE_LOCATION` | `"Head Quarters"` | -| [`documentSigningService.defaultSignatureReason`](./values.yaml#L661) | `DEFAULT_SIGNATURE_REASON` | `"approved"` | -| [`documentSigningService.defaultSignerName`](./values.yaml#L657) | `DEFAULT_SIGNER_NAME` | `"John Doe"` | -| [`documentSigningService.enabled`](./values.yaml#L648) | Enable signing service integration | `false` | -| [`documentSigningService.hashAlgorithm`](./values.yaml#L668) | `DIGITAL_SIGNATURE_HASH_ALGORITHM` | `"sha512"` | -| [`documentSigningService.timeoutSeconds`](./values.yaml#L654) | `SIGNING_SERVICE_TIMEOUT` in seconds | `10` | -| [`documentSigningService.timestampAuthority`](./values.yaml#L678) | Timestamp Authority (TSA) settings | [...](./values.yaml#L678) | -| [`documentSigningService.timestampAuthority.url`](./values.yaml#L681) | `TIMESTAMP_AUTHORITY_URL` | `"https://freetsa.org/"` | -| [`documentSigningService.url`](./values.yaml#L651) | `SIGNING_SERVICE_URL` | `"https://signing-thing.local/sign"` | +| [`documentSigningService`](./values.yaml#L654) | Signing service parameters | | +| [`documentSigningService.cadesLevel`](./values.yaml#L680) | `DIGITAL_SIGNATURE_CADES_LEVEL` | `"b-lt"` | +| [`documentSigningService.certificateCheckTime`](./values.yaml#L683) | `DIGITAL_SIGNATURE_CERTIFICATE_CHECK_TIME` | `"current_time"` | +| [`documentSigningService.defaultSignatureLocation`](./values.yaml#L674) | `DEFAULT_SIGNATURE_LOCATION` | `"Head Quarters"` | +| [`documentSigningService.defaultSignatureReason`](./values.yaml#L670) | `DEFAULT_SIGNATURE_REASON` | `"approved"` | +| [`documentSigningService.defaultSignerName`](./values.yaml#L666) | `DEFAULT_SIGNER_NAME` | `"John Doe"` | +| [`documentSigningService.enabled`](./values.yaml#L657) | Enable signing service integration | `false` | +| [`documentSigningService.hashAlgorithm`](./values.yaml#L677) | `DIGITAL_SIGNATURE_HASH_ALGORITHM` | `"sha512"` | +| [`documentSigningService.timeoutSeconds`](./values.yaml#L663) | `SIGNING_SERVICE_TIMEOUT` in seconds | `10` | +| [`documentSigningService.timestampAuthority`](./values.yaml#L687) | Timestamp Authority (TSA) settings | [...](./values.yaml#L687) | +| [`documentSigningService.timestampAuthority.url`](./values.yaml#L690) | `TIMESTAMP_AUTHORITY_URL` | `"https://freetsa.org/"` | +| [`documentSigningService.url`](./values.yaml#L660) | `SIGNING_SERVICE_URL` | `"https://signing-thing.local/sign"` | ### Document conversion | Key | Description | Default | |-----|-------------|---------| -| [`documentConversion`](./values.yaml#L694) | Document conversion parameters | | -| [`documentConversion.spreadsheetMaxContentHeightMm`](./values.yaml#L698) | Maximal spreadsheet content height in millimetres (`SPREADSHEET_MAX_CONTENT_HEIGHT_MM`). Defaults to `0` for unlimited height. | `0` | -| [`documentConversion.spreadsheetMaxContentWidthMm`](./values.yaml#L702) | Maximal spreadsheet content width in millimetres (`SPREADSHEET_MAX_CONTENT_WIDTH_MM`). Defaults to `0` for unlimited width. | `0` | +| [`documentConversion`](./values.yaml#L703) | Document conversion parameters | | +| [`documentConversion.spreadsheetMaxContentHeightMm`](./values.yaml#L707) | Maximal spreadsheet content height in millimetres (`SPREADSHEET_MAX_CONTENT_HEIGHT_MM`). Defaults to `0` for unlimited height. | `0` | +| [`documentConversion.spreadsheetMaxContentWidthMm`](./values.yaml#L711) | Maximal spreadsheet content width in millimetres (`SPREADSHEET_MAX_CONTENT_WIDTH_MM`). Defaults to `0` for unlimited width. | `0` | ### Clustering | Key | Description | Default | |-----|-------------|---------| -| [`clustering`](./values.yaml#L707) | Clustering settings | | -| [`clustering.enabled`](./values.yaml#L710) | `CLUSTERING_ENABLED`, enable clustering, only works when `replicaCount` is greater than 1 | `false` | -| [`clustering.method`](./values.yaml#L713) | `CLUSTERING_METHOD`, only `kubernetes_dns` is currently supported | `"kubernetes_dns"` | +| [`clustering`](./values.yaml#L716) | Clustering settings | | +| [`clustering.enabled`](./values.yaml#L719) | `CLUSTERING_ENABLED`, enable clustering, only works when `replicaCount` is greater than 1 | `false` | +| [`clustering.method`](./values.yaml#L722) | `CLUSTERING_METHOD`, only `kubernetes_dns` is currently supported | `"kubernetes_dns"` | ### Dashboard | Key | Description | Default | |-----|-------------|---------| -| [`dashboard`](./values.yaml#L724) | Document Engine Dashboard settings | | -| [`dashboard.auth`](./values.yaml#L744) | Dashboard authentication | [...](./values.yaml#L744) | -| [`dashboard.auth.externalSecret`](./values.yaml#L754) | Use an external secret for dashboard credentials | [...](./values.yaml#L754) | -| [`dashboard.auth.externalSecret.name`](./values.yaml#L757) | External secret name | `""` | -| [`dashboard.auth.externalSecret.passwordKey`](./values.yaml#L763) | Secret key name for the password | `"DASHBOARD_PASSWORD"` | -| [`dashboard.auth.externalSecret.usernameKey`](./values.yaml#L760) | Secret key name for the username | `"DASHBOARD_USERNAME"` | -| [`dashboard.auth.password`](./values.yaml#L750) | `DASHBOARD_PASSWORD` — will generate a random password if not set | `""` | -| [`dashboard.auth.username`](./values.yaml#L747) | `DASHBOARD_USERNAME` | `"admin"` | -| [`dashboard.enabled`](./values.yaml#L727) | Enable dashboard | `true` | -| [`dashboard.rateLimitingEnabled`](./values.yaml#L732) | `DASHBOARD_RATE_LIMITING_ENABLED` — enables rate limiting for dashboard authentication to prevent brute force attacks. When enabled, failed authentication attempts are tracked per IP address. | `true` | -| [`dashboard.rateLimitingMaxRequests`](./values.yaml#L736) | `DASHBOARD_RATE_LIMITING_MAX_REQUESTS` — maximum number of failed authentication attempts allowed per IP address within the time window before blocking. | `5` | -| [`dashboard.rateLimitingWindowMs`](./values.yaml#L740) | `DASHBOARD_RATE_LIMITING_WINDOW_MS` — time window in milliseconds for tracking failed authentication attempts. After this period, the counter resets. | `60000` | +| [`dashboard`](./values.yaml#L733) | Document Engine Dashboard settings | | +| [`dashboard.auth`](./values.yaml#L753) | Dashboard authentication | [...](./values.yaml#L753) | +| [`dashboard.auth.externalSecret`](./values.yaml#L763) | Use an external secret for dashboard credentials | [...](./values.yaml#L763) | +| [`dashboard.auth.externalSecret.name`](./values.yaml#L766) | External secret name | `""` | +| [`dashboard.auth.externalSecret.passwordKey`](./values.yaml#L772) | Secret key name for the password | `"DASHBOARD_PASSWORD"` | +| [`dashboard.auth.externalSecret.usernameKey`](./values.yaml#L769) | Secret key name for the username | `"DASHBOARD_USERNAME"` | +| [`dashboard.auth.password`](./values.yaml#L759) | `DASHBOARD_PASSWORD` — will generate a random password if not set | `""` | +| [`dashboard.auth.username`](./values.yaml#L756) | `DASHBOARD_USERNAME` | `"admin"` | +| [`dashboard.enabled`](./values.yaml#L736) | Enable dashboard | `true` | +| [`dashboard.rateLimitingEnabled`](./values.yaml#L741) | `DASHBOARD_RATE_LIMITING_ENABLED` — enables rate limiting for dashboard authentication to prevent brute force attacks. When enabled, failed authentication attempts are tracked per IP address. | `true` | +| [`dashboard.rateLimitingMaxRequests`](./values.yaml#L745) | `DASHBOARD_RATE_LIMITING_MAX_REQUESTS` — maximum number of failed authentication attempts allowed per IP address within the time window before blocking. | `5` | +| [`dashboard.rateLimitingWindowMs`](./values.yaml#L749) | `DASHBOARD_RATE_LIMITING_WINDOW_MS` — time window in milliseconds for tracking failed authentication attempts. After this period, the counter resets. | `60000` | ### Environment | Key | Description | Default | |-----|-------------|---------| -| [`extraEnvFrom`](./values.yaml#L958) | Extra environment variables from resources | `[]` | -| [`extraEnvs`](./values.yaml#L955) | Extra environment variables | `[]` | -| [`extraVolumeMounts`](./values.yaml#L964) | Additional volume mounts for Document Engine container | `[]` | -| [`extraVolumes`](./values.yaml#L961) | Additional volumes | `[]` | -| [`image`](./values.yaml#L915) | Image settings | [...](./values.yaml#L915) | -| [`imagePullSecrets`](./values.yaml#L922) | Pull secrets | `[]` | -| [`initContainers`](./values.yaml#L970) | Init containers | `[]` | -| [`podSecurityContext`](./values.yaml#L941) | Pod security context | `{"fsGroup":999}` | -| [`securityContext`](./values.yaml#L945) | Security context | `{}` | -| [`serviceAccount`](./values.yaml#L934) | ServiceAccount | [...](./values.yaml#L934) | -| [`sidecars`](./values.yaml#L967) | Additional containers | `[]` | +| [`extraEnvFrom`](./values.yaml#L967) | Extra environment variables from resources | `[]` | +| [`extraEnvs`](./values.yaml#L964) | Extra environment variables | `[]` | +| [`extraVolumeMounts`](./values.yaml#L973) | Additional volume mounts for Document Engine container | `[]` | +| [`extraVolumes`](./values.yaml#L970) | Additional volumes | `[]` | +| [`image`](./values.yaml#L924) | Image settings | [...](./values.yaml#L924) | +| [`imagePullSecrets`](./values.yaml#L931) | Pull secrets | `[]` | +| [`initContainers`](./values.yaml#L979) | Init containers | `[]` | +| [`podSecurityContext`](./values.yaml#L950) | Pod security context | `{"fsGroup":999}` | +| [`securityContext`](./values.yaml#L954) | Security context | `{}` | +| [`serviceAccount`](./values.yaml#L943) | ServiceAccount | [...](./values.yaml#L943) | +| [`sidecars`](./values.yaml#L976) | Additional containers | `[]` | ### Metadata | Key | Description | Default | |-----|-------------|---------| -| [`deploymentAnnotations`](./values.yaml#L980) | Workload annotations (`Deployment`/`StatefulSet`) | `{}` | -| [`deploymentExtraSelectorLabels`](./values.yaml#L985) | Additional selector labels for the workload (`Deployment`/`StatefulSet`) **Note:** Kubernetes selectors are immutable. Changing this value after first install may require recreating the workload. | `{}` | -| [`fullnameOverride`](./values.yaml#L929) | Release full name override | `""` | -| [`nameOverride`](./values.yaml#L926) | Release name override | `""` | -| [`podAnnotations`](./values.yaml#L977) | Pod annotations | `{}` | -| [`podLabels`](./values.yaml#L974) | Pod labels | `{}` | +| [`deploymentAnnotations`](./values.yaml#L989) | Workload annotations (`Deployment`/`StatefulSet`) | `{}` | +| [`deploymentExtraSelectorLabels`](./values.yaml#L994) | Additional selector labels for the workload (`Deployment`/`StatefulSet`) **Note:** Kubernetes selectors are immutable. Changing this value after first install may require recreating the workload. | `{}` | +| [`fullnameOverride`](./values.yaml#L938) | Release full name override | `""` | +| [`nameOverride`](./values.yaml#L935) | Release name override | `""` | +| [`podAnnotations`](./values.yaml#L986) | Pod annotations | `{}` | +| [`podLabels`](./values.yaml#L983) | Pod labels | `{}` | ### Networking | Key | Description | Default | |-----|-------------|---------| -| [`envoySidecar`](./values.yaml#L1154) | Envoy sidecar for consistent hashing by document ID | [...](./values.yaml#L1154) | -| [`envoySidecar.adminPort`](./values.yaml#L1170) | Admin port for Envoy | `9901` | -| [`envoySidecar.enabled`](./values.yaml#L1157) | Enable Envoy sidecar for consistent hashing | `false` | -| [`envoySidecar.healthCheck`](./values.yaml#L1174) | Health check configuration for upstream cluster | [...](./values.yaml#L1174) | -| [`envoySidecar.healthCheck.healthyThreshold`](./values.yaml#L1186) | Healthy threshold | `2` | -| [`envoySidecar.healthCheck.interval`](./values.yaml#L1180) | Health check interval | `"10s"` | -| [`envoySidecar.healthCheck.timeout`](./values.yaml#L1177) | Health check timeout | `"5s"` | -| [`envoySidecar.healthCheck.unhealthyThreshold`](./values.yaml#L1183) | Unhealthy threshold | `2` | -| [`envoySidecar.image`](./values.yaml#L1161) | Envoy sidecar image configuration | [...](./values.yaml#L1161) | -| [`envoySidecar.port`](./values.yaml#L1167) | Port where Envoy sidecar listens | `8080` | -| [`envoySidecar.resources`](./values.yaml#L1190) | Resource limits for Envoy sidecar | [...](./values.yaml#L1190) | -| [`extraIngresses`](./values.yaml#L1045) | Additional ingresses, e.g. for the dashboard | [...](./values.yaml#L1045) | -| [`gateway`](./values.yaml#L1061) | Kubernetes [Gateway API](https://gateway-api.sigs.k8s.io/) | [...](./values.yaml#L1061) | -| [`gateway.annotations`](./values.yaml#L1067) | Annotations for the HTTPRoute resource | `{}` | -| [`gateway.enabled`](./values.yaml#L1064) | Enable Gateway API HTTPRoute | `false` | -| [`gateway.extraHTTPRoutes`](./values.yaml#L1135) | Additional HTTPRoutes, e.g. for the dashboard | [...](./values.yaml#L1135) | -| [`gateway.gateway`](./values.yaml#L1097) | Optional [Gateway](https://gateway-api.sigs.k8s.io/api-types/gateway/) resource. Most clusters have Gateways managed by platform teams; enable this only if you want the chart to create one. | [...](./values.yaml#L1097) | -| [`gateway.gateway.addresses`](./values.yaml#L1130) | Gateway [addresses](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayAddress) | `[]` | -| [`gateway.gateway.annotations`](./values.yaml#L1106) | Annotations for the Gateway resource | `{}` | -| [`gateway.gateway.enabled`](./values.yaml#L1100) | Create a Gateway resource | `false` | -| [`gateway.gateway.gatewayClassName`](./values.yaml#L1103) | GatewayClass name (e.g. `amazon-vpc-lattice`, or a custom ALB class) | `""` | -| [`gateway.gateway.infrastructure`](./values.yaml#L1123) | [Infrastructure](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayInfrastructure) parameters, e.g. `parametersRef` for AWS Load Balancer Controller | `{}` | -| [`gateway.gateway.labels`](./values.yaml#L1109) | Labels for the Gateway resource | `{}` | -| [`gateway.gateway.listeners`](./values.yaml#L1112) | Gateway [listeners](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Listener) | `[]` | -| [`gateway.hostnames`](./values.yaml#L1081) | Hostnames for the HTTPRoute | `[]` | -| [`gateway.labels`](./values.yaml#L1070) | Labels for the HTTPRoute resource | `{}` | -| [`gateway.parentRefs`](./values.yaml#L1075) | References to Gateway resources this route attaches to. When `gateway.gateway.enabled` is true and this is empty, the chart-created Gateway is used automatically. See [ParentRef](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.ParentReference) | `[]` | -| [`gateway.rules`](./values.yaml#L1087) | HTTP routing rules. When empty, a default catch-all rule routing to the chart service is created. When rules are provided without `backendRefs`, the chart service is used as the default backend. | `[]` | -| [`ingress`](./values.yaml#L1010) | Ingress | [...](./values.yaml#L1010) | -| [`ingress.annotations`](./values.yaml#L1019) | Ingress annotations | `{}` | -| [`ingress.className`](./values.yaml#L1016) | Ingress class name | `""` | -| [`ingress.enabled`](./values.yaml#L1013) | Enable ingress | `false` | -| [`ingress.hosts`](./values.yaml#L1022) | Hosts | `[]` | -| [`ingress.tls`](./values.yaml#L1036) | Ingress TLS section | `[]` | -| [`networkPolicy`](./values.yaml#L1202) | [Network policy](https://kubernetes.io/docs/concepts/services-networking/network-policies/) | [...](./values.yaml#L1202) | -| [`networkPolicy.allowExternal`](./values.yaml#L1210) | Allow access from anywhere | `true` | -| [`networkPolicy.allowExternalEgress`](./values.yaml#L1234) | Allow the pod to access any range of port and all destinations. | `true` | -| [`networkPolicy.enabled`](./values.yaml#L1205) | Enable network policy | `true` | -| [`networkPolicy.extraEgress`](./values.yaml#L1237) | Extra egress rules | `[]` | -| [`networkPolicy.extraIngress`](./values.yaml#L1213) | Additional ingress rules | `[]` | -| [`networkPolicy.ingressMatchSelectorLabels`](./values.yaml#L1228) | Allow traffic from other namespaces | `[]` | -| [`service`](./values.yaml#L990) | Service | [...](./values.yaml#L990) | -| [`service.annotations`](./values.yaml#L999) | Service annotations | `{}` | -| [`service.internalTrafficPolicy`](./values.yaml#L1002) | Service internal traffic policy | `"Cluster"` | -| [`service.port`](./values.yaml#L996) | Service port — see also `config.port` | `5000` | -| [`service.trafficDistribution`](./values.yaml#L1005) | Service [traffic distribution policy](https://kubernetes.io/docs/concepts/services-networking/service/#traffic-distribution) | `nil` | -| [`service.type`](./values.yaml#L993) | Service type | `"ClusterIP"` | +| [`envoySidecar`](./values.yaml#L1163) | Envoy sidecar for consistent hashing by document ID | [...](./values.yaml#L1163) | +| [`envoySidecar.adminPort`](./values.yaml#L1179) | Admin port for Envoy | `9901` | +| [`envoySidecar.enabled`](./values.yaml#L1166) | Enable Envoy sidecar for consistent hashing | `false` | +| [`envoySidecar.healthCheck`](./values.yaml#L1183) | Health check configuration for upstream cluster | [...](./values.yaml#L1183) | +| [`envoySidecar.healthCheck.healthyThreshold`](./values.yaml#L1195) | Healthy threshold | `2` | +| [`envoySidecar.healthCheck.interval`](./values.yaml#L1189) | Health check interval | `"10s"` | +| [`envoySidecar.healthCheck.timeout`](./values.yaml#L1186) | Health check timeout | `"5s"` | +| [`envoySidecar.healthCheck.unhealthyThreshold`](./values.yaml#L1192) | Unhealthy threshold | `2` | +| [`envoySidecar.image`](./values.yaml#L1170) | Envoy sidecar image configuration | [...](./values.yaml#L1170) | +| [`envoySidecar.port`](./values.yaml#L1176) | Port where Envoy sidecar listens | `8080` | +| [`envoySidecar.resources`](./values.yaml#L1199) | Resource limits for Envoy sidecar | [...](./values.yaml#L1199) | +| [`extraIngresses`](./values.yaml#L1054) | Additional ingresses, e.g. for the dashboard | [...](./values.yaml#L1054) | +| [`gateway`](./values.yaml#L1070) | Kubernetes [Gateway API](https://gateway-api.sigs.k8s.io/) | [...](./values.yaml#L1070) | +| [`gateway.annotations`](./values.yaml#L1076) | Annotations for the HTTPRoute resource | `{}` | +| [`gateway.enabled`](./values.yaml#L1073) | Enable Gateway API HTTPRoute | `false` | +| [`gateway.extraHTTPRoutes`](./values.yaml#L1144) | Additional HTTPRoutes, e.g. for the dashboard | [...](./values.yaml#L1144) | +| [`gateway.gateway`](./values.yaml#L1106) | Optional [Gateway](https://gateway-api.sigs.k8s.io/api-types/gateway/) resource. Most clusters have Gateways managed by platform teams; enable this only if you want the chart to create one. | [...](./values.yaml#L1106) | +| [`gateway.gateway.addresses`](./values.yaml#L1139) | Gateway [addresses](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayAddress) | `[]` | +| [`gateway.gateway.annotations`](./values.yaml#L1115) | Annotations for the Gateway resource | `{}` | +| [`gateway.gateway.enabled`](./values.yaml#L1109) | Create a Gateway resource | `false` | +| [`gateway.gateway.gatewayClassName`](./values.yaml#L1112) | GatewayClass name (e.g. `amazon-vpc-lattice`, or a custom ALB class) | `""` | +| [`gateway.gateway.infrastructure`](./values.yaml#L1132) | [Infrastructure](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.GatewayInfrastructure) parameters, e.g. `parametersRef` for AWS Load Balancer Controller | `{}` | +| [`gateway.gateway.labels`](./values.yaml#L1118) | Labels for the Gateway resource | `{}` | +| [`gateway.gateway.listeners`](./values.yaml#L1121) | Gateway [listeners](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.Listener) | `[]` | +| [`gateway.hostnames`](./values.yaml#L1090) | Hostnames for the HTTPRoute | `[]` | +| [`gateway.labels`](./values.yaml#L1079) | Labels for the HTTPRoute resource | `{}` | +| [`gateway.parentRefs`](./values.yaml#L1084) | References to Gateway resources this route attaches to. When `gateway.gateway.enabled` is true and this is empty, the chart-created Gateway is used automatically. See [ParentRef](https://gateway-api.sigs.k8s.io/reference/spec/#gateway.networking.k8s.io/v1.ParentReference) | `[]` | +| [`gateway.rules`](./values.yaml#L1096) | HTTP routing rules. When empty, a default catch-all rule routing to the chart service is created. When rules are provided without `backendRefs`, the chart service is used as the default backend. | `[]` | +| [`ingress`](./values.yaml#L1019) | Ingress | [...](./values.yaml#L1019) | +| [`ingress.annotations`](./values.yaml#L1028) | Ingress annotations | `{}` | +| [`ingress.className`](./values.yaml#L1025) | Ingress class name | `""` | +| [`ingress.enabled`](./values.yaml#L1022) | Enable ingress | `false` | +| [`ingress.hosts`](./values.yaml#L1031) | Hosts | `[]` | +| [`ingress.tls`](./values.yaml#L1045) | Ingress TLS section | `[]` | +| [`networkPolicy`](./values.yaml#L1211) | [Network policy](https://kubernetes.io/docs/concepts/services-networking/network-policies/) | [...](./values.yaml#L1211) | +| [`networkPolicy.allowExternal`](./values.yaml#L1219) | Allow access from anywhere | `true` | +| [`networkPolicy.allowExternalEgress`](./values.yaml#L1243) | Allow the pod to access any range of port and all destinations. | `true` | +| [`networkPolicy.enabled`](./values.yaml#L1214) | Enable network policy | `true` | +| [`networkPolicy.extraEgress`](./values.yaml#L1246) | Extra egress rules | `[]` | +| [`networkPolicy.extraIngress`](./values.yaml#L1222) | Additional ingress rules | `[]` | +| [`networkPolicy.ingressMatchSelectorLabels`](./values.yaml#L1237) | Allow traffic from other namespaces | `[]` | +| [`service`](./values.yaml#L999) | Service | [...](./values.yaml#L999) | +| [`service.annotations`](./values.yaml#L1008) | Service annotations | `{}` | +| [`service.internalTrafficPolicy`](./values.yaml#L1011) | Service internal traffic policy | `"Cluster"` | +| [`service.port`](./values.yaml#L1005) | Service port — see also `config.port` | `5000` | +| [`service.trafficDistribution`](./values.yaml#L1014) | Service [traffic distribution policy](https://kubernetes.io/docs/concepts/services-networking/service/#traffic-distribution) | `nil` | +| [`service.type`](./values.yaml#L1002) | Service type | `"ClusterIP"` | ### Observability | Key | Description | Default | |-----|-------------|---------| -| [`observability`](./values.yaml#L768) | Observability settings | | -| [`observability.log`](./values.yaml#L772) | Logs | [...](./values.yaml#L772) | -| [`observability.log.healthcheckLevel`](./values.yaml#L787) | `HEALTHCHECK_LOGLEVEL` — log level for health checks | `"debug"` | -| [`observability.log.level`](./values.yaml#L775) | `LOG_LEVEL` | `"info"` | -| [`observability.log.structured`](./values.yaml#L778) | `LOG_STRUCTURED` — enable structured logging in JSON format | `false` | -| [`observability.log.structuredFlatten`](./values.yaml#L784) | `LOG_STRUCTURED_FLATTEN` — when structured logging is enabled, emit `meta`, `location`, `exception`, and `extra` fields as top-level dotted fields (e.g. `meta.event`, `location.file`) instead of nested JSON. Useful for OpenTelemetry collector pipelines and log backends that index top-level attributes. Only applies when `observability.log.structured` is `true`. | `true` | -| [`observability.metrics`](./values.yaml#L822) | Metrics configuration | [...](./values.yaml#L822) | -| [`observability.metrics.customTags`](./values.yaml#L828) | Global metrics tags for all exporters: `METRICS_CUSTOM_TAGS` | *generated* | -| [`observability.metrics.grafanaDashboard`](./values.yaml#L870) | Grafana dashboard | [...](./values.yaml#L870) | -| [`observability.metrics.grafanaDashboard.configMap`](./values.yaml#L878) | ConfigMap parameters | [...](./values.yaml#L878) | -| [`observability.metrics.grafanaDashboard.configMap.labels`](./values.yaml#L881) | ConfigMap labels | `{"grafana_dashboard":"1"}` | -| [`observability.metrics.grafanaDashboard.enabled`](./values.yaml#L874) | Enable Grafana dashboard. To work, requires Prometheus metrics enabled in `observability.metrics.prometheusEndpoint.enabled` | `false` | -| [`observability.metrics.grafanaDashboard.tags`](./values.yaml#L891) | Dashboard tags | `["Nutrient","document-engine"]` | -| [`observability.metrics.grafanaDashboard.title`](./values.yaml#L888) | Dashboard title | *generated* | -| [`observability.metrics.prometheusEndpoint`](./values.yaml#L832) | Prometheus metrics endpoint settings | [...](./values.yaml#L832) | -| [`observability.metrics.prometheusEndpoint.enabled`](./values.yaml#L835) | Enable Prometheus metrics endpoint, `ENABLE_PROMETHEUS` | `false` | -| [`observability.metrics.prometheusEndpoint.port`](./values.yaml#L838) | Port for the Prometheus metrics endpoint, `PROMETHEUS_PORT` | `10254` | -| [`observability.metrics.prometheusRule`](./values.yaml#L862) | Prometheus [PrometheusRule](https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md#monitoring.coreos.com/v1.PrometheusRule) Requires `observability.metrics.prometheusEndpoint.enabled` to be `true` | [...](./values.yaml#L862) | -| [`observability.metrics.serviceMonitor`](./values.yaml#L847) | Prometheus [ServiceMonitor](https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md#monitoring.coreos.com/v1.ServiceMonitor) Requires `observability.metrics.prometheusEndpoint.enabled` to be `true` | [...](./values.yaml#L847) | -| [`observability.metrics.statsd`](./values.yaml#L897) | StatsD parameters | [...](./values.yaml#L897) | -| [`observability.metrics.statsd.customTags`](./values.yaml#L910) | StatsD custom tags, `STATSD_CUSTOM_TAGS` | `` | -| [`observability.metrics.statsd.port`](./values.yaml#L906) | StatsD port, `STATSD_PORT` | `9125` | -| [`observability.opentelemetry`](./values.yaml#L791) | OpenTelemetry settings | [...](./values.yaml#L791) | -| [`observability.opentelemetry.enabled`](./values.yaml#L794) | Enable OpenTelemetry (`ENABLE_OPENTELEMETRY`), only tracing is currently supported | `false` | -| [`observability.opentelemetry.otelPropagators`](./values.yaml#L810) | `OTEL_PROPAGATORS`, propagators | `""` | -| [`observability.opentelemetry.otelResourceAttributes`](./values.yaml#L807) | `OTEL_RESOURCE_ATTRIBUTES`, resource attributes | `""` | -| [`observability.opentelemetry.otelServiceName`](./values.yaml#L804) | `OTEL_SERVICE_NAME`, service name | `""` | -| [`observability.opentelemetry.otelTracesSampler`](./values.yaml#L815) | `OTEL_TRACES_SAMPLER`, should normally not be touched to allow custom `parent_based` work, but something like `parentbased_traceidratio` may be considered | `""` | -| [`observability.opentelemetry.otelTracesSamplerArg`](./values.yaml#L818) | `OTEL_TRACES_SAMPLER_ARG`, argument for the sampler | `""` | -| [`observability.opentelemetry.otlpExporterEndpoint`](./values.yaml#L798) | https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/ `OTEL_EXPORTER_OTLP_ENDPOINT`, if not set, defaults to `http://localhost:4317` | `""` | -| [`observability.opentelemetry.otlpExporterProtocol`](./values.yaml#L801) | `OTEL_EXPORTER_OTLP_PROTOCOL`, if not set, defaults to `grpc` | `""` | +| [`observability`](./values.yaml#L777) | Observability settings | | +| [`observability.log`](./values.yaml#L781) | Logs | [...](./values.yaml#L781) | +| [`observability.log.healthcheckLevel`](./values.yaml#L796) | `HEALTHCHECK_LOGLEVEL` — log level for health checks | `"debug"` | +| [`observability.log.level`](./values.yaml#L784) | `LOG_LEVEL` | `"info"` | +| [`observability.log.structured`](./values.yaml#L787) | `LOG_STRUCTURED` — enable structured logging in JSON format | `false` | +| [`observability.log.structuredFlatten`](./values.yaml#L793) | `LOG_STRUCTURED_FLATTEN` — when structured logging is enabled, emit `meta`, `location`, `exception`, and `extra` fields as top-level dotted fields (e.g. `meta.event`, `location.file`) instead of nested JSON. Useful for OpenTelemetry collector pipelines and log backends that index top-level attributes. Only applies when `observability.log.structured` is `true`. | `true` | +| [`observability.metrics`](./values.yaml#L831) | Metrics configuration | [...](./values.yaml#L831) | +| [`observability.metrics.customTags`](./values.yaml#L837) | Global metrics tags for all exporters: `METRICS_CUSTOM_TAGS` | *generated* | +| [`observability.metrics.grafanaDashboard`](./values.yaml#L879) | Grafana dashboard | [...](./values.yaml#L879) | +| [`observability.metrics.grafanaDashboard.configMap`](./values.yaml#L887) | ConfigMap parameters | [...](./values.yaml#L887) | +| [`observability.metrics.grafanaDashboard.configMap.labels`](./values.yaml#L890) | ConfigMap labels | `{"grafana_dashboard":"1"}` | +| [`observability.metrics.grafanaDashboard.enabled`](./values.yaml#L883) | Enable Grafana dashboard. To work, requires Prometheus metrics enabled in `observability.metrics.prometheusEndpoint.enabled` | `false` | +| [`observability.metrics.grafanaDashboard.tags`](./values.yaml#L900) | Dashboard tags | `["Nutrient","document-engine"]` | +| [`observability.metrics.grafanaDashboard.title`](./values.yaml#L897) | Dashboard title | *generated* | +| [`observability.metrics.prometheusEndpoint`](./values.yaml#L841) | Prometheus metrics endpoint settings | [...](./values.yaml#L841) | +| [`observability.metrics.prometheusEndpoint.enabled`](./values.yaml#L844) | Enable Prometheus metrics endpoint, `ENABLE_PROMETHEUS` | `false` | +| [`observability.metrics.prometheusEndpoint.port`](./values.yaml#L847) | Port for the Prometheus metrics endpoint, `PROMETHEUS_PORT` | `10254` | +| [`observability.metrics.prometheusRule`](./values.yaml#L871) | Prometheus [PrometheusRule](https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md#monitoring.coreos.com/v1.PrometheusRule) Requires `observability.metrics.prometheusEndpoint.enabled` to be `true` | [...](./values.yaml#L871) | +| [`observability.metrics.serviceMonitor`](./values.yaml#L856) | Prometheus [ServiceMonitor](https://github.com/prometheus-operator/prometheus-operator/blob/main/Documentation/api.md#monitoring.coreos.com/v1.ServiceMonitor) Requires `observability.metrics.prometheusEndpoint.enabled` to be `true` | [...](./values.yaml#L856) | +| [`observability.metrics.statsd`](./values.yaml#L906) | StatsD parameters | [...](./values.yaml#L906) | +| [`observability.metrics.statsd.customTags`](./values.yaml#L919) | StatsD custom tags, `STATSD_CUSTOM_TAGS` | `` | +| [`observability.metrics.statsd.port`](./values.yaml#L915) | StatsD port, `STATSD_PORT` | `9125` | +| [`observability.opentelemetry`](./values.yaml#L800) | OpenTelemetry settings | [...](./values.yaml#L800) | +| [`observability.opentelemetry.enabled`](./values.yaml#L803) | Enable OpenTelemetry (`ENABLE_OPENTELEMETRY`), only tracing is currently supported | `false` | +| [`observability.opentelemetry.otelPropagators`](./values.yaml#L819) | `OTEL_PROPAGATORS`, propagators | `""` | +| [`observability.opentelemetry.otelResourceAttributes`](./values.yaml#L816) | `OTEL_RESOURCE_ATTRIBUTES`, resource attributes | `""` | +| [`observability.opentelemetry.otelServiceName`](./values.yaml#L813) | `OTEL_SERVICE_NAME`, service name | `""` | +| [`observability.opentelemetry.otelTracesSampler`](./values.yaml#L824) | `OTEL_TRACES_SAMPLER`, should normally not be touched to allow custom `parent_based` work, but something like `parentbased_traceidratio` may be considered | `""` | +| [`observability.opentelemetry.otelTracesSamplerArg`](./values.yaml#L827) | `OTEL_TRACES_SAMPLER_ARG`, argument for the sampler | `""` | +| [`observability.opentelemetry.otlpExporterEndpoint`](./values.yaml#L807) | https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/ `OTEL_EXPORTER_OTLP_ENDPOINT`, if not set, defaults to `http://localhost:4317` | `""` | +| [`observability.opentelemetry.otlpExporterProtocol`](./values.yaml#L810) | `OTEL_EXPORTER_OTLP_PROTOCOL`, if not set, defaults to `grpc` | `""` | ### Pod lifecycle | Key | Description | Default | |-----|-------------|---------| -| [`lifecycle`](./values.yaml#L1297) | [Lifecycle](https://kubernetes.io/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/) | `map[]` | -| [`livenessProbe`](./values.yaml#L1267) | [Liveness probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1267) | -| [`readinessProbe`](./values.yaml#L1280) | [Readiness probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1280) | -| [`startupProbe`](./values.yaml#L1254) | [Startup probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1254) | -| [`terminationGracePeriodSeconds`](./values.yaml#L1293) | [Termination grace period](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/). How long Kubernetes waits after `SIGTERM` before `SIGKILL`. To let a long request finish, keep the pod out of rotation before `SIGTERM` using `lifecycle`, and size this above that delay. | `65` | +| [`lifecycle`](./values.yaml#L1306) | [Lifecycle](https://kubernetes.io/docs/tasks/configure-pod-container/attach-handler-lifecycle-event/) | `map[]` | +| [`livenessProbe`](./values.yaml#L1276) | [Liveness probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1276) | +| [`readinessProbe`](./values.yaml#L1289) | [Readiness probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1289) | +| [`startupProbe`](./values.yaml#L1263) | [Startup probe](https://kubernetes.io/docs/tasks/configure-pod-container/configure-liveness-readiness-startup-probes/) | [...](./values.yaml#L1263) | +| [`terminationGracePeriodSeconds`](./values.yaml#L1302) | [Termination grace period](https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle/). How long Kubernetes waits after `SIGTERM` before `SIGKILL`. To let a long request finish, keep the pod out of rotation before `SIGTERM` using `lifecycle`, and size this above that delay. | `65` | ### Scheduling | Key | Description | Default | |-----|-------------|---------| -| [`affinity`](./values.yaml#L1352) | Node affinity | `{}` | -| [`autoscaling`](./values.yaml#L1305) | [Autoscaling](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/) | [...](./values.yaml#L1305) | -| [`nodeSelector`](./values.yaml#L1349) | [Node selector](https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/) | `{}` | -| [`podDisruptionBudget`](./values.yaml#L1342) | [Pod disruption budget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) | [...](./values.yaml#L1342) | -| [`priorityClassName`](./values.yaml#L1361) | [Priority classs](https://kubernetes.io/docs/concepts/scheduling-eviction/pod-priority-preemption/) | `""` | -| [`replicaCount`](./values.yaml#L1330) | Number of replicas | `1` | -| [`resources`](./values.yaml#L1327) | [Resources](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) | `{}` | -| [`schedulerName`](./values.yaml#L1364) | [Scheduler](https://kubernetes.io/docs/concepts/scheduling-eviction/kube-scheduler/) | `""` | -| [`tolerations`](./values.yaml#L1355) | [Node tolerations](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/) | `[]` | -| [`topologySpreadConstraints`](./values.yaml#L1358) | [Topology spread constraints](https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/) | `[]` | -| [`updateStrategy`](./values.yaml#L1333) | [Update strategy](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#strategy) | `{"rollingUpdate":{},"type":"RollingUpdate"}` | +| [`affinity`](./values.yaml#L1361) | Node affinity | `{}` | +| [`autoscaling`](./values.yaml#L1314) | [Autoscaling](https://kubernetes.io/docs/tasks/run-application/horizontal-pod-autoscale/) | [...](./values.yaml#L1314) | +| [`nodeSelector`](./values.yaml#L1358) | [Node selector](https://kubernetes.io/docs/concepts/scheduling-eviction/assign-pod-node/) | `{}` | +| [`podDisruptionBudget`](./values.yaml#L1351) | [Pod disruption budget](https://kubernetes.io/docs/tasks/run-application/configure-pdb/) | [...](./values.yaml#L1351) | +| [`priorityClassName`](./values.yaml#L1370) | [Priority classs](https://kubernetes.io/docs/concepts/scheduling-eviction/pod-priority-preemption/) | `""` | +| [`replicaCount`](./values.yaml#L1339) | Number of replicas | `1` | +| [`resources`](./values.yaml#L1336) | [Resources](https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/) | `{}` | +| [`schedulerName`](./values.yaml#L1373) | [Scheduler](https://kubernetes.io/docs/concepts/scheduling-eviction/kube-scheduler/) | `""` | +| [`tolerations`](./values.yaml#L1364) | [Node tolerations](https://kubernetes.io/docs/concepts/scheduling-eviction/taint-and-toleration/) | `[]` | +| [`topologySpreadConstraints`](./values.yaml#L1367) | [Topology spread constraints](https://kubernetes.io/docs/concepts/scheduling-eviction/topology-spread-constraints/) | `[]` | +| [`updateStrategy`](./values.yaml#L1342) | [Update strategy](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#strategy) | `{"rollingUpdate":{},"type":"RollingUpdate"}` | ### Storage resource definitions | Key | Description | Default | |-----|-------------|---------| -| [`cloudNativePG`](./values.yaml#L1369) | [CloudNativePG](https://cloudnative-pg.io/) resources | [...](./values.yaml#L1369) | -| [`cloudNativePG.clusterAnnotations`](./values.yaml#L1404) | Cluster annotations | `{}` | -| [`cloudNativePG.clusterLabels`](./values.yaml#L1401) | Cluster labels | `{}` | -| [`cloudNativePG.clusterName`](./values.yaml#L1381) | CloudNativePG custom Cluster name | `"{{ .Release.Name }}-postgres"` | -| [`cloudNativePG.clusterSpec`](./values.yaml#L1385) | CloudNativePG [cluster spec](https://cloudnative-pg.io/documentation/current/cloudnative-pg.v1/#postgresql-cnpg-io-v1-ClusterSpec) | [...](./values.yaml#L1385) | -| [`cloudNativePG.enabled`](./values.yaml#L1372) | Enable CloudNativePG resources | `false` | -| [`cloudNativePG.networkPolicy`](./values.yaml#L1413) | Network policy to allow access to the cluster | `{"enabled":true}` | -| [`cloudNativePG.operatorNamespace`](./values.yaml#L1375) | CloudNativePG operator namespace | `"cnpg-system"` | -| [`cloudNativePG.operatorReleaseName`](./values.yaml#L1378) | CloudNativePG operator release name | `"cloudnative-pg"` | -| [`cloudNativePG.superuserSecret`](./values.yaml#L1407) | Superuser secret to use with the cluster | `{"create":true,"password":"despair","username":"postgres"}` | +| [`cloudNativePG`](./values.yaml#L1378) | [CloudNativePG](https://cloudnative-pg.io/) resources | [...](./values.yaml#L1378) | +| [`cloudNativePG.clusterAnnotations`](./values.yaml#L1413) | Cluster annotations | `{}` | +| [`cloudNativePG.clusterLabels`](./values.yaml#L1410) | Cluster labels | `{}` | +| [`cloudNativePG.clusterName`](./values.yaml#L1390) | CloudNativePG custom Cluster name | `"{{ .Release.Name }}-postgres"` | +| [`cloudNativePG.clusterSpec`](./values.yaml#L1394) | CloudNativePG [cluster spec](https://cloudnative-pg.io/documentation/current/cloudnative-pg.v1/#postgresql-cnpg-io-v1-ClusterSpec) | [...](./values.yaml#L1394) | +| [`cloudNativePG.enabled`](./values.yaml#L1381) | Enable CloudNativePG resources | `false` | +| [`cloudNativePG.networkPolicy`](./values.yaml#L1422) | Network policy to allow access to the cluster | `{"enabled":true}` | +| [`cloudNativePG.operatorNamespace`](./values.yaml#L1384) | CloudNativePG operator namespace | `"cnpg-system"` | +| [`cloudNativePG.operatorReleaseName`](./values.yaml#L1387) | CloudNativePG operator release name | `"cloudnative-pg"` | +| [`cloudNativePG.superuserSecret`](./values.yaml#L1416) | Superuser secret to use with the cluster | `{"create":true,"password":"despair","username":"postgres"}` | ### Other Values | Key | Description | Default | |-----|-------------|---------| -| [`config.hoard.binaryCopyEnabled`](./values.yaml#L250) | `HOARD_BINARY_COPY_ENABLED` — internal parameter, do not change unless explicitly recommended by Nutrient support. | `true` | -| [`config.hoard.binaryCopyThreshold`](./values.yaml#L252) | `HOARD_BINARY_COPY_THRESHOLD` — internal parameter, do not change unless explicitly recommended by Nutrient support. | `2` | -| [`config.http2SharedRendering.checkinTimeoutMilliseconds`](./values.yaml#L263) | `HTTP2_SHARED_RENDERING_PROCESS_CHECKIN_TIMEOUT` — document processing daemon checkin timeout. Do not change unless explicitly recommended by Nutrient support. | `0` | -| [`config.http2SharedRendering.checkoutTimeoutMilliseconds`](./values.yaml#L266) | `HTTP2_SHARED_RENDERING_PROCESS_CHECKOUT_TIMEOUT` — document processing daemon checkout timeout. Do not change unless explicitly recommended by Nutrient support. | `5000` | -| [`revisionHistoryLimit`](./values.yaml#L1337) | [Revision history limit](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#clean-up-policy) | `10` | +| [`config.hoard.binaryCopyEnabled`](./values.yaml#L259) | `HOARD_BINARY_COPY_ENABLED` — internal parameter, do not change unless explicitly recommended by Nutrient support. | `true` | +| [`config.hoard.binaryCopyThreshold`](./values.yaml#L261) | `HOARD_BINARY_COPY_THRESHOLD` — internal parameter, do not change unless explicitly recommended by Nutrient support. | `2` | +| [`config.http2SharedRendering.checkinTimeoutMilliseconds`](./values.yaml#L272) | `HTTP2_SHARED_RENDERING_PROCESS_CHECKIN_TIMEOUT` — document processing daemon checkin timeout. Do not change unless explicitly recommended by Nutrient support. | `0` | +| [`config.http2SharedRendering.checkoutTimeoutMilliseconds`](./values.yaml#L275) | `HTTP2_SHARED_RENDERING_PROCESS_CHECKOUT_TIMEOUT` — document processing daemon checkout timeout. Do not change unless explicitly recommended by Nutrient support. | `5000` | +| [`revisionHistoryLimit`](./values.yaml#L1346) | [Revision history limit](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/#clean-up-policy) | `10` | ## Contribution diff --git a/charts/document-engine/templates/configmap.yaml b/charts/document-engine/templates/configmap.yaml index 9d258a7b..0137f8a4 100644 --- a/charts/document-engine/templates/configmap.yaml +++ b/charts/document-engine/templates/configmap.yaml @@ -18,6 +18,9 @@ data: PSPDFKIT_WORKER_POOL_MAX_SECONDS: {{ .Values.config.workerPoolMaxSeconds | quote }} PDF_GENERATION_TIMEOUT: {{ mul 1000 .Values.config.generationTimeoutSeconds | quote }} REMOTE_URL_FETCH_TIMEOUT: {{ mul 1000 .Values.config.urlFetchTimeoutSeconds | quote }} + DOWNLOADER_WORKER_POOL_SIZE: {{ .Values.config.urlFetchPoolSize | quote }} + DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT: {{ mul 1000 .Values.config.urlFetchQueueTimeoutSeconds | quote }} + DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE: {{ .Values.config.urlFetchQueueMaxSize | quote }} READ_ANNOTATION_BATCH_TIMEOUT: {{ mul 1000 .Values.config.readAnnotationBatchTimeoutSeconds | quote }} {{- with .Values.config.batchRender }} BATCH_RENDER_MAX_CONCURRENCY: {{ .maxConcurrency | quote }} diff --git a/charts/document-engine/values.schema.json b/charts/document-engine/values.schema.json index 8d659e3e..49be3eac 100644 --- a/charts/document-engine/values.schema.json +++ b/charts/document-engine/values.schema.json @@ -645,6 +645,17 @@ "trustedProxies": { "type": "string" }, + "urlFetchPoolSize": { + "type": "integer", + "minimum": 1 + }, + "urlFetchQueueMaxSize": { + "type": "integer", + "minimum": 1 + }, + "urlFetchQueueTimeoutSeconds": { + "type": "integer" + }, "urlFetchTimeoutSeconds": { "type": "integer" }, diff --git a/charts/document-engine/values.yaml b/charts/document-engine/values.yaml index e8e88b37..254207db 100644 --- a/charts/document-engine/values.yaml +++ b/charts/document-engine/values.yaml @@ -107,6 +107,15 @@ config: # -- `REMOTE_URL_FETCH_TIMEOUT` in seconds # @section -- 03. Configuration options urlFetchTimeoutSeconds: 5 + # -- `DOWNLOADER_WORKER_POOL_SIZE`. How many documents are fetched from a remote URL at once, per pod. + # @section -- 03. Configuration options + urlFetchPoolSize: 16 # @schema minimum: 1 + # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected with `503`. + # @section -- 03. Configuration options + urlFetchQueueTimeoutSeconds: 5 + # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. + # @section -- 03. Configuration options + urlFetchQueueMaxSize: 128 # @schema minimum: 1 # -- `READ_ANNOTATION_BATCH_TIMEOUT` in seconds # @section -- 03. Configuration options readAnnotationBatchTimeoutSeconds: 20 From 8641cda7b791f2311a9d28008f722c65ef6ff4b5 Mon Sep 17 00:00:00 2001 From: Omar Date: Thu, 17 Sep 2026 11:16:53 +0300 Subject: [PATCH 2/3] Drop the version gate from the changelog entry The chart has never gated an entry on a Document Engine version. This PR waits for the 1.19.0 release commit, which bumps appVersion first, so the requirement holds by ordering and the entry can read like every other feature entry. --- charts/document-engine/CHANGELOG.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/charts/document-engine/CHANGELOG.md b/charts/document-engine/CHANGELOG.md index ad2655a7..276b3f11 100644 --- a/charts/document-engine/CHANGELOG.md +++ b/charts/document-engine/CHANGELOG.md @@ -1,7 +1,7 @@ # Changelog - [Changelog](#changelog) - - [8.7.0 (2026-09-16)](#870-2026-09-16) + - [8.7.0 (2026-09-17)](#870-2026-09-17) - [8.6.3 (2026-09-02)](#863-2026-09-02) - [8.6.2 (2026-09-01)](#862-2026-09-01) - [8.6.1 (2026-08-25)](#861-2026-08-25) @@ -242,9 +242,9 @@ - [2.0.0](#200) - [Changed](#changed-68) -## 8.7.0 (2026-09-16) +## 8.7.0 (2026-09-17) -* Added `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, which control how many documents Document Engine fetches from a remote URL at once per pod and how long a fetch waits for a free slot. Requires Document Engine 1.19.0 or later. Defaults match the values Document Engine used previously, so an existing deployment is unaffected. +* Added `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, which control how many documents Document Engine fetches from a remote URL at once per pod and how long a fetch waits for a free slot. Defaults match the values Document Engine used previously, so an existing deployment is unaffected. ## 8.6.3 (2026-09-02) From 0cef0ef54a4d9da874a1ad1c4d01238544d58c71 Mon Sep 17 00:00:00 2001 From: Omar Date: Wed, 4 Nov 2026 13:21:11 +0200 Subject: [PATCH 3/3] Constrain the queue timeout and document the queue behaviour --- charts/document-engine/CHANGELOG.md | 2 +- charts/document-engine/README.md | 4 ++-- charts/document-engine/values.yaml | 4 ++-- 3 files changed, 5 insertions(+), 5 deletions(-) diff --git a/charts/document-engine/CHANGELOG.md b/charts/document-engine/CHANGELOG.md index 54a6f2ee..78d422b2 100644 --- a/charts/document-engine/CHANGELOG.md +++ b/charts/document-engine/CHANGELOG.md @@ -247,7 +247,7 @@ ## 8.9.0 (2026-11-04) -* Added `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, which control how many documents Document Engine fetches from a remote URL at once per pod and how long a fetch waits for a free slot. Defaults match the values Document Engine used previously, so an existing deployment is unaffected. +* Added `config.urlFetchPoolSize`, `config.urlFetchQueueTimeoutSeconds` and `config.urlFetchQueueMaxSize`, which control how many documents Document Engine fetches from a remote URL at once per pod, how long a fetch waits for a free slot, and how many may wait at once. Defaults match the values Document Engine used previously, so an existing deployment is unaffected. ## 8.8.0 (2026-10-30) diff --git a/charts/document-engine/README.md b/charts/document-engine/README.md index 3e604c86..f4f97d50 100644 --- a/charts/document-engine/README.md +++ b/charts/document-engine/README.md @@ -455,8 +455,8 @@ Note: | [`config.tileMaxScale`](./values.yaml#L253) | `TILE_MAX_SCALE` — maximum allowed tile scale, calculated as requested tile size divided by actual page size. Must be greater than 1. When unset, no limit is enforced. | `unlimited` | | [`config.trustedProxies`](./values.yaml#L283) | `TRUSTED_PROXIES` — comma-separated list of IP addresses or IP address ranges of trusted proxies. Setting to `default` will use private IP ranges. | `"default"` | | [`config.urlFetchPoolSize`](./values.yaml#L112) | `DOWNLOADER_WORKER_POOL_SIZE`. How many documents are fetched from a remote URL at once, per pod. | `16` | -| [`config.urlFetchQueueMaxSize`](./values.yaml#L118) | `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. | `128` | -| [`config.urlFetchQueueTimeoutSeconds`](./values.yaml#L115) | `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected with `503`. | `5` | +| [`config.urlFetchQueueMaxSize`](./values.yaml#L118) | `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. Once the queue is full, further requests are rejected immediately instead of waiting. | `128` | +| [`config.urlFetchQueueTimeoutSeconds`](./values.yaml#L115) | `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected. A Build API request is rejected with `503`. Should not be greater than `config.requestTimeoutSeconds`. | `5` | | [`config.urlFetchTimeoutSeconds`](./values.yaml#L109) | `REMOTE_URL_FETCH_TIMEOUT` in seconds | `5` | | [`config.workerPoolMaxRestarts`](./values.yaml#L94) | Maximum number of restarts (`PSPDFKIT_WORKER_POOL_MAX_RESTARTS`) before supervisor starts throttling them. | `20` | | [`config.workerPoolMaxSeconds`](./values.yaml#L97) | Time window in which the supervisor monitors the number of restarts (`PSPDFKIT_WORKER_POOL_MAX_SECONDS`). | `60` | diff --git a/charts/document-engine/values.yaml b/charts/document-engine/values.yaml index 7409b263..9be1d40a 100644 --- a/charts/document-engine/values.yaml +++ b/charts/document-engine/values.yaml @@ -110,10 +110,10 @@ config: # -- `DOWNLOADER_WORKER_POOL_SIZE`. How many documents are fetched from a remote URL at once, per pod. # @section -- 03. Configuration options urlFetchPoolSize: 16 # @schema minimum: 1 - # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected with `503`. + # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_TIMEOUT` in seconds. How long a remote fetch waits for a free slot before it is rejected. A Build API request is rejected with `503`. Should not be greater than `config.requestTimeoutSeconds`. # @section -- 03. Configuration options urlFetchQueueTimeoutSeconds: 5 # @schema minimum: 1 - # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. + # -- `DOWNLOADER_BROKER_CLIENT_QUEUE_MAX_SIZE`. How many remote fetches may wait for a free slot at once. Once the queue is full, further requests are rejected immediately instead of waiting. # @section -- 03. Configuration options urlFetchQueueMaxSize: 128 # @schema minimum: 1 # -- `READ_ANNOTATION_BATCH_TIMEOUT` in seconds