Преглед на самостоятелното хостване
Стартирайте собствен екземпляр и всяка тайна, всеки акаунт и всеки ред от журнала остават на инфраструктура, която вие контролирате. Вие решавате как се удостоверяват акаунтите, дали екземплярът изобщо е достъпен от публичния интернет и какво брандиране носи интерфейсът.
Първо изберете режим на удостоверяване
Раздел, озаглавен „Първо изберете режим на удостоверяване“Режимът определя какво друго трябва да работи, затова го уточнете, преди да инсталирате.
simple е режимът по подразбиране и изисква само хранилището за данни Valkey/Redis.
full добавя SQL база данни за акаунтите, която по подразбиране е SQLite на
sqlite://data/auth.db; PostgreSQL е поддържана опция, а не
изискване. В контейнер този файл се нуждае от монтиран том, за да преживее
рестартиране.
Simple или Full описва какво отключва всеки режим, къде трябва да се намира тази база данни и колко трудно е режимът да се смени по-късно.
Изберете път за инсталиране
Раздел, озаглавен „Изберете път за инсталиране“Бързате и вече имате работещ Valkey или Redis? Единичната команда docker run
в Инсталиране с Docker
стартира екземпляр на порт 3000 с един генериран ключ SECRET. Всичко останало
на тази страница продължава да е в сила, след като екземплярът заработи.
- Образи и варианти — кой от публикуваните образи да стартирате и как работят етикетите на изданията.
- Инсталиране с Docker — двата Compose стека, които проектът доставя.
- Инсталиране на Linux — инсталация на физически сървър с Debian или Ubuntu. Тестовете за инсталация на проекта не покриват друго семейство дистрибуции.
- Стартиране като услуга — systemd единиците, които хранилището доставя, и Procfile изпълнителят за хостове без systemd.
- Обратен прокси и TLS — приложението никога не терминира TLS, затова се предполага прокси пред него. Прочетете това, преди да направите екземпляра публично достъпен.
- Проверете инсталацията си — уверете се, че екземплярът действително обслужва заявки, преди да го предадете на някого, и създайте първия акаунт: ролята на оператор на сайта се предоставя само от командния ред.
Надграждате съществуваща инсталация? Ръководствата за надграждане изброяват наличните ръководства, като най-новите са първи. Започнете с първото ръководство след изданието, което използвате сега, и продължете напред, като прочетете бележките към всяко междинно издание.
Системни изисквания
Раздел, озаглавен „Системни изисквания“Препоръчително за екземпляр, работещ в режим на удостоверяване simple:
- 2+ процесорни ядра
- 2GB+ RAM
- 10GB+ дисково пространство
Внедряване в режим full, което изпълнява също PostgreSQL, фоновия работен процес и планировчика, се нуждае от приблизително двойно повече.
Действия само за оператора
Раздел, озаглавен „Действия само за оператора“Някои административни задачи нямат екран в приложението и се извършват от командния ред на екземпляра.
Прехвърлянето на организация към нов собственик е основната от тях. Собствениците на
организации нямат екран или крайна точка за това, така че прехвърлянето е ваша задача.
Използвайте командата по-долу. За автоматизация Colonel API предоставя същата
операция на POST /api/colonel/organizations/:org_id/transfer-ownership; тя
изисква ролята colonel, приема името на организацията като потвърждение и
се прилага незабавно, без предварителен преглед.
bin/ots org transfer-ownership ORG NEW_OWNERORG е публичният ИД на организацията (extid, който CLI отпечатва) или
вътрешният ѝ ИД (objid). NEW_OWNER е имейл адрес,
extid на клиент или ИД на Rodauth акаунт, и той трябва вече да е активен
член — командата никога не създава клиент, затова първо изпълнете
bin/ots memberships add ORG CUSTOMER, ако не е.
Изпълнете я без --yes и тя планира прехвърлянето, преди да промени каквото и да е,
като отпечатва кой губи собствеността, колко членства на собственици ще бъдат понижени и до
каква роля, след което ви иска потвърждение. Отговорът n е начинът да прегледате прехвърляне предварително.
Опциите са --demote-to ROLE (всяка роля за членство освен owner, по подразбиране
admin), --yes (също -y и -f) и --json.
Напускащият собственик се понижава, а не се премахва. Операцията повишава новия собственик,
преди да понижи стария — защитата срещу липса на собственик отхвърля всяка друга последователност —
така че за времето на тези два записа организацията има две членства на собственици
и bin/ots org doctor отчита проверка 4 (membership_role_sync) като
предупреждение. Ако прехвърлянето бъде прекъснато в този интервал, изпълнете командата за прехвърляне отново, а не org doctor.
Прехвърлянето е идемпотентно и понижава всеки друг собственик; org doctor маркира тази проверка като
repairable: false и не я поправя.
Страната на крайния потребител е описана в Собственост и прехвърляне — това е, което вашите потребители ще са прочели, преди да се обърнат към вас.
Получаване на помощ
Раздел, озаглавен „Получаване на помощ“- Хранилището в GitHub за изходния код, бележките към изданията и доставяните Compose стекове.
- Системата за проследяване на проблеми за грешки, с етикета на изданието и съответните редове от журнала.
- Свържете се с нас директно за всичко останало.