Pracovní prostředí

Sites

Otevřete Weby ve webovém rozhraní a uvidíte publikace sdílené s Vámi i Site, které vlastníte. Každý Projekt má také kartu Weby. Plugin sites dá aplikaci, která už běží ve spravovaném Projektu nebo na spárovaném počítači, vlastní webovou adresu.

Zveřejněte nebo si prohlédněte aplikaci Projektu

Vytvořte Site pro port, na kterém aplikace naslouchá uvnitř běžícího spravovaného Projektu nebo na spárovaném počítači, a pak ji zveřejněte. Sites ověří, že aplikace odpovídá, ještě než adresu zpřístupní. Aplikaci nekopíruje, nevytváří ani nespouští. Když se Projekt nebo služba zastaví, Site zůstane v seznamu, ale neodpoví, dokud aplikace znovu neběží.

Členové Projektu s počítačem mohou zveřejňovat aplikace běžící na tomto počítači. Administrátoři musí být také členy, aby z něj mohli zveřejňovat. Počítač držte připojený pomocí elowen connect; dokud je offline, jeho Site zůstává zveřejněná a vrací stávající odpověď o nedostupnosti. Pokud zveřejnění vyžaduje novějšího klienta, aktualizujte na tomto počítači Elowen CLI a znovu ho připojte. Hostitelské Projekty Site zveřejňovat nemohou.

SitePreview otevře běžící aplikaci na dočasné adrese náhledu. Otevřít ji mohou jen současní členové Projektu a administrátoři; náhled Site nezveřejní.

Seznam a podrobnosti Sites ukazují adresu, Projekt, cílový port, poslední zveřejnění, návštěvy, přístup a jmenované hosty. Stránka Weby i karta v Projektu kontrolují stav každé čtyři sekundy, dokud je některý vypsaný snímek nedokončený, a jakmile žádný neběží, kontrolu ukončí. Snímek stránky je k dispozici, když je nainstalovaná služba pro zachytávání v prohlížeči. Snímky se obnovují, když chybí nebo jsou zastaralé; pokud nové zachycení selže, předchozí snímek zůstane viditelný. Pokud je Site zveřejněná, ale její aplikace neodpovídá, stav to uvede; spusťte službu Projektu a zveřejněte znovu.

Site zveřejněné ze souborů si zachovávají adresy, certifikáty a uložené soubory. Při aktualizaci přejdou do údržby, místo aby tyto soubory dál poskytovaly: jejich adresy vracejí dočasnou odpověď 503 a přehled i detail ukazují Údržbu. Administrátoři dostanou upozornění. Zachované soubory jsou jen pro čtení. Statický server se neinstaluje a žádné soubory se nekopírují automaticky. Chcete-li adresu obnovit, spusťte HTTP službu ve spravovaném Projektu nebo na spárovaném počítači, vyberte tento Projekt a zavolejte SitePublish s portem v target; adresa se obnoví po ověření. Výslovné smazání odstraní zachované soubory, ale nikdy ne aplikaci Projektu ani její zdroj.

Obnova adresy v údržbě probíhá vždy jen jedním pokusem. Spuštění nového pokusu zruší předchozí a pokus, který neskončí do pěti minut, vyprší. Adresa i její zachované soubory zůstávají v údržbě, dokud náhradní služba neprojde ověřením.

Zvolte, kdo může Site otevřít

Nastavte Site jako soukromou pro vlastníka, viditelnou pro členy Projektu, dostupnou každému přihlášenému účtu, nebo veřejnou. Nové Site používají výchozí viditelnost instance. Site se nikdy nestane veřejnou automaticky: někdo musí na stránce Weby potvrdit Zveřejnit. Pokud je v nastavení pluginu vypnuté Povolit veřejné weby, veřejná volba není k dispozici.

SiteShare a SiteUnshare přidělí nebo odeberou přístup konkrétnímu účtu bez ohledu na viditelnost Site. Odebraný přístup přestane platit u dalšího požadavku. Viditelnost Site neuděluje přístup k Projektu, jeho zdroji ani jeho souborům; ty se dál řídí přístupem k Projektu.

Smazání a vlastnictví prostředků

Smazání Site ji odebere ze seznamu a spustí odstranění její zveřejněné adresy i náhledu. Smazání jejího Projektu odstraní také všechny Site, náhledy a zachované soubory vydání tohoto Projektu. Potvrzení smazání Projektu vypíše dotčené Site a adresy; vazby vlastních domén se odpojí, ale Vaše záznamy DNS se nezmění. Pokud Elowen nemohla úklid dokončit hned, dokončí ho po restartu.

