Környezeti változók referenciája
Ezek a táblázatok a repóban található *.env.example fájlokból és a gyökér compose.yaml fájlból ismert konfigurációs csoportokat fedik le. Az egységes stack a motherrepo gyökér .env fájlját olvassa. Az önálló példák csak a saját, külön belépési pontjukra vonatkoznak.
Kezdd a környezeti konfigurációval. A szolgáltató-előfeltételekhez használd a fiók bejelentkezést, a Microsoft Graph és a Google Cloud oldalakat.
A sablonérték nem mindig kódbeli alapérték. Az üres kötelező mezőkhöz setup-értékek kellenek. A hitelesítő adatokat tartsd privátan. A portok egész számú host-portok, ha egy támogatott felülírás ilyet ad meg. Az üres és a hiányzó felülírások eltérhetnek.
Az ECS_EFFECTIVE_* értékek belső kimenetek. A runtime a validált helyi és távoli bemenetekből származtatja őket. Soha ne add őket felhasználói konfigurációhoz vagy archívumhoz. A titkot tartalmazó Java-konfiguráció nem kerülhet naplóba.
Gyökér runtime és infrastruktúra
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
ECAS_BOOTSTRAP_ADMIN_EMAIL | Első adminisztrátor e-mail-címe. | Üres. A gyökér Compose feloldásához kötelező. Az Account a kezdeti beállításkor használja. |
ECAS_BOOTSTRAP_ADMIN_PASSWORD | Első adminisztrátor jelszava. | Üres. Adj meg egy privát, 32–64 karakteres jelszót. A gyökér Compose feloldásához a kezdeti beállítás után is kötelező. |
ECS_INSTANCE_ID | Kisbetűs példánynév a stackhez, a hosztnevekhez és az erőforrás-névtérhez. | Üres. Beállításkor kötelező, például devbox. |
ECS_APPLICATION_SOURCE_ROOT | Abszolút alkalmazásforrás-útvonal buildekhez és csatolásokhoz. | . ezt a checkoutot használja. Opcionális. A runtime és a Compose használja. |
ECS_MEMORY_GIB | Az alkalmazás-konténerek teljes memóriakerete GiB-ben. A host-tartalék ezen felül van. | Példa 40, a runtime alapértéke 30, ha az érték kimarad. Elfogadott értékek: 8, 12, 16, 30, 35, 40, 44. A fejlesztési minimumok 30 és 35 GiB-nál emelkednek. |
POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB | PostgreSQL inicializáló felhasználó, jelszó és adatbázis. | postgres, üres jelszó, mailGen. A jelszó kötelező. Az alkalmazáskapcsolatoknak az inicializált adatbázishoz kell illeszkedniük. |
S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET_EMAIL_BODIES, S3_REGION | SeaweedFS S3 hozzáférési azonosító, titkos kulcs, bucket és AWS-stílusú régió. | Üres hitelesítő adatok, ecas, us-east-1. A BFF/backend/.NET objektum-hozzáféréséhez kötelező. |
SEAWEEDFS_ADMIN_PASSWORD | SeaweedFS adminisztrációs jelszava. Független az S3 titkos kulcstól. | Üres. Helyi kiépítéshez adj meg privát értéket. |
KAFKA_CLUSTER_ID | Tartós Kafka-fürtazonosító Kafka Base64 UUID formátumban. | Üres. A kezdeti beállításhoz és a tulajdonjog-ellenőrzéshez kötelező. Meglévő adatoknál őrizd meg. |
KAFKA_APP_PASSWORD, KAFKA_ADMIN_PASSWORD, KAFKA_UI_PASSWORD | Külön Kafka alkalmazás-, adminisztrációs és UI-jelszavak. | Üres. Az aktív Kafka-szolgáltatások és kliensek megkövetelik. |
INTERNAL_PROXY_SECRET, KEYSTORE_INTERNAL_TOKEN | Belső proxy-hitelesítés és KeyStore API-token. | Üres. Az engedélyezett belső API-k megkövetelik. Egyezzenek a fogyasztók között. |
DRAGONFLY_PASSWORD, REDIS_VIEWER_PASSWORD | Dragonfly-hitelesítés és csak olvasható Redis-viewer jelszó. | Üres. Mindkettő kötelező a gyökér Compose feloldásához, akkor is, ha nem használod a viewert. |
CLOUDFLARE_TOKEN, CLOUDFLARE_ACCOUNT_ID, CLOUDFLARE_ZONE_ID | Cloudflare API-token, fiókazonosító és zónaazonosító. | Nincs hitelesítő alapérték. A kiválasztott fiók- és zónaazonosítónak egyenként 32 hexadecimális karakterből kell állnia. A kezelési tokennek kell: fiók Tunnel Write, zóna DNS Edit/Read, valamint Zone Read. Lásd: ingress és tulajdonjog-helyreállítás. |
BFF_MICROSOFT_CLIENT_ID, BFF_MICROSOFT_CLIENT_SECRET, BFF_MICROSOFT_TENANT_ID | Microsoft alkalmazás-bejelentkezés kliensazonosítója, titka és bérlőazonosítója. | Üres. A Microsoft-bejelentkezéshez kötelező. A backend Graph-hozzáféréstől független. |
BACKEND_TENANT_ID, BACKEND_CLIENT_ID, BACKEND_CLIENT_SECRET | Backend-bootstrap és az aktuális GraphOneTimeUserOnboarder csak alkalmazás (app-only) Graph-azonosítója. | Üres, nincs hitelesítő alapérték. Ezekhez a Microsoft-runtime-okhoz kötelező, beleértve az önálló Graph-worker futtatást is. A gyökér Compose a neveket változatlanul továbbítja. Független a BFF_MICROSOFT_* bejelentkezési adatoktól. |
GRAPH_WEBHOOK_URL, GRAPH_LIFECYCLE_WEBHOOK_URL | Nyilvános HTTPS értesítési és életciklus-callback URL-ek. | Üres. A feliratkozásokhoz kötelező. Használd ennek a deploymentnek a saját domainjét vagy tunnelját. |
GRAPH_WEBHOOK_CLIENT_STATE | Stabil Graph-callback-validációs titok. | Üres. Legfeljebb 128 karakter. Aktív feliratkozásoknál őrizd meg. |
DELTA_LINK_ENCRYPTION_KEY | Pontosan 32 véletlen bájt Base64 kódolása. | Üres. A megőrzött, titkosított Graph delta-állapothoz kötelező. Helyreállítás vagy migráció nélkül ne forgasd. |
ECS_DEPLOYMENT_MODE, ECS_REMOTE_SIMULATION | Infrastruktúra-elhelyezési és helyi szimulációs választók. | fulllocal / partialRemote, true / false. Hiányzó érték esetén fulllocal / false. |
REMOTE_KAFKA_BOOTSTRAP_SERVERS | Vesszővel elválasztott távoli broker host:port lista. | A példa broker1:9092,broker2:9092,broker3:9092 helyi szimulációs adat. Cseréld elérhető távoli endpointokra. |
REMOTE_KAFKA_SECURITY_PROTOCOL, REMOTE_KAFKA_SASL_MECHANISM | Távoli Kafka-protokoll és SASL-mechanizmus. | Példa sasl_plaintext, PLAIN. Valódi plaintext csak kanonikus Tailscale IPv4-endpointokon használható. Ellenkező esetben használd a sasl_ssl-t. |
REMOTE_KAFKA_APP_USERNAME, REMOTE_KAFKA_APP_PASSWORD, REMOTE_KAFKA_ADMIN_USERNAME, REMOTE_KAFKA_ADMIN_PASSWORD | Külön távoli alkalmazás- és adminisztrátori hitelesítő adatok. | A példa helyi változókra hivatkozik. Csak akkor használd őket, ha egyeznek a távoli fürttel. |
REMOTE_KAFKA_EXPECTED_CLUSTER_ID | Elvárt, meglévő távoli Kafka-fürtazonosító. | A példa a KAFKA_CLUSTER_ID-ra hivatkozik. A távoli tulajdonjog-ellenőrzéshez kötelező. |
REMOTE_CLAMAV_HOST, REMOTE_CLAMAV_PORT | Privát TCP-vírusirtó host és port. | Példa clamav, 3310. Csak jóváhagyott TCP-scannerhez használd. A Docker hosztnév nem távoli privát IP. |
REMOTE_CLAMAV_SCAN_URL, REMOTE_CLAMAV_SCAN_TOKEN | Pontos HTTPS scanner /scan URL és bearer token. | Üres. HTTPS-scanneléshez add meg mindkettőt. Valódi távoli módban hitelesített átvitel kötelező. |
REMOTE_COLLABORA_URL | Collabora HTTP(S) origin hitelesítő adatok és endpoint-útvonal nélkül. | Példa http://collabora:9980. A távoli Office-előnézethez kötelező. |
REMOTE_WOPI_ORIGIN, REMOTE_WOPI_ALLOWED_CIDRS | Helyi BFF callback origin és engedélyezett renderelő-forrás CIDR-ek. | Példa http://bff:5173, üres CIDR-ek. Valódi távoli módban elérhető callback és szűk forrás-allowlist kell. |
WOPI_CALLBACK_MODE, WOPI_TAILSCALE_HOST, WOPI_TAILSCALE_BIND_IP, WOPI_TAILSCALE_PORT | Callback-mód, helyi Tailscale-hosztnév, bind IP és port. | private, üres bind-értékek. A tailscale-proof módhoz kötelező. Azonosítsd ezt a fejlesztői gépet. |
REMOTE_KNOWLEDGE_EXTRACTOR_URL, REMOTE_KNOWLEDGE_EXTRACTOR_TOKEN | Extractor origin és külön szolgáltatás-token. | Példa http://knowledge-extractor:9998, üres token. Valódi távoli módban a hitelesített HTTPS-pár kötelező. |
REMOTE_QDRANT_URL, REMOTE_QDRANT_API_KEY | Qdrant origin és API-kulcs. | Példa http://qdrant:6333, helyi kulcs-hivatkozás. Valódi távoli módban használd a tényleges távoli hitelesítő adatokat. |
További Compose-bemenetek
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
ACCOUNT_LOCALHOST_ENABLED, ACCOUNT_LOGIN_ENABLED, BFF_LOCALHOST_ENABLED, FORMGEN_LOCALHOST_ENABLED | Account/BFF/FormGen localhost- és bejelentkezési funkciókapcsolók. | Az egységes ACCOUNT_LOGIN_ENABLED alapértéke true. Az ACCOUNT_LOCALHOST_ENABLED, BFF_LOCALHOST_ENABLED és FORMGEN_LOCALHOST_ENABLED alapértéke false. A BFF önálló sémájában az Account-bejelentkezés alapértéke false. Az Account-bejelentkezési útvonalak és a localhost-integráció különböző kapcsolókat használnak. |
ANTHROPIC_API_KEY, GOOGLE_AI_KEY, NEBIUS_API_KEY, OPENAI_API_KEY, OPENROUTER_API_KEY | AI-szolgáltatók API-kulcsai. | Nincs nyilvános alapérték. Titkot csak a kiválasztott szolgáltató funkcióihoz adj meg. |
AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, S3_BUCKET | Egyéb AWS-kompatibilis integrációk: hozzáférési kulcs, titok, régió és bucket. | Szolgáltatásspecifikus opcionális bemenetek. Nem helyettesítik a kanonikus Graph-törzs S3_* beállításait. |
BFF_GOOGLE_CLIENT_ID, BFF_GOOGLE_CLIENT_SECRET, BFF_GOOGLE_LOGIN_CLIENT_ID, BFF_GOOGLE_LOGIN_CLIENT_SECRET | Google-alkalmazásazonosító és külön bejelentkezési OAuth-hitelesítő mezők. | Üres. Adj meg egy teljes, kiválasztott klienspárt. A kliens-titkok privátok maradnak. |
BFF_KEYCLOAK_CLIENT_ID, BFF_KEYCLOAK_CLIENT_SECRET, BFF_KEYCLOAK_ISSUER | BFF Keycloak OIDC kliensazonosító, titok és kiállító. | Továbbított kompatibilitási mezők, alapértelmezésben üresek. A jelenlegi Account/BFF bejelentkezési szolgáltató-gyár Microsoftot és Google-t választ, Keycloaket nem. Ezekhez a BFF-specifikus Keycloak-bemenetekhez nem találtam aktuális használót. A FormGen saját, külön Keycloak-konfigurációt használ. |
BFF_STATUS_CONSUMER_GROUP, BFF_REALTIME_CONSUMER_GROUP, KAFKA_CONSUMER_GROUP_PREFIX | Kafka státusz- és realtime-csoportnevek, valamint a csoport-előtag. | Az egységes BFF_STATUS_CONSUMER_GROUP alapértéke üres, és jelenleg nincs BFF- vagy backend-olvasás a production forrásból. A BFF realtime-csoport alapértéke bff-graph-sync-realtime-v1. A backend csoport-előtag alapértéke üres, csak ASCII betűket, számjegyeket, pontot, aláhúzást és kötőjelet fogad el, és változatlanul fűzi elé. A csoportváltoztatás hatással van az offsetekre. |
BODY_ENCRYPTION_ALLOW_LEGACY_READ, BODY_ENCRYPTION_REQUIRED | Örökölt, titkosítatlan olvasási engedély és egy továbbított kompatibilitási jelző. | A BODY_ENCRYPTION_ALLOW_LEGACY_READ alapértéke false. Csak a szó szerinti true engedélyezi, kivéve az EMAIL_ENCRYPTION_MIGRATED_OWNERS tulajdonosait. A Compose a BODY_ENCRYPTION_REQUIRED értéket alapértelmezetten true-ra továbbítja, de a jelenlegi BFF- és backend-éles kód nem olvassa. A kötelező titkosítást a tulajdonos- és csoportszabály adja. Ez nem működő felülírás. Tartsd meg a szabályt, és olvasd el a titkosítási beállításokat. |
COMPLEXITY_GETTER_PORT, COMPLEXITY_SERVICE_PORT, COMPLEXITY_UPLOAD_PORT, COMPLEXITY_MAX_PARALLEL_RUNS, MAX_ACTORS_PER_COMPLEXITY_PARTITION | Complexity WebSocket/API portok, párhuzamos futások korlátja és szereplők partíciónként. | A Compose szolgáltatás-, getter- és upload-portok alapértéke 6590/6591/6592. A BFF a szolgáltatás- és getter-portokat 1–65535 közötti egész számként ellenőrzi. A párhuzamos futások alapértéke 4, a BFF/backend belépési ellenőrzés 1–32 közé szorítja. A partíciónkénti szereplők alapértéke 1, a command-outbox kód a véges bemenetet lefelé kerekíti, majd legalább 1-re emeli. Ezek belső szolgáltatásbeállítások, nem közzétett host-portok. |
DEV_DOMAIN_SUFFIX | Példány-hosztnév végződése. | ecas.local. A runtime ehhez fűzi a példányazonosítót a proxy-hosztokhoz. |
DOCUSAURUS_MCP_ENABLED | Docusaurus MCP sidecar-kapcsoló. | Alapérték false a Compose-ban. A lifecycle true-ra állítja, ha a docs-mcp van kiválasztva. A Docusaurus-konfiguráció ezzel engedélyezi a sidecar-integrációt. |
DOTNET_USE_POLLING_FILE_WATCHER, WATCHPACK_POLLING, FORMGEN_WATCHPACK_POLLING | .NET/Watchpack/FormGen fájl-lekérdezési kapcsolók. | Az egységes Watchpack és .NET polling alapértéke false. A FormGen továbbítása szintén false. A megfelelő fejlesztési watcher használja a jelzőt. Csak hiányzó bind-mount értesítések esetén használd, mert a polling növelheti a CPU-használatot. |
ECS_CPUSET | Megosztott logikai CPU-lista runtime-szolgáltatásokhoz. | Opcionális, például 0-19. Az indító a kihagyott értéket a Docker által látható CPU-khoz igazítja. |
ECS_BUILD_CPUSET | Logikai CPU-lista éles buildekhez. | Opcionális, például 0-7. Az indító legfeljebb 20 CPU-t származtat, függetlenül. A nyers éles Compose az ECS_CPUSET-re, majd 0-19-re esik vissza. |
ECS_MEMORY_MODE, ECS_SWAP_GIB | Memóriamód és további swap-keret GiB-ben. | Alapérték bounded, vagy hybrid. A swap alapértéke 4, elfogadott 0–8. A hybrid módhoz systemd cgroups v2 és jelszó nélküli sudo systemctl kell. |
ECS_PROXY_STATE_DIR, ECS_NPM_CONTAINER_ID, PROXY_ADMIN_BIND_IP, NPM_ADMIN_EMAIL, NPM_ADMIN_PASSWORD, NPM_HTTP_PORT, NPM_HTTPS_PORT, NPM_ADMIN_PORT | Megosztott NPM-állapotkönyvtár és -konténer, adminisztrációs bind és bejelentkezés, valamint HTTP/HTTPS/admin portok. | Az állapotútvonal automatikus. Az admin bind 127.0.0.1. A portoknak el kell kerülniük az ütközést. A jelszó titok. |
ECS_CLONE_ROOT, ECS_UID, ECS_GID | Abszolút klón-gyökér és numerikus host-felhasználó- és csoportazonosítók. | A runtime által generált csatolási tulajdonosi bemenetek. Ne állítsd be kézzel a gyökér konfigurációban. |
ECS_TEST_INSTANCE | Izolált teszt-jelölő. | A tesztbeállítás generálja. Ne használd kézi gyökér-bemenetként. |
ECAS_DEPLOYMENT_TENANT_ID | Stabil deployment jogosultsági tenant UUID. | Google-only vagy személyes deploymenteknél kötelező, külön megadva. Nem e-mail-cím vagy domain. |
EMAIL_FROM, SMTP_HOST, SMTP_PORT, SMTP_USER, SMTP_PASSWORD | Kimenő e-mail feladó és SMTP host, port, felhasználó, jelszó. | Üres, a port egész szám. Csak a kiválasztott e-mail-küldő igényli. |
ENCRYPTION_KEY, LLM_DB_DECRIPTION_KEY | Örökölt kulcsbemenetek, amelyeket a BFF/backend továbbít. | Üres alapértékek. Nem helyettesítik a delta-, mailbox- vagy adminisztrációs kulcsokat. Őrizd meg a meglévő örökölt értékeket. |
MAILBOX_CONTENT_KEK_KEYS_JSON | Mailbox kulcstitkosító-kulcs (KEK) verziók szigorú JSON-tömbje. | Compose-alapérték []. Példa elem: {"reference":"mailbox-v1","version":1,"keyPath":"/runtime/mailbox-content-keys/mailbox-kek"}. A verzió pozitív, a fájlnak a konténerből olvashatónak kell lennie. A KeyStore használja a listát. |
MAILBOX_CONTENT_KEK_REFERENCE, MAILBOX_CONTENT_KEK_VERSION | Aktív kulcstitkosító-kulcs hivatkozása és pozitív egész verziója. | Az egységes Compose mindkettőt üresre állítja alapértelmezésben. Adj meg nem üres hivatkozást és pozitív egész verziót, amely pontosan egy JSON-bejegyzéssel egyezik. A mailbox-v1 / 1 példa, nem automatikus aktív kulcs. A KeyStore használja a párt. Forgatás közben tartsd meg a régebbi verziókat. |
MAILBOX_CONTENT_KEY_SECRET_DIRECTORY | A mailbox kulcstitkosító-kulcs-fájlokhoz csatolt host-könyvtár. | Az egységes host-alapérték ./.docker-state/mailbox-content-keys, csak olvasható csatolással a /runtime/mailbox-content-keys alatt. A JSON keyPath értékeknek konténerből olvasható útvonalat kell használniuk. A kiválasztott fájlok egyenként pontosan 32 bájtnyi Base64 tartalmat tartalmaznak. A KeyStore olvassa őket. |
FORMGEN_AUTH_TRUSTED_IP_HEADER | Megbízható proxy kliens-IP fejlécének neve. | Csak olyan fejlécet használj, amelyet a megbízható proxy felülír. A FormGen használja. |
FORMGEN_BETTERAUTH_SECRET, FORMGEN_BETTERAUTH_URL, FORMGEN_MYSQL_PASSWORD | FormGen auth-munkamenet titka, nyilvános origin és MySQL-jelszó. | Privát értékek és saját HTTPS-origin. A FormGen-profil igényli. |
FORMGEN_CDN_MAX_SIZE | CDN_MAX_SIZE-ként továbbított kompatibilitási érték. | Compose-alapérték 10. Nem találtam aktuális FormGen feltöltési kódhasználót. Mértékegysége nincs definiálva, és módosítása nem hangolja a megvalósított feltöltési korlátokat. Lásd: tényleges FormGen-korlátok. |
FORMGEN_DEFAULT_REGISTER_ROLE | Nyilvános FormGen-regisztráció kezdeti szerepköre. | MEMBER vagy GUEST. Az alapérték és a tartalék GUEST, kivéve, ha az érték pontosan MEMBER. |
FORMGEN_SITE_INVITE_ONLY | Meghívó megkövetelése FormGen-regisztrációhoz. | Alapérték true. Csak akkor állítsd false-ra, ha nyilvános regisztrációt akarsz engedni. |
FORMGEN_GOOGLE_CLIENT_ID, FORMGEN_GOOGLE_CLIENT_SECRET, FORMGEN_KEYCLOAK_CLIENT_ID, FORMGEN_KEYCLOAK_CLIENT_SECRET, FORMGEN_KEYCLOAK_ISSUER, FORMGEN_MICROSOFT_CLIENT_ID, FORMGEN_MICROSOFT_CLIENT_SECRET, FORMGEN_MICROSOFT_TENANT_ID | FormGen OAuth-kliens-hitelesítő adatok és Keycloak-kiállító. | Üres, szolgáltató-URL vagy privát titkok. Csak engedélyezett FormGen-bejelentkezési szolgáltatókhoz add meg. |
FORMGEN_SMTP_HOST, FORMGEN_SMTP_PORT, FORMGEN_SMTP_USER, FORMGEN_SMTP_PASSWORD, FORMGEN_SMTP_SECURE | FormGen SMTP-host, egész számú port, hitelesítő adatok és TLS-jelző. | Egységes alapértékek: host formgen-mailcatcher, port 1025, secure false, felhasználó noreply@mailcatcher.test, és csak helyi fejlesztési jelszó. Ezt a jelszót ne használd éles környezetben. A FormGen minden kapcsolati mezőt megkövetel, és a portot parseInt-tel olvassa. Külön secure érték hiányában az alapérték az, hogy a NODE_ENV production-e. A megadott érték levágva, kis- és nagybetű-érzéketlenül a true-val egyezik. |
FORMGEN_WATCHPACK_POLLING | FormGen fájl-lekérdezési választó. | Compose-alapérték false, a FormGen fejlesztésében WATCHPACK_POLLING-ként továbbítva. Használd a true-t, ha a bind-mount watcher-események hiányoznak. |
GOOGLE_APP_LOGIN_CALLBACK_URL, GOOGLE_APP_LOGIN_ENABLED, GOOGLE_APP_LOGIN_PROXY_SECRET | Google-alkalmazás-bejelentkezés callback URL-je, engedélyező kapcsolója és belső proxy-titka. | Alapértelmezetten letiltva. Pontos HTTPS /api/auth/callback/google, query és fragment nélkül, hitelesítő adatok nélkül. A proxy-titok legalább 32 karakter. |
GOOGLE_DIRECTORY_POLICIES_JSON | Google-könyvtári szabály JSON-tömb. | Minden elem: UUID workspaceConnectionId, logikai directoryEnabled, opcionális string-tömb visibleGroupIds, és opcionális oauthMailboxBindings, UUID mailbox- és hitelesítő-forrás-azonosítókkal és string könyvtári felhasználói azonosítóval. Az üres érték azt jelenti, hogy nincs explicit szabály. |
GOOGLE_PUBSUB_CONFIG_JSON | Google push-útvonal-JSON tömb. | Minden elemnek kell: topicName, subscriptionId, pontos HTTPS /v1/pubsub/push pushAudience, pushServiceAccountEmail, pushServiceAccountSubject, és oauthClientId vagy workspaceCredentialReference. A topic és a subscription egy projektben legyen. Az IAM külön előfeltétel a mailbox-hozzájárulástól. |
GOOGLE_MAILBOX_BFF_COMPLETION_URL, GOOGLE_MAILBOX_CALLBACK_URL, GOOGLE_MAILBOX_CLIENT_ID, GOOGLE_MAILBOX_CLIENT_SECRET_PATH, GOOGLE_MAILBOX_GRANT_KEY_REFERENCE, GOOGLE_MAILBOX_OAUTH_ENABLED, GOOGLE_MAILBOX_SECRET_DIRECTORY, GOOGLE_MAILBOX_SYNC_ENABLED, GOOGLE_MAILBOX_WATCH_ENABLED | Google mailbox OAuth-, sync- és watch-beállítások, kliensazonosító, titok-könyvtár és -útvonal, grant-kulcs-hivatkozás, valamint callback és befejezési URL-ek. | A jelzők alapértéke false. A callback HTTPS /v1/oauth/callback. A befejezés: /api/google-mailbox/complete a MAILGEN_PUBLIC_URL értéken. Nincs URL-hitelesítő adat, query vagy fragment. A titokfájl nyers, nem üres titkot tartalmaz, nem exportált JSON-t. A bejelentkezési kliens külön marad. |
GOOGLE_QUOTA_REDIS_URL | Redis/Dragonfly URL a megosztott Google API-kvóta-koordinációhoz. | redis://<host>:<port>. Tartalmazhat hitelesítő adatokat. A párhuzamos Google-workerek használják. |
GOOGLE_MAILBOX_CLIENT_SECRET_PATH | Dedikált mailbox OAuth-kliens-titokfájl. | Konténerből olvasható titok-csatolás. Nyers, nem üres szöveg, nem OAuth-export JSON. Kötelező, ha a mailbox-kliensazonosító be van állítva. |
GOOGLE_MAILBOX_GRANT_KEY_PATH | Mailbox OAuth grant-titkosítási kulcsfájl. | Konténerből olvasható útvonal. A Base64 tartalomnak pontosan 32 bájtra kell dekódolódnia. Meglévő grant-ekkel őrizd meg. |
GOOGLE_WORKSPACE_CREDENTIALS_JSON, GOOGLE_WORKSPACE_SECRET_DIRECTORY | Workspace-hitelesítő adatok allowlistje és szolgáltatásfiók-titok-könyvtár. | Alapérték [], /run/secrets/google. Minden bejegyzés: reference, abszolút, konténerből olvasható keyPath, directoryAdminSubject, és approvedScopes tömb. Domain-szintű delegáláshoz használt. |
KAFKA_TOPIC_BFF_COMMANDS, KAFKA_TOPIC_BFF_COMMANDS_DLQ, KAFKA_TOPIC_COMPLEXITY_COMMANDS, KAFKA_TOPIC_COMPLEXITY_DLQ, KAFKA_TOPIC_COMPLEXITY_NOTIFICATIONS, KAFKA_TOPIC_EMAIL_SCHEDULER_COMMANDS, KAFKA_TOPIC_EMAIL_SCHEDULER_DLQ, KAFKA_TOPIC_GRAPH_SYNC_APPLY, KAFKA_TOPIC_GRAPH_SYNC_DLQ, KAFKA_TOPIC_GRAPH_SYNC_FETCH, KAFKA_TOPIC_GRAPH_SYNC_NOTIFICATIONS, KAFKA_TOPIC_GRAPH_SYNC_PROJECTION, KAFKA_TOPIC_GRAPH_SYNC_TRIGGERS, KAFKA_TOPIC_INDEPENDENT_COMMANDS, KAFKA_TOPIC_INDEPENDENT_COMMANDS_DLQ, KAFKA_TOPIC_MAILBOX_STATUS, KAFKA_TOPIC_MAILBOX_STATUS_DLQ, KAFKA_TOPIC_MOCK_ORDERS, KAFKA_TOPIC_MOCK_PAGEVIEWS, KAFKA_TOPIC_MOCK_USERS, KAFKA_TOPIC_ONBOARDING_COMMANDS, KAFKA_TOPIC_ONBOARDING_DLQ, KAFKA_TOPIC_ONBOARDING_ERRORS, KAFKA_TOPIC_ONBOARDING_LIFECYCLE, KAFKA_TOPIC_QUEUEPROCESSOR_COMMANDS, KAFKA_TOPIC_QUEUEPROCESSOR_COMMANDS_DLQ, KAFKA_TOPIC_SEARCH_COMMANDS, KAFKA_TOPIC_SEARCH_COMMANDS_DLQ, KAFKA_TOPIC_USER_CREATED, KAFKA_TOPIC_USER_CREATED_DLQ, KAFKA_TOPIC_APP_REALTIME | Külön parancs-, esemény-, projekció-, státusz-, onboarding-, keresési és dead-letter topic-nevek. | Formátumpélda app.<domain>.<action>.v1. A név és a verzió egyezzen a producerek és a consumerek között. A DLQ-utótag sikertelen eseményeket jelöl. |
KEYSTORE_CACHE_TTL_SECONDS, KEYSTORE_LEASE_SECONDS, KEYSTORE_INTERNAL_TOKEN | KeyStore cache- és lease-élettartam másodpercben, plusz belső API-token. | A KeyStore lease alapértéke 3600 másodperc, a cache alapértéke 300 másodperc. Mindkettő 1–86400 közötti egész számot fogad el. Az effektív cache min(cache, lease). A backend és a belső kliensek a megfelelő privát API-tokent használják. Lásd: személyes kulcs runtime. |
KNOWLEDGE_QDRANT_COLLECTION, QDRANT_API_KEY | Qdrant-gyűjteménynév és API-kulcs. | A gyűjtemény alapértéke ecas_knowledge_small_1536. A nevek 1–64 ASCII betűt, számjegyet, aláhúzást vagy kötőjelet fogadnak el. A lib/knowledge/vectors.ts ellenőrzi a nevet, és Qdrant URL-t és API-kulcsot igényel. A gyűjteményszerződés 1536 dimenziós Cosine vektorokat használ. Az API-kulcsnak nincs nyilvános alapértéke. |
MAX_USERS_PER_Q | Örökölt Q-worker felhasználó/partíció-kapacitás. | Pozitív egész szám. Ne keverd össze a MAX_USERS_PER_QueProcessor_PARTITION-nel. |
MICROSOFT_CONNECTOR_ENABLED | Microsoft-connector-kapcsoló. | true / false, alapértelmezésben engedélyezett. Engedélyezés előtt készítsd elő a hitelesítő adatokat. |
BETTER_AUTH_URL, NEXT_PUBLIC_BETTER_AUTH_URL | Better Auth szerver- és böngészőoldali origin. | Az egységes értékek mindkettőben Account HTTPS-t használnak, például https://account.<instance>.<suffix>:8443. Az önálló BFF localhost-példák másik belépési pontot szolgálnak ki. Soha ne írj ide titkot. |
OPENSEARCH_INDEX, OPENSEARCH_ENCRYPTED_INDEX | Sima és titkosított e-mail-indexnevek. | emails-onboarding, opcionálisan üres titkosított név. A titkosított bevezetéshez állítsd be a migrációs indexet. |
POSTGRES_CONNECTION_STRING | Npgsql-kapcsolati string, nem URI. | A setup a PostgreSQL-bemenetekből építi. Szintaxis: Host=...;Port=...;Database=...;Username=...;Password=.... Idézd és escape-eld az elválasztókat. A Compose változatlanul továbbítja a .NET felé. A DATABASE_URL és a BETTERAUTH_DATABASE_URL külön PostgreSQL URI-k. |
REDIS_VIEWER_USER, REDIS_VIEWER_PASSWORD | Csak olvasható Redis-viewer felhasználónév és jelszó. | Felhasználó admin, privát jelszó. Az egységes Compose feloldásához a jelszó mindig kötelező. Független az alkalmazás-hitelesítő adatoktól. |
RESEND_SECRET | Resend API-titok. | Titokkezelő-érték. Csak Resend e-mail-küldésnél kötelező. |
SEED_ADMIN_EMAIL, SEED_ADMIN_NAME, SEED_ADMIN_PASSWORD | Fejlesztési seed-adminisztrátor e-mail-címe, neve és jelszava. | Helyi seed- és bootstrap-bemenetek. Nem helyettesítik az éles felhasználó-kiépítést. |
WOPI_TAILSCALE_BIND_IP, WOPI_TAILSCALE_HOST, WOPI_TAILSCALE_PORT | Helyi Tailscale-callback bind IP-je, hosztneve és HTTPS-portja. | Saját csomópont-értékek. A tailscale-proof módhoz kötelező, megfelelő hálózati hozzáféréssel és tanúsítvány-megbízhatósággal. |
Opcionális Office callback domain
Az előfeltételekhez és az explicit setup-parancshoz használd a privát Office callback-útvonal beállítási útmutatót.
| Változó | Fogyasztó | Cél | Típus vagy formátum | Kötelező ekkor | Alapérték | Példa | Megkötések vagy biztonság |
|---|---|---|---|---|---|---|---|
WOPI_CALLBACK_DOMAIN_SUFFIX | docker/runtime/setup_environment.py, test_instance_environment.py, office_validation.py és office.py, gyökér compose.yaml, docker/proxy/setup_office_callback.py | Külön callback origin származtatása és a privát mód kiválasztása | Kisbetűs DNS-suffix legalább két címkével. | Opcionális, de az explicit callback setup nem üres értéket igényel a célban. | Üres a .env.example és a Compose fájlban, az üres érték megtartja a korábbi callback-beállításokat. | ecs.t42.hu | Minden címke a DNS-szintaxist követi, a suffix és a teljes hosztnév pedig egyenként legfeljebb 253 karakter lehet. A származtatás az ECS_PUBLIC_HOST_PREFIX, az ECS_ORIGIN_DEPLOYMENT_ID (tartalék: ECS_INSTANCE_ID) és az NPM_HTTPS_PORT (tartalék: 8443) értékeket használja, a nem üres suffix pedig származtatja a REMOTE_WOPI_ORIGIN értéket és kikényszeríti a WOPI_CALLBACK_MODE=private beállítást. A setuphoz test prefix, 100.64.0.0/10 alatti /32 renderer Tailscale IPv4 forrás-CIDR és meglévő megosztott HTTPS listener kell, a konfigurációt a szokásos runtime-életciklus alkalmazza. |
Runtime által generált kimenetek
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
ECS_EFFECTIVE_CLAMAV_HOST, ECS_EFFECTIVE_CLAMAV_PORT | A kiválasztott scanner TCP-hosztja és portja. | Belső runtime-kimenet a helyi és távoli scanner-bemenetekből. A scanner-kliensek használják. |
ECS_EFFECTIVE_COLLABORA_CONVERT_URL, ECS_EFFECTIVE_COLLABORA_INTERNAL_URL | A kiválasztott Office-konverziós endpoint és a belső WOPI-origin. | Belső kimenet a Collabora/callback-konfigurációból. A BFF/FormGen használja. |
ECS_EFFECTIVE_KAFKA_ADMIN_PASSWORD, ECS_EFFECTIVE_KAFKA_ADMIN_USERNAME, ECS_EFFECTIVE_KAFKA_APP_PASSWORD, ECS_EFFECTIVE_KAFKA_APP_USERNAME, ECS_EFFECTIVE_KAFKA_CLUSTER_ID, ECS_EFFECTIVE_KAFKA_INTERNAL_BOOTSTRAP_SERVERS, ECS_EFFECTIVE_KAFKA_LAN_BOOTSTRAP_SERVERS, ECS_EFFECTIVE_KAFKA_NETWORK, ECS_EFFECTIVE_KAFKA_SASL_MECHANISM, ECS_EFFECTIVE_KAFKA_SECURITY_PROTOCOL, ECS_EFFECTIVE_KAFKA_TAILSCALE_BOOTSTRAP_SERVERS | Validált aktív Kafka-hitelesítő adatok, fürtazonosító, hálózat, protokoll, mechanizmus és endpointok. | Belső runtime-kimenet a helyi és a REMOTE_KAFKA_* bemenetekből. Az alkalmazás-kliensek használják. |
ECS_EFFECTIVE_KAFKA_JAVA_ADMIN_JAAS_CONFIG, ECS_EFFECTIVE_KAFKA_JAVA_SASL_MECHANISM, ECS_EFFECTIVE_KAFKA_JAVA_SECURITY_PROTOCOL, ECS_EFFECTIVE_KAFKA_JAVA_SSL_ENDPOINT_IDENTIFICATION_ALGORITHM | Java-formátumú Kafka SASL/TLS kliens-konfiguráció. | A runtime generálja Java-eszközökhöz és a Kafka UI-hoz. Hitelesítő adatokat tartalmazhat. Soha ne logold. |
ECS_EFFECTIVE_KAFKA_LAB_OVERRIDE | A kiválasztott Kafka-laboratórium Compose-felülírás. | Belső kimenet a placement-elemzésből. A laboratóriumi konfiguráció használja. |
ECS_EFFECTIVE_KNOWLEDGE_EXTRACTOR_URL, ECS_EFFECTIVE_QDRANT_API_KEY, ECS_EFFECTIVE_QDRANT_URL | A kiválasztott extractor- és Qdrant-endpointok, valamint a Qdrant API-kulcs. | Belső kimenet távoli és helyi beállításokból. A szolgáltatás-konténerek használják. |
ECS_EFFECTIVE_WOPI_ALLOWED_CIDRS, ECS_EFFECTIVE_WOPI_CALLBACK_MODE, ECS_EFFECTIVE_WOPI_INTERNAL_ORIGIN, ECS_EFFECTIVE_WOPI_PROOF_MODE | Validált WOPI-origin, callback-szabály, forrás-CIDR-ek és bizonyítási mód. | Belső kimenet a REMOTE_WOPI_* / WOPI_* bemenetekből. Az Office/BFF használja. |
Backend, BFF és .NET szolgáltatások
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
DATABASE_URL, BETTERAUTH_DATABASE_URL, POSTGRES_CONNECTION_STRING | PostgreSQL URI vagy Npgsql-kapcsolati string. | Példa adatbázis mailGen. A Better Auth a betterauth sémát használja. A megfelelő alkalmazáshoz kötelező. Tartsd egyezően az adatbázis-hitelesítő adatokat. |
NODE_ENV, HOST, INTERNAL_PROXY_SECRET, USE_KAFKA_NOT_REST | Node-környezet, figyelő host, belső proxy-titok és backend-busz-választó. | Példák development, 127.0.0.1, logikai érték. A megosztott titkot egyezően tartsd a BFF, a backend és a DataSearcher között. |
UIDG_PORT, IDQP_PORT, WEBHOOK_CATCHER_PORT, GRAPH_PULL_POLLER_PORT, QUE_PROCESSOR_PORT, TSP_PORT, ADMIN_SERVICE_PORT, WEBHOOK_CATCHER_URL | Backend figyelőportok és a WebhookCatcher origin. | Példák 3000, http://127.0.0.1:3080. Önálló bemenetek. Az egységes Compose belső értékeket ad. |
BACKEND_TENANT_ID, BACKEND_CLIENT_ID, BACKEND_CLIENT_SECRET | Backend-bootstrap és az aktuális GraphOneTimeUserOnboarder csak alkalmazás (app-only) azonosítója. | Kötelező a kiválasztott Microsoft-szolgáltatóhoz, beleértve az önálló Graph-worker futtatást is. Az egységes gyökér Compose ezeket a neveket változatlanul továbbítja. Tartsd őket a BFF_MICROSOFT_* bejelentkezési adatoktól külön. Lásd: Microsoft runtime-beállítás. |
TENANT_ID, CLIENT_ID, CLIENT_SECRET | Külön önálló CLI- és Graph-kísérletező identitás. | Az Architecture/GraphSyncExperimenter/cli-graph és a lab-dashboard megköveteli ezeket az előtag nélküli hitelesítő adatokat. Ezek a nevek nem konfigurálják a backend-bootstrapot vagy az aktuális GraphOneTimeUserOnboarder-t. A Graph-worker előtag nélküli példamezői elavultak. Az örökölt PST-worker hatókörét lent külön soroljuk fel. |
GRAPH_WEBHOOK_URL, GRAPH_LIFECYCLE_WEBHOOK_URL, GRAPH_WEBHOOK_CLIENT_STATE | Nyilvános HTTPS értesítési és életciklus-callbackek, valamint a megosztott validációs titok. | A Graph-feliratkozásokhoz kötelező. Használd ennek a deploymentnek a nyilvános hosztját és a stabil titkot. |
DELTA_LINK_ENCRYPTION_KEY, DELTA_LINK_ENCRYPTION_KEY_REFERENCE | Folyamatszintű Graph delta AES-kulcs és nem titkos verzió-hivatkozás. | A Base64 kulcsnak pontosan 32 bájtra kell dekódolódnia. Alapértelmezett folyamat-hivatkozás local-dev-v1. A jelenlegi egységes Compose csak a kulcsot továbbítja, a hivatkozást nem. A kifejezett hivatkozások csak azokra a folyamatokra vonatkoznak, amelyek megkapják. Tartsd meg a kompatibilis párt a titkosított adatbázis-állapottal. |
GRAPH_SYNC_CERTS_DIR, GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE_PATH, GRAPH_WEBHOOK_ENCRYPTION_PRIVATE_KEY_PATH, GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE_ID | Tanúsítványgyökér, nyilvános tanúsítvány útvonala, privát kulcs útvonala és tanúsítványazonosító fájlja vagy literálja. | Gazdag értesítésekhez kötelező. A certgen.sh fejlesztési fájlokat készít. Az egységes csatolások konténer-útvonalakat használnak. |
GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE, GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE_REFERENCE | Opcionális Base64 DER nyilvános tanúsítvány és titokkezelő-hivatkozás. | A kifejezett tanúsítványt és azonosítót együtt add meg. A privát kulcsot tartsd külön. |
S3_ENDPOINT, S3_REGION, S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET_EMAIL_BODIES, S3_FORCE_PATH_STYLE | Teljes S3-tároló-kapcsolatbeállítások. | Példa http://127.0.0.1:8333, us-east-1, ecas, true. Az endpointnak, a régiónak, a hitelesítő adatoknak és a bucketnek ugyanazt a tárolót kell azonosítania. |
SEAWEEDFS_ADMIN_PASSWORD, SEAWEEDFS_ADMIN_USER, SEAWEEDFS_BIND_IP, SEAWEEDFS_S3_PORT, SEAWEEDFS_ADMIN_PORT | SeaweedFS helyi adminisztrációs és kiépítési identitás, bind IP és portok. | Csak helyi kiépítéshez kötelező. Az alkalmazás S3-hitelesítő adatai külön maradnak. |
OPENSEARCH_URL, OPENSEARCH_INDEX, OPENSEARCH_ENCRYPTED_INDEX, OPENSEARCH_USERNAME, OPENSEARCH_PASSWORD, EMAIL_ENCRYPTION_MIGRATED_OWNERS | OpenSearch origin és indexek, opcionális hitelesítés és migrált tulajdonos-azonosítók. | Példák http://127.0.0.1:9200, emails-onboarding. A titkosított index-beállítások a titkosított bevezetésre vonatkoznak. |
KAFKA_CLIENT_ID, KAFKA_NETWORK, KAFKA_LAN_BOOTSTRAP_SERVERS, KAFKA_TAILSCALE_BOOTSTRAP_SERVERS, KAFKA_SECURITY_PROTOCOL, KAFKA_SASL_MECHANISM | Kafka-kliensazonosító, hálózatválasztás, broker-listák, protokoll és SASL-mechanizmus. | Példák ecs-backend, lan, sasl_plaintext, PLAIN. Mindkét endpointlistának meg kell felelnie a backend sémavalidációnak. A kiválasztott endpointoknak elérhetőnek kell lenniük. |
KAFKA_ADMIN_USERNAME, KAFKA_ADMIN_PASSWORD, KAFKA_APP_USERNAME, KAFKA_APP_PASSWORD | Külön Kafka admin- és alkalmazás-bejelentkezési párok. | Kafka-kliensekhez kötelező. Egyezzenek a broker-szerepkörökkel és a Coolify SERVICE_PASSWORD_64_* értékekkel. |
KAFKA_TOPIC_* | Kafka topic-névcsalád. | Példák app.graphsync.fetch.v1, app.user.realtime.v1, app.onboarding.commands.v1. A producerek és a consumerek egyezzenek meg. |
GOOGLE_MAILBOX_OAUTH_ENABLED, GOOGLE_MAILBOX_OAUTH_PORT, ECAS_DEPLOYMENT_TENANT_ID, GOOGLE_MAILBOX_CLIENT_ID, GOOGLE_MAILBOX_CLIENT_SECRET_PATH, GOOGLE_MAILBOX_CALLBACK_URL, GOOGLE_MAILBOX_BFF_COMPLETION_URL, GOOGLE_MAILBOX_GRANT_KEY_PATH, GOOGLE_MAILBOX_GRANT_KEY_REFERENCE, GOOGLE_WORKSPACE_CREDENTIALS_JSON | Google mailbox connector jelző és port, tenant- és kliensazonosítók, titok- és kulcsútvonalak, callbackek, kulcshivatkozás és a Workspace-allowlist. | Példák false, 3020, /runtime/google/..., []. A titkokat fájlon vagy titokkezelőn keresztül add meg. |
BFF_ENABLE_KAFKA, BETTER_AUTH_SECRET, BETTER_AUTH_URL, NEXT_PUBLIC_BETTER_AUTH_URL, BFF_PORT, WEBSOCKET_PORT | BFF busz-választó, munkamenet-titok és -origin, valamint figyelőportok. | Önálló példák http://localhost:5173, 5173, 6589. Az egységes bejelentkezés az Account origint használja. A titokváltás érvénytelenítheti a munkameneteket. |
NEXT_PUBLIC_API_URL, NEXT_PUBLIC_SORTER_SERVER_URL, DATASEARCHER_URL, DATASEARCHER_PORT, DATASEARCHER_IUDG_URL, ADMIN_SERVICE_URL | Backend-, sorter-, DataSearcher-, IUDG- és adminisztrációs origin-ok és portok. | A kapcsolódó BFF-funkciókhoz kötelező. A NEXT_PUBLIC_* értékek eljuthatnak a böngészőbe. Soha ne írj ide titkot. |
MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID | Örökölt BFF Microsoft-alkalmazás-bejelentkezési hitelesítő adatok. | Önálló Microsoft-alkalmazás-bejelentkezéshez kötelező. Független a backend alkalmazás-szintű Graph-hitelesítő adatoktól. |
COMPLEXITY_RUNTIME_ROLE, COMPLEXITY_SERVICE_URL, COMPLEXITY_SERVICE_PORT, COMPLEXITY_GETTER_URL, COMPLEXITY_GETTER_PORT, MAX_ACTORS_PER_COMPLEXITY_PARTITION, COMPLEXITY_KAFKA_MAX_POLL_MS, KAFKA_TOPIC_COMPLEXITY_* | Complexity runtime-szerep, WebSocket-címek, partíciókapacitás, poll-időtúllépés, valamint parancs-, értesítési és DLQ topicok. | A BFF szerep-enum: bff / service / getter, alapérték bff. A szolgáltatás- és getter-portok alapértéke 6590/6591, egész számok 1–65535. Az URL-eknek a BFF sémában ws:// kezdetűnek kell lenniük. A partíciónkénti szereplők alapértéke 1, a bemenetet lefelé kerekítjük, és minimum 1. A backend parancs-consumer poll-alapértéke 3600000 ms. A pozitív, véges bemenetek lefelé kerekítve 600000–86400000 ms közé szorulnak. A topic-szerződéseknek egyezniük kell a BFF és a backend között. |
BFF_REALTIME_CONSUMER_GROUP, BFF_REALTIME_INSTANCE_ID, MAX_USERS_PER_QueProcessor_PARTITION | Realtime Kafka-csoport, opcionális stabil példányazonosító és mailbox-partíciókapacitás. | A BFF csoport alapértéke bff-graph-sync-realtime-v1. A példányazonosító, ha meg van adva, nem lehet üres. Az egységes beállítás INSTANCE-bff értéket származtat. A backend kiosztási kapacitás alapértéke 1, egész tartomány 1–100. A csoportváltoztatás hatással van az offset-tulajdonlásra. |
DATASEARCHER_IUDG_URL, IUDG_PORT, DATASEARCHER_CONCURRENCY | DataSearcher backend-origin, IUDG-port és keresési konkurencia. | Önálló példák http://127.0.0.1:3000, 3000, 2. |
PST_PATH_LOCATIONS | Abszolút PST-importkönyvtár-lista. | Csak az örökölt PST-onboarder használja. A Graph-onboarding nem igényli. |
ONBOARDING_RETRY_* | Műveletspecifikus onboarding-újrapróbálkozások száma. | Egész számú kísérletek. A *_DELAY_MS és *_JITTER_MS milliszekundumot használ. A kiválasztott onboarder példájából olvasd ki az alapértékeit. |
ONBOARDING_REPLAY_RUN_ID, ONBOARDING_REPLAY_STEP | A célzott onboarding-futás azonosítója és a checkpoint/lépés replay-hez. | Normál működésnél hagyd üresen. Csak kifejezett operátori replay-hez használd. |
További backend-beállítások
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
GRAPH_PULL_POLLER_TICK_MS, GRAPH_SUBSCRIPTION_TICK_MS, GRAPH_FOLDER_DELTA_INTERVAL_MS, GRAPH_MESSAGE_DELTA_INTERVAL_MS, GRAPH_CATEGORY_POLL_INTERVAL_MS, GRAPH_STALE_DELTA_MS, GRAPH_WEBHOOK_RESPONSE_DEADLINE_MS | Graph-worker intervallumok, delta- és kategória-lekérdezési intervallumok, elavult delta-intervallum és webhook-határidő. | Alapértékek milliszekundumban: worker tick 60000, subscription tick 60000, mappa- és üzenet-delta intervallum egyenként 300000, elavult delta 172800000, webhook-határidő 2500. A kategória-intervallum alapértéke 60000 ms a master-category forráskatalógusból. Ezek az olvasók numerikus konverziót használnak, nem egy közös korlátos sémát. Lásd: időzítési szerződések. |
GRAPH_SYNC_MAX_PAGES_PER_BATCH | Maximális Graph-oldalszám feldolgozási kötegenként. | A Graph fetch-worker alapértéke 10000 oldal kötegenként, Number-rel olvasva. Ennél az olvasásnál nincs további egész-korlát. Csak mért mailbox-viselkedés alapján hangolj. |
GRAPH_SUBSCRIPTIONS_RESET_ON_START | Örökölt feliratkozás-visszaállítás indításkor kapcsoló. | A backend példában szerepel, de nem találtam aktuális éles forrásolvasást. Nem vezérli a tartós GraphPullPoller megújítási szabályt. Normál működésnél hagyd beállítatlanul. |
QUE_PROCESSOR_CONSUMER_GROUP, GRAPH_APPLY_CONSUMER_GROUP, GRAPH_FETCH_CONSUMER_GROUP, GRAPH_SYNC_TRIGGER_CONSUMER_GROUP, TEMPORARY_STATUS_STATUS_CONSUMER_GROUP, INTERFACE_NOTIFIER_CONSUMER_GROUP | Consumer-csoportnevek a queue-, fetch/apply/trigger-, státusz- és értesítő-workerekhez. | Alapértékek: queue que-processor-ingestion-v2, apply graph-sync-apply-ingestion-v1, fetch graph-sync-fetch-v1, trigger graph-sync-trigger-scheduler-v1, ideiglenes státusz temporary-status-status-v1, értesítő interface-notifier-v1. A consumerek indításkor olvassák ezeket. Csak offset- vagy migrációs terv mellett változtasd. |
QUE_PROCESSOR_INGESTION_CONCURRENCY, GRAPH_FETCH_CONSUMER_CONCURRENCY, QP_MAX_CONCURRENT_MAILBOXES | Ingestion-, fetch-consumer- és egyidejű mailbox-korlátok. | A queue ingestion, a Graph fetch és a maximális egyidejű mailboxok alapértéke 8. Ezek a szolgáltatásolvasások Number-t használnak, nem közös pozitív-egész sémát. Az érvénytelen felülírásokat nem szabad validált hangolásnak tekinteni. Kapacitásmérés alapján hangolj. |
MAILBOX_EXECUTION_LEASE_MS, MAILBOX_EXECUTION_HEARTBEAT_MS | Mailbox-végrehajtási lease és heartbeat időtartama. | Mailbox-executor alapértékek: lease 120000 ms, heartbeat 30000 ms. Mindkettő Number olvasás, konfigurációelérésnél nincs közös korlát. Worker-késleltetéssel és lease-viselkedéssel együtt hangold. |
KAFKA_METADATA_MAX_AGE_MS, KAFKA_IDEMPOTENCY_TX_MAX_WAIT_MS, KAFKA_IDEMPOTENCY_TX_TIMEOUT_MS, KAFKA_OUTBOX_POLL_MS, KAFKA_OUTBOX_DISPATCHING_STALE_MS, KAFKA_OUTBOX_MARK_PUBLISHED_RETRY_DELAY_MS, KAFKA_OUTBOX_STALE_PROBE_TIMEOUT_MS | Kafka metadata-, tranzakció- és outbox-időzítési beállítások. | Alapértékek: metadata 5000, idempotencia-tranzakció várakozás 10000, tranzakció-időtúllépés 60000, outbox-polling 2000, elavult dispatch 60000, publikálás utáni újrapróbálkozási késleltetés 150, probe-időtúllépés 30000 milliszekundum. A fogyasztók és az elemzési szabályok eltérnek. Lásd: időzítési szerződések. |
KAFKA_OUTBOX_MARK_PUBLISHED_RETRY_COUNT | Adatbázis-státuszfrissítés újrapróbálkozásai publikálás után. | A publisher alapértéke 5. A véges, nemnegatív numerikus felülírások lefelé kerekítve érvényesülnek. Üres, negatív vagy nem véges érték az alapértéket használja. Ez az elemző nem alkalmaz explicit felső korlátot. |
KAFKA_CONSUMER_AUTO_OFFSET_RESET | Kezdeti offset-visszaállítási szabály. | A consumer alapértéke earliest. Az olvasás a megadott stringet átadja a Kafka-kliensnek, nem kényszerít helyi enumot. Egy érvényes broker/kliens-szabály, mint a latest, a hiányzó vagy használhatatlan csoport-offsetekre hat, nem a már rögzített offsetekre. |
KAFKA_OUTBOX_UNKNOWN_PARTITION_RECOVERY_ENABLED | Ismeretlen partíciós outbox-helyreállítás kapcsolója. | A publisher alapértéke engedélyezett. A kis- és nagybetű-érzéketlen false string letiltja. Más megadott string engedélyezve marad. Ez nem szigorú logikai validáció. |
OPENROUTER_API_KEY, OPENROUTER_BASE_URL, REFERER_URL | OpenRouter API-titok, API-origin és azonosító HTTP-referer. | Példa- vagy örökölt bemenetek, amelyekhez nem találtam aktuális BFF/backend éles forrásolvasást. Ezek nem állapítanak meg aktív base-URL- vagy referer-alapértéket. Támogatott modell-szolgáltatókat az alkalmazás jelenlegi szolgáltató-konfigurációján keresztül állíts be. A megtartott kulcsot tartsd privátan. |
MOCKURL | Örökölt mock-szolgáltató origin. | Csak régi vagy mock szolgáltató-útvonalak használják. Az m365local nem. |
DEV_STORAGE_MODE, DEV_LOG_DIR, DEV_LOG_TERMINAL | Önálló backend naplózási és tárolási választó, abszolút naplókönyvtár és terminál-eszköz. | Az önálló szkriptek tárolási módja alapértelmezésben local (elfogadott local / remote), naplókönyvtára a backend logs/. A terminál-eszköz opcionális. Nem helyettesíti a gyökér Docker-életciklust. |
KAFKA_TESTER_CONSUMER_GROUP, KAFKA_TESTER_CONSUMER_CONCURRENCY, KAFKA_TESTER_CONSUMER_IDLE_LOG_MS, KAFKA_TESTER_ASSIGNMENT_STATUS_MS, KAFKA_TESTER_OUTBOX_POLL_MS, KAFKA_TESTER_OUTBOX_IDLE_LOG_MS | KafkaTester-csoport, konkurencia, naplóintervallumok és outbox-polling-intervallumok. | Worker-csoport alapértéke bun-mailbox-events-worker, konkurencia 1, consumer üresjárati naplózása 30000 ms, assignment státusz 1000 ms, outbox poll 2000 ms, outbox üresjárati naplózása 30000 ms. A numerikus olvasás Number-t használ közös korlátos séma nélkül. Csak a KafkaTester és a közös assignment-naplózás használja ezeket. |
MOCK_USER_1_ID, MOCK_USER_2_ID, MOCK_ORDER_1_ID, MOCK_ORDER_2_ID | Mock felhasználó- és rendelés-fixture UUID-k. | Csak mock- és teszt-adatokhoz. |
RUN_GRAPH_SYNC_E2E, GRAPH_E2E_SENDER_USER_ID, GRAPH_E2E_RECIPIENT_USER_ID, GRAPH_E2E_RECIPIENT_ADDRESS, GRAPH_E2E_ALLOW_PERMANENT_DELETE, GRAPH_E2E_BUN_BINARY | Külső mailbox E2E-bekapcsolás, feladó- és címzett-azonosítók vagy cím, végleges törlés engedélye és Bun-bináris. | Csak előkészített, eldobható mailboxokat használj. Soha ne engedélyezd a romboló ellenőrzéseket éles adatokon. |
S3_ERASE_PREFIXES, S3_ERASE_PREFIX, OPENSEARCH_ERASER_WAIT_TIMEOUT_MS | Romboló objektum-előtag célpontok és OpenSearch-eraser-időtúllépés. | A StorageEraser a S3_ERASE_PREFIXES-t olvassa, tartalékul S3_ERASE_PREFIX. Alapértelmezett előtagok email-bodies/ és users/, záró perjellel normalizálva és deduplikálva. Az OpenSearch-várakozási időtúllépés alapértéke 120000 ms, Number-rel. Csak romboló karbantartáshoz. Használat előtt olvasd el az eraser célkiválasztását. |
Infrastruktúra és dokumentációs site
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
mailGen/msmicroservices-architexture/coolify/.env.coolify.example: KAFKA_BIND_IP, KAFKA_JMX_BIND_IP, KAFKA_LAN_HOST, KAFKA_TAILSCALE_HOST | Broker- és JMX-bind IP-k, valamint a hirdetett LAN- és Tailscale-hosztok. | Példa 127.0.0.1. Coolify-deploymentnél cseréld a szándékolt, elérhető címekre. |
KAFKA_BROKER{1,2,3}_LAN_PORT, KAFKA_BROKER{1,2,3}_TAILSCALE_PORT, KAFKA_BROKER{1,2,3}_JMX_PORT | A három broker LAN-, Tailscale- és JMX-hostportja. | Példák 9092–9094, 19092–19094, 9101–9103. A portoknak egyedinek és elérhetőnek kell lenniük. |
KAFKA_ADMIN_USER, KAFKA_ADMIN_PASSWORD, KAFKA_APP_USER, KAFKA_APP_PASSWORD | Broker admin- és alkalmazás-SASL-identitások. | Példa felhasználók admin / app. A példa jelszavak csak helyiek. Minden kliensnek a kiválasztott szerepkörhöz kell illeszkednie. |
SERVICE_PASSWORD_64_KAFKA_ADMIN, SERVICE_PASSWORD_64_KAFKA_APP, SERVICE_PASSWORD_64_KAFKA_UI, SPRING_SECURITY_USER_PASSWORD, KAFKA_UI_USER | Coolify által generált jelszavak és Kafka UI-bejelentkezés. | Erőforrás-helyi értékek, példa UI-felhasználó admin. Egyezzenek a Compose-hitelesítési beállításokkal. |
KAFKA_CLUSTER_ID | Tartós Kafka-fürtazonosító. | A MkU3OEVBNTJENDM2Qg példa csak friss, elkülönített példafürthöz való. Meglévő fürt pontos azonosítóját őrizd meg. |
SCHEMA_REGISTRY_LAN_BIND_IP, SCHEMA_REGISTRY_LAN_PORT, SCHEMA_REGISTRY_TAILSCALE_BIND_IP, SCHEMA_REGISTRY_TAILSCALE_PORT | Schema Registry LAN- és Tailscale-bind IP-k és portok. | Példák 127.0.0.1, 8081, 127.0.0.1, 18081. Csak Schema Registryhez használd. |
SERVICE_URL_*, SERVICE_FQDN_* | Coolify által kezelt nyilvános origin-ok és hosztnevek opcionális Kafka-eszközökhöz. | Schema Registry, Connect, REST, ksqlDB, Flink és Kafka UI útvonalazásához. Ne keverd össze a belső célportokat a nyilvános portokkal. |
SERVICE_URL_SCHEMAREGISTRY, SERVICE_FQDN_SCHEMAREGISTRY, SERVICE_URL_SCHEMAREGISTRY_8081, SERVICE_FQDN_SCHEMAREGISTRY_8081, SERVICE_URL_KAFKACONNECT, SERVICE_FQDN_KAFKACONNECT, SERVICE_URL_KAFKACONNECT_8083, SERVICE_FQDN_KAFKACONNECT_8083, SERVICE_URL_KAFKAREST, SERVICE_FQDN_KAFKAREST, SERVICE_URL_KAFKAREST_8082, SERVICE_FQDN_KAFKAREST_8082, SERVICE_URL_KSQLDB, SERVICE_FQDN_KSQLDB, SERVICE_URL_KSQLDB_8088, SERVICE_FQDN_KSQLDB_8088, SERVICE_URL_FLINK, SERVICE_FQDN_FLINK, SERVICE_URL_FLINK_9081, SERVICE_FQDN_FLINK_9081, SERVICE_URL_KAFKAUI, SERVICE_FQDN_KAFKAUI, SERVICE_URL_KAFKAUI_8080, SERVICE_FQDN_KAFKAUI_8080 | Explicit Coolify-komponens URL- és FQDN-mezők, beleértve a célport-változatokat. | Példák http://127.0.0.1:<port>, 127.0.0.1. Konfiguráld a komponens domainjét és útvonalazását. Titok nem kerülhet ezekbe a mezőkbe. |
KAFKA_BROKER1_LAN_PORT, KAFKA_BROKER2_LAN_PORT, KAFKA_BROKER3_LAN_PORT, KAFKA_BROKER1_TAILSCALE_PORT, KAFKA_BROKER2_TAILSCALE_PORT, KAFKA_BROKER3_TAILSCALE_PORT, KAFKA_BROKER1_JMX_PORT, KAFKA_BROKER2_JMX_PORT, KAFKA_BROKER3_JMX_PORT | Explicit broker LAN-, Tailscale- és JMX-hostport-leképezések. | Példák 9092–9094, 19092–19094, 9101–9103. Tartsd őket összhangban a hirdetett metaadatokkal. |
POSTGRES_BIND_IP, POSTGRES_PORT, POSTGRES_DB, POSTGRES_USER, POSTGRES_PASSWORD | Helyi PostgreSQL bind IP, port, adatbázis, felhasználó és jelszó. | Példa 127.0.0.1, 5433, mailGen, postgres, privát jelszó. Az önálló infrastruktúra-deployment használja. |
SEAWEEDFS_BIND_IP, SEAWEEDFS_S3_PORT, SEAWEEDFS_ADMIN_PORT, SEAWEEDFS_ADMIN_USER, SEAWEEDFS_ADMIN_PASSWORD | Helyi SeaweedFS bind, S3- és admin-portok, valamint adminisztrátori hitelesítő adatok. | Példa 127.0.0.1, 8333, 5600. Adj meg privát adminisztrációs jelszót. Az S3-hitelesítő adatok külön maradnak. |
Coolify S3_ACCESS_KEY, S3_SECRET_KEY, S3_REGION, S3_BUCKET_EMAIL_BODIES | Külön infrastruktúra-sablon SeaweedFS S3-identitás, titok, régió és törzs-bucket. | Add meg a deployment hitelesítő adatokat. Régió példa us-east-1, bucket ecas. Egyezzen az alkalmazáskonfigurációval ugyanarra a tárolóra. Ezek különböznek a SeaweedFS adminisztrációs hitelesítő adataitól. |
MOCK_USER_1_ID, MOCK_USER_2_ID, MOCK_ORDER_1_ID, MOCK_ORDER_2_ID | Mock fixture-azonosítók. | Teszt-felhasználók és -rendelések UUID-jai. Csak mock- és teszteszközökben használd. |
Architecture/.env.coolify.example: DOCUSAURUS_PUBLIC_URL | Nyilvános dokumentációs site origin. | Alapérték http://localhost. Add meg a nyilvános HTTPS origin-t útvonal nélkül. Build-idejű canonical/sitemap bemenet, nem alkalmazástitok. |
Architecture/GraphSyncExperimenter/graph-call-dashboard/.env.example: DATABASE_URL | Experimenter Prisma SQLite-fájl URL. | Példa file:./db.sqlite. Csak az önálló Graph-experimenterhez. |
Experimenter: TENANT_ID, CLIENT_ID, CLIENT_SECRET, GRAPH_WEBHOOK_CLIENT_STATE, GRAPH_WEBHOOK_URL | Experimenter Entra-azonosítók és titok, stabil client-state és nyilvános HTTPS callback. | Normál dashboard-induláshoz mind kötelező. Példa https://<public-host>/graphWebhook. A titkokat tárold a Gitön kívül. |
Experimenter: GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE_PATH, GRAPH_WEBHOOK_ENCRYPTION_PRIVATE_KEY_PATH, GRAPH_WEBHOOK_ENCRYPTION_CERTIFICATE_ID | Experimenter tanúsítvány-, privátkulcs-fájl- vagy könyvtár-útvonalak és tanúsítványazonosító. | Normál induláshoz mind kötelező. A helyi certs/ útvonalak adják a gazdag értesítési anyagot. |
Experimenter: DELTA_LINK_ENCRYPTION_KEY | Experimenter delta-titkosítási kulcs. | Base64, pontosan 32 bájt. Normál induláshoz kötelező akkor is, ha a példa kihagyja. Őrizd meg az adatbázis-állapottal együtt. |
.NET Graph és örökölt onboarding
| Változó vagy csoport | Jelentés | Alapérték, formátum és olvasó |
|---|---|---|
POSTGRES_CONNECTION_STRING | Npgsql-kapcsolati string. | Példa Host=127.0.0.1;Port=5433;Database=mailGen;Username=postgres;Password=<private>. Önálló Graph- és örökölt onboardinghoz, valamint DataSearcherhez használd. |
KAFKA_CLIENT_ID, KAFKA_NETWORK, KAFKA_LAN_BOOTSTRAP_SERVERS, KAFKA_TAILSCALE_BOOTSTRAP_SERVERS, KAFKA_SECURITY_PROTOCOL, KAFKA_SASL_MECHANISM, KAFKA_ADMIN_USERNAME, KAFKA_ADMIN_PASSWORD, KAFKA_APP_USERNAME, KAFKA_APP_PASSWORD | .NET Kafka-kliensbeállítások alkalmazás- és adminisztrátori szereppel. | Kafka-alapú .NET-szolgáltatásokhoz kötelező. Egyezzenek a backend szemantikával és a tényleges broker-konfigurációval. |
BACKEND_TENANT_ID, BACKEND_CLIENT_ID, BACKEND_CLIENT_SECRET | Az aktuális GraphOneTimeUserOnboarder worker-identitása, a backend-bootstrap is ezt használja. | Akkor is kötelező, ha a Graph-worker önállóan fut. Az OnboardingRuntimeOptions.FromEnvironment ezeket a neveket olvassa, előtag nélküli tartalék nélkül. A verziókezelt Graph-worker .env.example ezt a három mezőt továbbra is elavultan mutatja. A runtime neveket add meg a sablonok módosítása nélkül. |
TENANT_ID, CLIENT_ID, CLIENT_SECRET, GRAPH_WEBHOOK_URL, GRAPH_LIFECYCLE_WEBHOOK_URL, GRAPH_WEBHOOK_CLIENT_STATE | Örökölt OneTimeUserOnboarder PST-worker hitelesítő adatai és értesítési konfigurációja. | A régi PST-worker előtag nélküli hitelesítő hármast, kötelező webhook-URL-t és client-state-et olvas. Az opciótöltő elfogadja a hiányzó lifecycle URL-t. Ez nem az aktuális Graph-worker hitelesítési szerződése. Az önálló Graph export tesztelő és a CLI/lab szintén előtag nélküli hitelesítő adatokat használ a saját konfigurációjában. Titkot soha ne másolj jegyekbe vagy naplókba. |
S3_ENDPOINT, S3_REGION, S3_ACCESS_KEY, S3_SECRET_KEY, S3_BUCKET_EMAIL_BODIES, S3_FORCE_PATH_STYLE | Teljes S3-kapcsolatbeállítások. | Graph-onboarding- és DataSearcher-tárolási műveletekhez kötelező. |
OPENSEARCH_URL, OPENSEARCH_INDEX, OPENSEARCH_USERNAME, OPENSEARCH_PASSWORD | OpenSearch origin és index, valamint opcionális Basic-hitelesítés. | Kötelező, ha az onboarding vagy a DataSearcher keresési indexet használ. |
ONBOARDING_RETRY_GRAPH_ATTEMPTS, ONBOARDING_RETRY_GRAPH_DUMP_ATTEMPTS, ONBOARDING_RETRY_GRAPH_EXPORT_ATTEMPTS, ONBOARDING_RETRY_PST_ATTEMPTS, ONBOARDING_RETRY_S3_ATTEMPTS, ONBOARDING_RETRY_INDEXING_ATTEMPTS, ONBOARDING_RETRY_PARTITION_RELEASE_ATTEMPTS, ONBOARDING_RETRY_BASE_DELAY_MS, ONBOARDING_RETRY_JITTER_MS | Műveletenkénti onboarding-újrapróbálkozások, alapkésleltetés és jitter. | Sablon-alapértékek: Graph/S3 kísérletek 5, PST 3 (csak örökölt), Graph dump/export 5 (csak Graph), indexelés 4, partíció-felszabadítás 8, alapkésleltetés 10000 ms, jitter 1500 ms. Az olvasó a kiválasztott .NET onboarder. Műveletkészleteik eltérnek. |
ONBOARDING_REPLAY_RUN_ID, ONBOARDING_REPLAY_STEP | Onboarding-futás- és checkpoint-replay célpontja. | Üresen hagyd, kivéve kifejezett operátori replay esetén. |
DATASEARCHER_PORT, DATASEARCHER_IUDG_URL, IUDG_PORT, DATASEARCHER_CONCURRENCY, INTERNAL_PROXY_SECRET | DataSearcher figyelőportja, IUDG-origin és -port, konkurencia és belső titok. | Önálló szolgáltatásbemenetek. A megosztott titoknak egyeznie kell a backenddel. |
OPENSEARCH_INITIAL_ADMIN_PASSWORD | OpenSearch kezdeti adminisztrátori jelszó. | Csak az első OpenSearch-bootstraphez, az onboarding Compose-deploymentben. Adj meg privát setup-értéket. |
PST_PATH_LOCATIONS | Abszolút könyvtár vagy könyvtárlista PST-fájlokhoz. | Csak az OneTimeUserOnboarder olvassa. A Graph-onboarding nem. |
Forrás és elsőbbség
A gyökér bemenetek a .env.example, a compose.yaml és a docker/runtime/ fájlokból származnak. A szolgáltatáspéldák közé tartozik a mailGen/msmicroservices-architexture/.env.example, a mailGen/bff/.env.example, a .NET onboarding- és DataSearcher-példák, valamint a coolify/.env.coolify.example.
A jelenlegi backend és a Graph-worker a Compose-on kívül is a BACKEND_* hitelesítő adatokat használja. A CLI/lab és az örökölt PST-worker külön, előtag nélküli szerződést használ. A sablon mezőnevei nem írják felül a kiválasztott runtime elemzőt.
A távoli elemző az elhelyezés és a szállítási ellenőrzés után választja ki az aktív értékeket. A nem használt távoli mezők nem aktiválják a távoli módot. A helyi Compose nem oldhat fel egy másik Coolify-erőforrás generált jelszó-változóját.
A teljes standard helyi kiválasztás 40 GiB alkalmazáskeretet használ. A teljes Microsoft/Google/FormGen kiválasztás 44 GiB-ot használ. A kihagyott 30 GiB alapérték egyik teljes kiválasztásra sem ígér kapacitást. A host-tartalék és a build-admisszió ezen felül van. Lásd: első setup kapacitása.
A Pub/Sub JSON-hoz egy reprezentatív elem:
[{"topicName":"projects/<project>/topics/<topic>","subscriptionId":"projects/<project>/subscriptions/<subscription>","pushAudience":"https://<host>/v1/pubsub/push","pushServiceAccountEmail":"<push-sa>@<project>.iam.gserviceaccount.com","pushServiceAccountSubject":"1234567890","oauthClientId":"<oauth-client-id>"}]
Új projekt hozzáadásakor tartsd meg a meglévő JSON-útvonal-bejegyzéseket. A service-account IAM külön előfeltétel marad.
Kapcsolódó útmutatók
- Konfigurációváltozások és visszaállítás
- Titkok biztonsági mentése
- Graph-kulcsok és tanúsítványok
- Első fejlesztői setup
- Docker runtime
- Napi parancsok
Tényleges FormGen-feltöltési korlátok
A FORMGEN_CDN_MAX_SIZE nem érvényesíti ezeket a korlátokat. A jelenlegi kód elutasítja a 15 000 000 bájtnál nagyobb képfeltöltéseket. A form-mellékletek fájlonkénti plafonja 25 × 1024 × 1024 bájt. A multipart beküldés olvasójának kérés-plafonja 64 × 1024 × 1024 bájt.
Az űrlapkérdések is érvényesítik a beállított minFileSize, pozitív maxSize, minFiles, pozitív maxFiles és allowedMimeTypes értékeket. A nulla maximum azt jelenti, hogy nincs további kérdésszintű maximum, míg a globális bájtplafonok továbbra is érvényesek. A szerver a bájtok olvasása után felismeri a fájltípust, és újra ellenőrzi a méretet és a típust. Ezek a MailGen e-mail-melléklet-előnézeti korlátjától eltérő útvonalak.
Megvalósított időzítési alapértékek
A referencia megkülönbözteti a kód-alapértékeket a kommentelt sablonpéldáktól. Egy megjelenített szám nem jelent egységes validációs szabályt.
| Bemenet és olvasó | Alapérték és a megvalósított elemzés |
|---|---|
KAFKA_METADATA_MAX_AGE_MS, Kafka client factory | 5000 ms. A véges, nemnegatív számokat lefelé kerekítjük. Érvénytelen vagy negatív bemenet az alapértéket használja. |
KAFKA_IDEMPOTENCY_TX_MAX_WAIT_MS, KAFKA_IDEMPOTENCY_TX_TIMEOUT_MS, database deduplication | 10000 / 60000 ms, Number-rel olvasva és a tranzakciónak átadva. Az olvasásnál nincs további korlát. |
KAFKA_OUTBOX_DISPATCHING_STALE_MS, KAFKA_OUTBOX_MARK_PUBLISHED_RETRY_DELAY_MS, KAFKA_OUTBOX_STALE_PROBE_TIMEOUT_MS, publisher | 60000 / 150 / 30000 ms. Nemnegatív egész szöveget vagy ms, s, m, h utótaggal ellátott egész szöveget fogadnak el. Érvénytelen szintaxis esetén az alapérték érvényes. |
KAFKA_OUTBOX_POLL_MS, dispatcher | 2000 ms Number-rel olvasva. Az olvasásnál nincs további korlát. |
| Graph tick/folder/message/stale értékek, GraphPullPoller | Numerikus milliszekundum-olvasások. A kategória-lekérdezés alapértéke 60000 ms a kanonikus master-category forráskatalógusból. Ez megegyezik a jelenlegi példa kommentelt 60000 értékével. |
Opcionális időzítési felülírást csak az ellenőrzött olvasó ismeretében állíts be. Az indulási és SDK-viselkedés elutasíthat olyan értékeket, amelyeket egy egyszerű Number olvasás nem validál.