Első fejlesztői setup
A setupot a motherrepo gyökerében futtasd, ahol a 0daysetup.sh és a compose.yaml található. A programok Docker-konténerekben futnak. A tmux a konténerek terminálját jeleníti meg, nem indít külön Node- vagy .NET-alkalmazásokat.
Napi runtime-parancsok
Ezeket a parancsokat a motherrepo gyökerében használd, az első setup után. Az egységes runtime a gyökér .env fájlt olvassa. A tmux a Docker-folyamatokhoz csatlakozik. Nem futtat második backend-stacket.
Egységes Docker-fejlesztés
A gyökér Compose deployment checkoutonként egy elszigetelt MailGen-példányt futtat. Egy közös Nginx Proxy Manager (NPM) külön életciklussal és állandó állapottal rendelkezik. Ez egygépes Docker Compose, nem Docker Swarm.
Graph-szinkronizálás kulcsai és tanúsítványai
A Graph-szinkronizálás kétféle kriptográfiai anyagot használ. Mielőtt beállítod a szolgáltatóhozzáférést, fejezd be a Microsoft Graph setup lépéseit.
Környezeti titkok mentése és visszaállítása
Az egységes runtime a motherrepo gyökér .env fájlját olvassa. A .env.example karbantartott, minimális sablon, nem teljes hitelesítő-adatkészlet. A setup a számított URL-eket, az adatbázis-kapcsolatokat és a hiányzó generált auth-, proxy- és FormGen-titkokat a gyökér fájlba írja.
A gyökérkörnyezet konfigurálása
Az egységes runtime a motherrepo gyökerében lévő .env fájlt olvassa. Ha a gép nincs előkészítve, kezdd az első installation útmutatóval. A pontos változókhoz használd a környezeti referenciát.
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.
Melléklet-olvasó és Office-előnézet
Az üzenetolvasó a tárolt mellékleteket eredeti letöltési és csak olvasható előnézeti lehetőséggel jeleníti meg. Az Office-fájlokhoz a beállított Collabora-szolgáltatás tartozik, helyi vagy távoli elhelyezés szerint. A távoli renderer a WOPI-n keresztül csak szűkített hozzáférést kap a fájlbájtokhoz. Általános S3-URL-t nem kap.
Izolált teszt-példány
A teszt-példány a saját fizikai forrásgyökeréből futtatja a nyilvános életciklus-szkripteket. Csatolásai, tulajdonosi címkéi, inicializálói, konfigurációja és futásidejű állapota az adott másolathoz tartoznak. Az ECSINSTANCEID shell-felülírása nem választja ki biztonságosan.
Privát Office callback-útvonal
Használd ezt az útmutatót olyan előkészített fizikai teszt-runtime-hoz, amely távoli Office renderert használ. A callback lehetővé teszi, hogy a renderer dokumentumokat kérjen le a cél BFF-től a meglévő megosztott HTTPS proxyn keresztül.
Generált UI fejlesztési setup
A renderer a BFF-hez tartozik. A Complexity kezeli a generálást, a tartós állapotot és az előzményeket. Külön renderer-szolgáltatásra vagy hosztolt Gatewayre nincs szükség. A szokásos indításhoz használd a Docker-fejlesztést.
Microsoft naptári események és helyi feladatok
A BFF /calendar oldala a postafiók saját Outlook-naptárait mutatja. Az eseményeket a Microsoft Graph szolgáltatja. A feladatok helyiek, és a fiók munkamenetéhez tartoznak. A meglévő mail.read és mail.crud hozzáférés a calendar.read és calendar.manage jogosultságokkal együtt működik.
Complexity custom runtime
Tartsd a COMPLEXITYCUSTOMRUNTIME_ENABLED=0 értéket, amíg a kiválasztott host nem teljesíti az izolációs ellenőrzéseket. A gyökérben lévő Compose-konfiguráció ezt az alapértéket használja.
Keresési futtatások, előzmények és eredmények
A MailGen minden keresést külön futtatásként kezel. A kiválasztott motor az adatbázisban vagy az OpenSearch-ben kereshet. Az OpenSearch teljes üzenettörzsekben is kereshet. A rendszer csak azokra a postafiókokra korlátozza az eredményeket, amelyekhez hozzáférsz.
OpenSearch lemez-watermarkok
Használd ezt az útmutatót fix szabadhely-tartalékok kiválasztásához a helyi OpenSearch 2.18 szolgáltatáshoz FullLocal vagy PartialRemote módban. A watermark olyan lemezküszöb, amely korlátozza a shard-allokációt vagy az írásokat, mielőtt a tárhely megtelik.
Átvizsgált forrású hotfix munkafolyamat
Az átvizsgált forrású deployment a kiválasztott snapshotot futtatja, nem a munkamásolat minden szerkesztését. Hotfix publikálása előtt olvasd el a forrásválasztást.
A szolgáltatások végrehajtási módjainak folytatása
A runtime sikeres indítás után rögzíti az egyes szolgáltatások development vagy production módját. A restartDevServers.sh, a devstack.sh restart SERVICE és a devstack.sh start SERVICE a mentett módokat folytatja. Ezért egy development worker mellett futhat production BFF is.