Перейти к содержанию

Приложения

Установка

Приложения в Cloudron устанавливаются из раздела Магазин приложений. При нажатии на карточку приложения, Вам откроется подробная информация о нём.

app_info.png

Если Вы хотите установить приложение, нажмите на кнопку Установить. После этого Вам раскроется диалог установки.

app_install.png

Поле Расположение даёт возможность указать поддомен, на который будет установлено приложение. Из выпадающего списка справа от этого поля Вы можете выбрать нужный домен (если было добавлено несколько). Вы можете оставить поле пустым для того, чтобы приложение было установлено на сам домен (для примера, smartserver.space, как на картинке выше).

Поле расположения поддерживает многоуровневость

Поле Расположение может быть разного уровня. Для примера, Вы можете указать blog.dev, и в таком случае приложение будет доступно по адресу blog.dev.smartserver.space.

Настройка

Нажатие шестерёнки на карточке приложения открывает окно для детальной настройки.

app-configure-button.png

Отображение

Название - это текст, отображаемый в карточке приложения под его иконкой. Метки - это механизм, который позволяет задавать фильтрующие метки приложениям с целью удобной организации на Панели управления.

app-labels-and-tags.png

Расположение

В разделе Расположение Вы можете изменять поддомен или весь домен для конкретного приложения.

Без потерь данных

Изменение настроек в этом разделе абсолютно безопасно. Все Ваши данные останутся в целости, а приложение будет доступно под другим адресом.

Псевдонимы

Данная функция доступна только для ограниченного ряда приложений, которые поддерживают множество доменов: WordPress, EspoCRM, Surfer

Переадресации

Эта функция служит для добавления дополнительных доменов, которые будут переадресовывать пользователей на выбранное приложение.

app-redirect.png

В примере выше chat2.cloudron.ml или chat3.smartserver.io будут автоматически переадресовывать на chat.cloudron.ml (используя HTTP 302).

Переадресации также сохраняют любые компоненты URL.

Ограничение доступа

Множество приложений, поставляемых в Cloudron, также интегрированы в его систему управления пользователями. Для таких приложений могут быть назначены как группы, так и отдельные пользователи, которые получают доступ к их использованию. Для прочих приложений требуется настраивать видимость в Панели управления.

Учтите, что Cloudron даёт возможность авторизоваться, но не назначает роли внутри конкретного приложения. Например, чтобы назначить роль автора или комментатора в WordPress, Вам нужно использовать настройки внутри приложения.

app-configure-group-acl.png

  • Разрешить всем пользователям этого Cloudron - все пользователи Cloudron, смогут авторизоваться в выбранном приложении.
  • Разрешить только следующим пользователям и группам - только указанные пользователи и/или группы смогут авторизоваться в выбранном приложении.

Операторы

Администратор может назначить конкретных пользователей и/или группы в качестве операторов приложений. Оператор приложений может управлять приложениями, а также изменять их настройки. Однако обладатель данной роли не способен клонировать приложения или устанавливать новые.

app-operators.png

Операторы могут получить доступ к интерфейсу настроек, как и администратор, через специальную иконку на карточке приложения.

app-operator-button.png

Интерфейс ничем не отличается, однако некоторые разделы для операторов будут недоступны.

app-operator-view.png

Видимость панели управления

Панель управления Cloudron отображает для пользователя те приложения, к которым он имеет доступ. Для приложений, использующих Single Sign-on, настройки отображения определяются через раздел Ограничение доступа.

Приложения, не использующие Single Sign-on (как правило публичные форумы или чаты) по умолчанию отображаются для всех пользователей Cloudron. Но это поведение может быть изменено Администратором через настройку Видимость панели управления.

apps-dashboard-visibility.png

Ресурсы

Лимит памяти

Все приложения по умолчанию имеют ограничения по использованию оперативной памяти. Стандартный лимит для приложения устанавливается его автором, и расчитывается из необходимого минимума для корректного функционирования. Администраторы Cloudron могут регулировать это значение в зависимости от активности использования того или иного приложения.

Когда выделенная для приложения память заканчивается, Cloudron автоматически перезапускает его и отправляет оповещение на электронную почту администратора.

Лимит памяти может быть установлен при помощи слайдера в разделе Ресурсы настроек приложения.

app-memory-slider.png

Лимит памяти учитывает Swap

Лимит памяти устанавливается из расчёта 50/50. 50% установленного значения приходится на RAM, а остальные 50% на swap.

Доля CPU

По умолчанию все приложения используют столько ресурсов CPU, сколько им нужно. В том случае, когда циклы CPU ограничены, данная опция определяет, как ядро Linux должно распределять ресурсы CPU между приложениями. Доля CPU - это процентное значение, которое устанавливает приоритет ресурсов CPU для каждого отдельного приложения, но не резервируя их абслолютно.

Доля CPU может быть установлна при помощи слайдера в разделе Ресурсы настроек приложения.

app-cpu-share.png

Хранилище

Данные приложения

Приложения хранят свои данные и ресурсы в директории /home/yellowtent/appsdata/<appid>. Если на сервере заканчивается дисковое место есть возможность перенести каталог приложения в другое место. В большинстве случаев это примонтированный внешний диск, например, блоковое хранилище Digital Ocean или Amazon Elastic Block Store.

Скажем, Вы хотите переместить данные Nextcloud на такое внешнее хранилище, примонтированное по пути /mnt/nextcloud. Для этого перейдите в раздел Хранилище и укажите путь в следующем формате:

apps-data-directory.png

Данные приложения - это часть резервной копии

Даже если Вы разместили каталог приложения на внешний диск, он всё равно будет являться частью резервной копии всего приложения.

