Pracovné prostredie

Sites

Otvorte Weby vo webovom rozhraní a uvidíte publikácie zdieľané s Vami aj Site, ktoré vlastníte. Každý Projekt má tiež kartu Weby. Plugin sites dá aplikácii, ktorá už beží v spravovanom Projekte alebo na spárovanom počítači, vlastnú webovú adresu.

Zverejnite alebo si pozrite aplikáciu Projektu

Vytvorte Site pre port, na ktorom aplikácia počúva vnútri bežiaceho spravovaného Projektu alebo na spárovanom počítači, a potom ju zverejnite. Sites overí, že aplikácia odpovedá, ešte predtým, než adresu sprístupní. Aplikáciu nekopíruje, nevytvára ani nespúšťa. Keď sa Projekt alebo služba zastaví, Site zostane v zozname, ale neodpovie, kým aplikácia znova nebeží.

Členovia Projektu s počítačom môžu zverejňovať aplikácie bežiace na tomto počítači. Administrátori musia byť tiež členmi, aby z neho mohli zverejňovať. Počítač držte pripojený pomocou elowen connect; kým je offline, jeho Site zostáva zverejnená a vracia existujúcu odpoveď o nedostupnosti. Ak zverejnenie vyžaduje novšieho klienta, aktualizujte na tomto počítači Elowen CLI a znova ho pripojte. Hostiteľské Projekty Site zverejňovať nemôžu.

SitePreview otvorí bežiacu aplikáciu na dočasnej adrese náhľadu. Otvoriť ju môžu iba súčasní členovia Projektu a administrátori; náhľad Site nezverejní.

Zoznam a podrobnosti Sites ukazujú adresu, Projekt, cieľový port, posledné zverejnenie, návštevy, prístup a menovaných hostí. Stránka Weby aj karta v Projekte kontrolujú stav každé štyri sekundy, kým je niektorá vypísaná snímka nedokončená, a hneď ako žiadna nebeží, kontrolu ukončia. Snímka stránky je k dispozícii, keď je nainštalovaná služba na zachytávanie v prehliadači. Snímky sa obnovujú, keď chýbajú alebo sú zastarané; ak nové zachytenie zlyhá, predchádzajúca snímka zostane viditeľná. Ak je Site zverejnená, ale jej aplikácia neodpovedá, stav to uvedie; spustite službu Projektu a zverejnite znova.

Site zverejnené zo súborov si zachovávajú adresy, certifikáty a uložené súbory. Pri aktualizácii prejdú do údržby, namiesto aby tieto súbory ďalej obsluhovali: ich adresy vracajú dočasnú odpoveď 503 a prehľad aj detail ukazujú Údržbu. Administrátori dostanú upozornenie. Zachované súbory sú iba na čítanie. Statický server sa neinštaluje a žiadne súbory sa nekopírujú automaticky. Ak chcete adresu obnoviť, spustite HTTP službu v spravovanom Projekte alebo na spárovanom počítači, vyberte tento Projekt a zavolajte SitePublish s portom v target; adresa sa obnoví po overení. Výslovné zmazanie odstráni zachované súbory, ale nikdy nie aplikáciu Projektu ani jej zdroj.

Obnova adresy v údržbe prebieha vždy iba jedným pokusom. Spustenie nového pokusu zruší predchádzajúci a pokus, ktorý sa neskončí do piatich minút, vyprší. Adresa aj jej zachované súbory zostávajú v údržbe, kým náhradná služba neprejde overením.

Zvoľte, kto môže Site otvoriť

Nastavte Site ako súkromnú pre vlastníka, viditeľnú pre členov Projektu, dostupnú každému prihlásenému účtu, alebo verejnú. Nové Site používajú predvolenú viditeľnosť inštancie. Site sa nikdy nestane verejnou automaticky: niekto musí na stránke Weby potvrdiť Zverejniť. Ak je v nastaveniach pluginu vypnuté Povoliť verejné weby, verejná voľba nie je k dispozícii.

SiteShare a SiteUnshare pridelia alebo odoberú prístup konkrétnemu účtu bez ohľadu na viditeľnosť Site. Odobratý prístup prestane platiť pri ďalšej požiadavke. Viditeľnosť Site neudeľuje prístup k Projektu, jeho zdroju ani jeho súborom; tie sa ďalej riadia prístupom k Projektu.

Zmazanie a vlastníctvo prostriedkov

Zmazanie Site ju odoberie zo zoznamu a spustí odstránenie jej zverejnenej adresy aj náhľadu. Zmazanie jej Projektu odstráni aj všetky Site, náhľady a zachované súbory vydania tohto Projektu. Potvrdenie zmazania Projektu vypíše dotknuté Site a adresy; väzby vlastných domén sa odpoja, ale Vaše záznamy DNS sa nezmenia. Ak Elowen nemohla upratovanie dokončiť hneď, dokončí ho po reštarte.

Pridajte vlastnú doménu

