###
### WEB-Сервер-КС Докер
###
### Copyright (C) ООО Кейсистемс 2020
###
### Версия 3.1.8
###


  Описание           : WEB-Сервер-КС Докер - платформа для развертывания прикладных веб-приложений
                       использующих систему контейнерезации.

  Цель использования : Минимизировать издержки, связанные с разворачиванием и настройкой web сервера и .NET Core приложений.

  Требует для работы : Docker-CE (Docker, Inc. лицензия Apache 2.0)

  Характеристики     : Позволяет устанавливать до 9 экземляров контейнеров c web сервером Apache, внутри которого
                       возможна установка .Net Core приложений. Всего на хосте можно развернуть до 50 экземпляров
                       .Net Core приложений (как в одном контейнере, так и в нескольких). Ограничение связано с
                       ограничением диапазона используемых портов: 5443-5493.

                       В поставляемом образе контейнера используются компоненты:
                        - http сервер Apache 2.4 (лицензия Apache 2.0)
                        - Runtime библиотека .NET Core 3.1.8 (лицензия MIT)

                       Для более подробного ознакомления с лицензированием Docker-CE, Apache, .NET Core
                       и информации об авторских правах смотрите соответствующие сайты программ:
                       https://www.docker.com/
                       https://httpd.apache.org/
                       https://dotnet.microsoft.com/


  Внимание! Для выполнения операции необходимы права суперпользователя.

  Основные команды создания и удаления экземпляра контейнера с web сервером:

 1) Создание экземпляра контейнера с web сервером.

    Например, необходимо создать экземпляр контейнера с web сервером с идентификатором 1.
    Диапазон идентификаторов варьируется от 1 до 9.
    Для этого в командной строке с правами суперпользователя выполняем следующую команду:

    [root@demosrv]# /opt/dks-wsks-3.1.8/dks_create.sh "1"

    в результате, при успешном выполнении будет выведено сообщение:

    === Лог выполнения ============================================================================================================================================

    [   OK   ] Проверка работы сервиса докера (docker.service).
    [   OK   ] Загрузка эталонного локального образа wsks-3.1.8 из архива ksdeb_wsks-3.1.8_image.tar.
    [   OK   ] Построение конечного образа wsks-3.1.8_work_001 на базе эталонного.
               Структура каталогов /opt/wsks-3.1.8_001 для запуска контейнера wsks-3.1.8_work_001 не существует, создаем...
    [   OK   ] Создание структуры каталогов для запуска контейнера wsks-3.1.8_work_001.
    [   OK   ] Создание контейнера wsks-3.1.8_work_001 и запуск в docker (идентификатор 001).
               Created symlink from /etc/systemd/system/multi-user.target.wants/wsks-3.1.8_work_001.service to /usr/lib/systemd/system/wsks-3.1.8_work_001.service.
    [   OK   ] Запуск сервиса wsks-3.1.8_work_001.service.
    [   OK   ] Остановка сервиса wsks-3.1.8_work_001.service.
               Отсутствуют установленные приложения.
               Для установки приложений используйте скрипт ws_addapp.sh.
               См. инструкцию по развертыванию /opt/wsks-3.1.8_001/ctl/readme.txt

    ===============================================================================================================================================================

 2) Удаление экземпляра контейнера

    Например, необходимо удалить экземпляр контейнера с web сервером с идентификатором 2.
    Для этого в командной строке с правами суперпользователя выполняем следующую команду:

    [root@demosrv]# /opt/dks-wsks-3.1.8/dks_remove.sh "2"

    При удалении с указанием только идентификатора экземпляра, удаляется только сам контейнер,
    а рабочий каталог остается. Для удаления экземпляра вместе с рабочим каталогом необходимо
    указать второй параметр "all".

    [root@demosrv]# /opt/dks-wsks-3.1.8/dks_create.sh "2" all


 Дополнительная информация:

 Cтруктура каталогов:
 ==================================================================================================================================

   /opt/dks-wsks-3.1.8/
           |-- /docker_image
                |-- Dockerfile
                |-- ksdeb_wsks-3.1.8_image.tar               # образ для создания контейнера (Apache 2.4, dotnet 3.1.8)

           |-- /wsks_files
                |-- /conf.ks                                 # шаблоны конфигурационных файлов для http сервера
                       |-- apache2.conf
                       |-- sslks.conf

                |-- /ctl                                     # шаблоны файлов управления приложениями для развернутого контенера
                       |-- /tar_files                        # каталог размещения архивов .NET Core Приложений

                       |-- app_start.sh
                       |-- app_stop.sh
                       |-- readme.txt
                       |-- ws_addapp.sh
                       |-- ws_const_var.sh.t
                       |-- ws_delapp.sh
                       |-- ws_info.sh
                       |-- ws_start.sh.t
                       |-- ws_stop.sh
                       |-- ws_updapp.sh

                |-- /ssl                                     # Самоподписанные демо сертификаты для ssl соединения
                       |-- wsks-19.08_demo.crt
                       |-- wsks-19.08_demo.key

                |-- /template                                # шаблоны запуска и конфигураций .NET Core приложений
                       |-- 5xxx_app.t
                       |-- 5xxx_ks.conf.t.t
                       |-- 5xxx_ks.ssl.conf.t.t
                       |-- appsettings.Production.json.t
                       |-- ports_5xxx.conf.t
                       |-- ports_5xxx.ssl.conf.t

           |-- COPYRIGHT                                     # файл лицензии
           |-- dks_const_var.sh                              # файл переменных и констант
           |-- dks_create.sh                                 # bash скрипт запуска создания экземпляра контейнера web сервера
           |-- dks_remove.sh                                 # bash скрипт удаления экземпляра контейнера
           |-- install.sh                                    # bash скрипт запуска создания экземпляра контейнера с идентификатором 001
           |-- readme.txt                                    # описание
           |-- uninstall.sh                                  # bash скрипт удаления экземпляра контейнера с идентификатором 001

 ==================================================================================================================================