Přidejte vlastní doménu

Otevřete podrobnosti Site a zvolte Přidat doménu. Elowen zobrazí záznamy DNS pro ověření vlastnictví a pro směrování provozu na Site. Vytvořte je u svého poskytovatele DNS a potom zvolte Zkontrolovat znovu. Nastavení může zůstat nedokončené, dokud se změny DNS nerozšíří nebo dokud se nevydá certifikát. Site ukazuje, zda je připravené vlastnictví, směrování i HTTPS. Až bude připravené, zvolte Nastavit jako hlavní; vygenerovaná adresa Elowen zůstává dostupná. Odebrání vlastní domény z Elowen Vaše záznamy DNS nezmění.

Dokud je nastavení otevřené, Elowen kontroluje doménu každých 20 sekund a ukazuje odpočet i aktuální průběh. Kontroly skončí, když se doména připojí, odebere nebo když okno zavřete. Připojená doména ukazuje svou adresu a platnost certifikátu místo pokynů k nastavení.

Každá Site může mít nejvýše 10 vlastních domén. Doména musí být jeden úplný název hostitele, bez schématu, cesty, portu nebo zástupného znaku. U kořenové domény použijte adresní záznamy, které Elowen nabízí, nebo záznam ALIAS či ANAME, pokud ho Váš poskytovatel DNS podporuje; u subdomény je obvykle nejjednodušší CNAME. Přidejte záznam TXT pro ověření vlastnictví a směrovací záznam zobrazený pro danou doménu. Například připojte app.example.com, přidejte zobrazené záznamy TXT a CNAME a potom ji nastavte jako hlavní, až bude HTTPS připravené.

Používejte nástroje Sites

Nástroje SiteCreate, SitePreview, SitePublish, SiteGet, SiteList, SiteUpdate, SiteShare, SiteUnshare a SiteDelete vytvářejí Site, zobrazují jejich náhled, zveřejňují je, zkoumají a spravují. SiteDomainAdd, SiteDomainCheck, SiteDomainSetPrimary a SiteDomainRemove spravují vlastní domény. Zveřejňování ze souborů a SiteRollback byly odstraněny.

Zveřejnění Site je proxy ke službě Projektu, ne samostatný hostitel aplikace. Služba musí naslouchat na 127.0.0.1 na zvoleném portu uvnitř aktivního spravovaného Projektu nebo Projektu s počítačem. Worker předává těla požadavků i odpovědí po částech se zpětným tlakem a po stejných kontrolách přístupu jako u HTTP tuneluje WebSocket a další protokoly HTTP Upgrade. Uploady ani odpovědi nemají výchozí strop velikosti. Časový limit měří nečinnost, ne celkovou dobu požadavku, takže aktivní upload, stahování nebo proud událostí může přesáhnout limit nečinnosti (výchozích 3600 sekund, viz nastavení reverzní proxy níže).

Hlavička Authorization aplikace, vyjednávání obsahu, CORS i hlavičky veřejné cache procházejí beze změny. Interní hlavičky x-elowen-* odeslané návštěvníkem a přístupové a zachytávací cookies Sites se k aplikaci nikdy nedostanou. Když přihlášený návštěvník otevře Site, dostane aplikace id jeho účtu v x-elowen-user-id, které nastaví Sites po vlastní kontrole přístupu, takže aplikace za přihlašovací Site může návštěvníka pustit dál bez druhého hesla. Anonymní návštěvníci ani zachycení obrazovky nenesou žádnou identitu. Hlavičky platné jen pro jedno spojení řeší transport a cookies aplikace zůstávají jen pro daného hostitele. Soukromé odpovědi nelze sdílet ve veřejné cache. Pokud se po odeslání hlaviček překročí volitelný strop odpovědi, proud selže, místo aby vrátil zkrácenou úspěšnou odpověď.

Nainstalujte a nastavte Sites

Aktuální verzi pluginu a jeho minimální verzi Elowen najdete v registru. Nainstalujte Sites v Nastavení → Dostupné pluginy. Sites potřebuje ovládání Sandbox, takže Elowen odmítne plugin zapnout, dokud není zapnutý plugin, který toto ovládání poskytuje. Sites nelze přidělit uživatelům. Administrátor může v nastavení níže omezit, kdo smí zveřejňovat; nebrání to ale lidem otevřít Site, které jsou s nimi sdílené.

Zapnutí, vypnutí, instalace nebo změna pluginu restartuje Elowen. Obrazovka nastavení říká: „Změna je uložená. Elowen se teď restartuje, aby ji načetla.“