Монтирование

В Cloudron приложения не имеют доступа к файловой системе сервера по причине их контейнеризации. Чтобы предоставить такой доступ Администратор сервера может создать Том и смонтировать его в приложение.

Сначала создайте том в меню Тома:

storage-volumes-add.png

Далее созданный том может быть смонтирован в настройках приложения.

apps-mount.png

Тома монтируются в директорию /media отдельного приложения. В примере выше приложение получает доступ к музыкальным файлам через /media/music (что совпадает с "родительской" директорией /mnt/songs).

Если установлен флаг "Только чтение" директория /media/music будет защищена от записи.

Исходящая почта

Cloudron автоматически настраивает адрес почтового ящика для приложений, способных отправлять исходящие письма. Чтобы изменить адрес, перейдите в раздел Почта.

apps-mailbox-name.png

Имя отправителя

Для ряда приложений Вы сможете указать своё имя отправителя. Если для Вас недоступно это поле, значит приложение не поддерживает эту возможность.

Для некоторых приложений Вы также можете полностью отключить настройки электронной почты, предоставляемые Cloudron. В таком случае Вам нужно будет настраивать исходящую почту в самом приложении.

apps-mailbox-disable.png

Это не почтовый ящик, а просто адрес

Настройки исходящей почты указывают лишь адрес, с которого почтовый сервер Cloudron будет высылать письма. Если Вы хотите получать ответ на указанный адрес, необходимо отдельно создать почтовый ящик с аналогичным именем. Без него, все входящие сообщения будут отскакивать.

Входящая почта

Для приложений, способных получать входящую почту, можно настроить отдельный ящик для приёма писем.

apps-inbox.png

При создании ящика Cloudron сгенерирует динамические имя пользователя и пароль для получения доступа к его содержимому.

Почтовый ящик можно привязать таким образом только в том случае, если домен хостится на внутреннем почтовом сервере Cloudron. Если Вы используете внешний почтовый сервер, отключите данную настройку, чтобы добавить почтовый ящик в самом приложении.

Почтовый ящик нужно создать вручную

Указанные выше настройки лишь указывают приложению на почтовый ящик, но не создают его. Это необходимо сделать отдельно через настройки электронной почты сервера.

robots.txt

Файл Robots.txt находится в корне сайта и предоставляет информацию поисковым ботам о том, могут ли они индексировать страницу или нет. Файл следует стандарту Robots Exclusion Standard. У Google есть отличная документация на этот счёт.

Содержимое файла robots.txt может быть установлено в меню Безопасность в настройках приложений.

По умолчанию Cloudron не устанавливает свои значения, предоставляя приложению возможность устанавливать собственный файл robots.txt.

app-robots-txt.png

В дополнение, в Cloudron зашито правило на запрет индексации панели администратора Cloudron:

User-agent: *
Disallow: /

Терминал

В состав Cloudron входит веб-терминал, который даёт прямой доступ к файловой системе конкретного приложения. Веб-терминал может быть использован для просмотра и модификации файлов, получения доступа к базам данных и пр.

Учтите, что Cloudron запускает приложения в виде контейнеров с файловой системой, открытой только для чтения. В связи с этим внести изменения возможно только в run (динамические данные), /app/data и /tmp (временные файлы).

Запустить терминал можно при помощи специальной кнопки в настройках приложения:

app-terminal-button.png

Нажатие на иконку открывает новое окно в браузере.

terminal-exec2.png

Файловый менеджер

Для получения доступа к файловой системе приложения Cloudron дополнительно предоставляет интерфейс файлового менеджера.

Запустить файловый менеджер можно при помощи специальной кнопки в настройках приложения:

app-filemanager-button.png

Нажатие на иконку открывает новое окно в браузере.

filemanager.png

Дополнительные действия, вроде переименования, удаления, копирования, доступны из контекстного меню по нажатию правой кнопки мыши.

FTP Доступ

Некоторые приложения, вроде Wordpress, LAMP или Surfer поддерживают предоставление доступа к файлам через SFTP протокол. Информация для подключения любым SFTP клиентом содержится в меню SFTP Доступ.

apps-sftp-info.png

Если Вы планируете использовать FileZilla, настройки будут выглядеть примерно так:

  • Host - sftp://my.cloudron.space (это значение одинаково для всех приложений с поддержкой SFTP);
  • Username - girish@lamp.cloudron.space (имя пользователя уникально для каждого приложения);
  • Password - пароль Cloudron (пароль одинаков для всех приложений с поддержкой SFTP);
  • Port - 222

sftp-filezilla.png

Только администраторы Cloudron могут получить доступ к SFTP. Чтобы предоставить такой доступ другому пользователю, назначьте ему роль оператора.

Просмотр журналов

Чтобы просмотреть журнал приложения, нажмите на кнопку Логи:

app-logs-button.png

Журнал откроется в отдельном окне и будет выглядеть следующим образом:

app-logs.png

Остановка приложения

Если Вы хотите освободить ресурсы сервера или временно не нуждаетесь в каком-либо приложении, Вы можете не удалять его, а просто отключить. Для этого нажмите на кнопку Остановить:

app-stop-button.png

Удаление приложения

Если же приложение Вам действительно не нужно, его возможно удалить из пункта меню Удаление.

app-uninstall-button.png

Обратите внимание, что вместе с приложением происходит удаление всех его данных.

Резервные копии не удаляются

Удаление не затрагивает резервные копии, которые очищаются в соответствии с отдельно настроенной политикой. При необходимости, Вы можете восстановить приложение из бэкапа, воспользовавшись CLI инструментом.