Otvorte podrobnosti Site a zvoľte Pridať doménu. Elowen zobrazí záznamy DNS na overenie vlastníctva a na smerovanie prevádzky na Site. Vytvorte ich u svojho poskytovateľa DNS a potom zvoľte Skontrolovať znova. Nastavenie môže zostať nedokončené, kým sa zmeny DNS nerozšíria alebo kým sa nevydá certifikát. Site ukazuje, či je pripravené vlastníctvo, smerovanie aj HTTPS. Keď bude pripravené, zvoľte Nastaviť ako hlavnú; vygenerovaná adresa Elowen zostáva dostupná. Odobratie vlastnej domény z Elowen Vaše záznamy DNS nezmení.

Kým je nastavenie otvorené, Elowen kontroluje doménu každých 20 sekúnd a ukazuje odpočet aj aktuálny priebeh. Kontroly skončia, keď sa doména pripojí, odoberie alebo keď okno zatvoríte. Pripojená doména ukazuje svoju adresu a platnosť certifikátu namiesto pokynov na nastavenie.

Každá Site môže mať najviac 10 vlastných domén. Doména musí byť jeden úplný názov hostiteľa, bez schémy, cesty, portu alebo zástupného znaku. Pri koreňovej doméne použite adresné záznamy, ktoré Elowen ponúka, alebo záznam ALIAS či ANAME, ak ho Váš poskytovateľ DNS podporuje; pri subdoméne je zvyčajne najjednoduchší CNAME. Pridajte záznam TXT na overenie vlastníctva a smerovací záznam zobrazený pre danú doménu. Napríklad pripojte app.example.com, pridajte zobrazené záznamy TXT a CNAME a potom ju nastavte ako hlavnú, keď bude HTTPS pripravené.

Používajte nástroje Sites

Nástroje SiteCreate, SitePreview, SitePublish, SiteGet, SiteList, SiteUpdate, SiteShare, SiteUnshare a SiteDelete vytvárajú Site, zobrazujú ich náhľad, zverejňujú ich, skúmajú a spravujú. SiteDomainAdd, SiteDomainCheck, SiteDomainSetPrimary a SiteDomainRemove spravujú vlastné domény. Zverejňovanie zo súborov a SiteRollback boli odstránené.

Zverejnenie Site je proxy k službe Projektu, nie samostatný hostiteľ aplikácie. Služba musí počúvať na 127.0.0.1 na zvolenom porte vnútri aktívneho spravovaného Projektu alebo Projektu s počítačom. Worker odovzdáva telá požiadaviek aj odpovedí po častiach so spätným tlakom a po rovnakých kontrolách prístupu ako pri HTTP tuneluje WebSocket a ďalšie protokoly HTTP Upgrade. Uploady ani odpovede nemajú predvolený strop veľkosti. Časový limit meria nečinnosť, nie celkovú dobu požiadavky, takže aktívny upload, sťahovanie alebo prúd udalostí môže prekročiť limit nečinnosti (predvolených 3600 sekúnd, pozri nastavenia reverznej proxy nižšie).

Hlavička Authorization aplikácie, vyjednávanie obsahu, CORS aj hlavičky verejnej medzipamäti prechádzajú bez zmeny. Interné hlavičky x-elowen-* odoslané návštevníkom a prístupové a zachytávacie cookies Sites sa k aplikácii nikdy nedostanú. Keď prihlásený návštevník otvorí Site, dostane aplikácia id jeho účtu v x-elowen-user-id, ktoré nastaví Sites po vlastnej kontrole prístupu, takže aplikácia za prihlasovacou Site môže návštevníka pustiť ďalej bez druhého hesla. Anonymní návštevníci ani zachytenia obrazovky nenesú žiadnu identitu. Hlavičky platné iba pre jedno spojenie rieši transport a cookies aplikácie zostávajú iba pre daného hostiteľa. Súkromné odpovede nemožno zdieľať vo verejnej medzipamäti. Ak sa po odoslaní hlavičiek prekročí voliteľný strop odpovede, prúd zlyhá, namiesto aby vrátil skrátenú úspešnú odpoveď.

Nainštalujte a nastavte Sites

Aktuálnu verziu pluginu a jeho minimálnu verziu Elowen nájdete v registri. Nainštalujte Sites v Nastavenia → Dostupné pluginy. Sites potrebuje ovládanie Sandbox, takže Elowen odmietne plugin zapnúť, kým nie je zapnutý plugin, ktorý toto ovládanie poskytuje. Sites sa nedá prideľovať používateľom. Administrátor môže v nastaveniach nižšie obmedziť, kto smie zverejňovať; nebráni to však ľuďom otvoriť Site, ktoré sú s nimi zdieľané.

Zapnutie, vypnutie, inštalácia alebo zmena pluginu reštartuje Elowen. Obrazovka nastavení hovorí: „Zmena je uložená. Elowen sa teraz reštartuje, aby ju načítala.“