Administrátor upravuje celoinstanční nastavení v podrobnostech pluginu v části Nastavení → Pluginy. Číselná pole ukazují jednotky vedle vstupu: platnost přihlášení v hodinách, velikosti proxy v MiB a časové limity i platnost HSTS v sekundách. Pojmenované skupiny jsou zpočátku otevřené a pamatují si, zda jste je zavřeli. Krátké nápovědy zůstávají viditelné; podrobné pokyny najdete přes ikonu nápovědy.

Administrátoři dostanou upozornění, když přestane fungovat worker Sites, HTTPS brána nebo zveřejněná adresa. Každé upozornění zmizí, když se problém vyřeší.

Nastavení zveřejňování

Nastavení	Klíč	Výchozí hodnota	Co ovládá
Výchozí viditelnost	`defaultVisibility`	Jen vlastníkovi	Rozbalovací nabídka počátečního přístupu: jen vlastník, členové Projektu, nebo přihlášené účty.
Povolit veřejné weby	`allowPublicSites`	Zapnuto	Zda může někdo Site zveřejnit jako veřejnou.
Kdo smí zveřejňovat	`publishers`	Každý účet	Nastavte na každý účet, nebo jen na administrátory.
Webů na účet	`maxSitesPerAccount`	20	Nejvyšší počet Site na účet, od 1 do 500.

Nastavení reverzní proxy

Tato nastavení platí pro každou Site obsluhovanou přes proxy, bez možnosti je měnit pro jednotlivou Site. U nastavení velikosti znamená nula bez omezení.

Nastavení	Klíč	Výchozí hodnota	Platné hodnoty a důvod
Velikost uploadu	`maxRequestBodyMb`	Bez omezení	Celé MiB od 0 do 65536. Nula znamená bez omezení. Aplikace může vynucovat vlastní limit.
Časový limit nečinnosti	`idleTimeoutSeconds`	3600 sekund	Celé sekundy od 1 do 86400. Omezuje nečinnost při čtení nebo odesílání dat, ne celkovou dobu požadavku.
Časový limit připojení	`connectTimeoutSeconds`	60 sekund	Celé sekundy od 1 do 75. Omezuje čas na připojení k aplikaci.
WebSocket a Upgrade	`allowUpgrade`	Zapnuto	Logická hodnota. Povolí změnu protokolu aplikace včetně WebSocket po obvyklých kontrolách přístupu k Site.
Velikost odpovědi	`proxyMaxResponseMb`	Bez omezení	Celé MiB od 0 do 65536. Nula znamená bez omezení. Překročení nenulového limitu ukončí streamovanou odpověď; nikdy nevrátí zkrácenou úspěšnou odpověď.
Komprese gzip	`gzip`	Vypnuto	Logická hodnota. Nginx komprimuje vhodné odpovědi, když prohlížeč přijímá gzip. Už komprimované odpovědi projdou beze změny.
Vyžadovat HTTPS v prohlížeči	`hsts`	Vypnuto	Logická hodnota. Řekne prohlížečům, aby pro Site používaly HTTPS, bez subdomén. Prohlížeče si pravidlo pamatují po celou jeho platnost, i když ho potom vypnete.
Platnost pravidla HTTPS	`hstsMaxAgeSeconds`	31536000 sekund	Celé sekundy od 0 do 63072000, viditelné při vyžadování HTTPS. Nula pravidlo odstraní.

Přístup návštěvníků a certifikáty

Nastavení	Klíč	Výchozí hodnota	Co ovládá
Platnost přihlášení	`sessionTtlHours`	12 hodin	Jak dlouho zůstává návštěvník přihlášený, od 1 do 720 hodin. Odebrání přístupu platí i tak okamžitě.
Cíl DNS pro weby	`gatewayDnsTarget`	Nenastaveno	Název hostitele nebo IP adresa pro veřejné DNS; prázdné pole použije název hostitele aplikace Elowen.
Kontaktní e-mail pro certifikáty	`contactEmail`	Nenastaveno	E-mail posílaný certifikační autoritě pro vydání certifikátu a upozornění na vypršení.

Certifikáty Site vyžadují kontaktní e-mail, který se posílá certifikační autoritě. Vlastní doména může zůstat nedokončená, dokud se neověří její vlastnictví a směrování DNS a dokud není připravené HTTPS; aktuální krok nebo chybu uvidíte po volbě Zkontrolovat znovu. Cíl DNS musí směřovat přímo na tohoto hostitele Elowen; externí proxy potřebuje vlastní podporu TLS. SiteList a SiteGet jsou jen pro čtení a můžete je bezpečně použít i během plánování Elowen.