Administrátor upravuje celoinštančné nastavenia v podrobnostiach pluginu v časti Nastavenia → Pluginy. Číselné polia ukazujú jednotky vedľa vstupu: platnosť prihlásenia v hodinách, veľkosti proxy v MiB a časové limity aj platnosť HSTS v sekundách. Pomenované skupiny sú na začiatku otvorené a pamätajú si, či ste ich zatvorili. Krátke nápovedy zostávajú viditeľné; podrobné pokyny nájdete cez ikonu nápovedy.

Administrátori dostanú upozornenie, keď prestane fungovať worker Sites, HTTPS brána alebo zverejnená adresa. Každé upozornenie zmizne, keď sa problém vyrieši.

Nastavenia zverejňovania

Nastavenie	Kľúč	Predvolená hodnota	Čo ovláda
Predvolená viditeľnosť	`defaultVisibility`	Len vlastníkovi	Rozbaľovací zoznam počiatočného prístupu: len vlastník, členovia Projektu, alebo prihlásené účty.
Povoliť verejné weby	`allowPublicSites`	Zapnuté	Či môže niekto Site zverejniť ako verejnú.
Kto smie zverejňovať	`publishers`	Každý účet	Nastavte na každý účet, alebo iba na administrátorov.
Webov na účet	`maxSitesPerAccount`	20	Najvyšší počet Site na účet, od 1 do 500.

Nastavenia reverznej proxy

Tieto nastavenia platia pre každú Site obsluhovanú cez proxy, bez možnosti meniť ich pre jednotlivú Site. Pri nastaveniach veľkosti nula znamená bez obmedzenia.

Nastavenie	Kľúč	Predvolená hodnota	Platné hodnoty a dôvod
Veľkosť uploadu	`maxRequestBodyMb`	Bez obmedzenia	Celé MiB od 0 do 65536. Nula znamená bez obmedzenia. Aplikácia môže vynucovať vlastný limit.
Časový limit nečinnosti	`idleTimeoutSeconds`	3600 sekúnd	Celé sekundy od 1 do 86400. Obmedzuje nečinnosť pri čítaní alebo odosielaní údajov, nie celkovú dobu požiadavky.
Časový limit pripojenia	`connectTimeoutSeconds`	60 sekúnd	Celé sekundy od 1 do 75. Obmedzuje čas na pripojenie k aplikácii.
WebSocket a Upgrade	`allowUpgrade`	Zapnuté	Logická hodnota. Povolí zmenu protokolu aplikácie vrátane WebSocket po obvyklých kontrolách prístupu k Site.
Veľkosť odpovede	`proxyMaxResponseMb`	Bez obmedzenia	Celé MiB od 0 do 65536. Nula znamená bez obmedzenia. Prekročenie nenulového limitu ukončí streamovanú odpoveď; nikdy nevráti skrátenú úspešnú odpoveď.
Kompresia gzip	`gzip`	Vypnuté	Logická hodnota. Nginx komprimuje vhodné odpovede, keď prehliadač prijíma gzip. Už komprimované odpovede prejdú bez zmeny.
Vyžadovať HTTPS v prehliadači	`hsts`	Vypnuté	Logická hodnota. Povie prehliadačom, aby pre Site používali HTTPS, bez subdomén. Prehliadače si pravidlo pamätajú po celú jeho platnosť, aj keď ho potom vypnete.
Platnosť pravidla HTTPS	`hstsMaxAgeSeconds`	31536000 sekúnd	Celé sekundy od 0 do 63072000, viditeľné pri vyžadovaní HTTPS. Nula pravidlo odstráni.

Prístup návštevníkov a certifikáty

Nastavenie	Kľúč	Predvolená hodnota	Čo ovláda
Platnosť prihlásenia	`sessionTtlHours`	12 hodín	Ako dlho zostáva návštevník prihlásený, od 1 do 720 hodín. Odobratie prístupu platí aj tak okamžite.
Cieľ DNS pre weby	`gatewayDnsTarget`	Nenastavené	Názov hostiteľa alebo IP adresa pre verejné DNS; prázdne pole použije názov hostiteľa aplikácie Elowen.
Kontaktný e-mail pre certifikáty	`contactEmail`	Nenastavené	E-mail posielaný certifikačnej autorite na vydanie certifikátu a upozornenie na vypršanie.

Certifikáty Site vyžadujú kontaktný e-mail, ktorý sa posiela certifikačnej autorite. Vlastná doména môže zostať nedokončená, kým sa neoverí jej vlastníctvo a smerovanie DNS a kým nie je pripravené HTTPS; aktuálny krok alebo chybu uvidíte po voľbe Skontrolovať znova. Cieľ DNS musí smerovať priamo na tohto hostiteľa Elowen; externá proxy potrebuje vlastnú podporu TLS. SiteList a SiteGet sú iba na čítanie a môžete ich bezpečne použiť aj počas plánovania Elowen.