Основные интерфейсы
Для работы с Платформой используются следующие типы интерфейсов:
- Графические интерфейсы (GUI).
- Командные строки (CLI).
- Программные интерфейсы (API).
Далее будут рассмотрены основные интерфейсы, доступные для взаимодействия со стороны пользователей и администраторов Платформы.
Чтобы получить доступ к функциям Портала администратора или Портала самообслуживания необходимо пройти двухфакторную аутентификацию. Для двухфакторной аутентификации используется пароль учётной записи и код, приходящий по электронной почте.
Чтобы открыть графический интерфейс Платформы:
- При помощи веб-браузера перейдите по адресу Портала администратора или Портала самообслуживания.
- Введите логин и пароль учётной записи от соответствующего Портала.
- Нажмите кнопку Войти или Войти в личный кабинет. На электронную почту, которая используется в качестве логина, придет письмо с кодом.
- Введите код из письма и нажмите кнопку Войти или Войти в личный кабинет.
При успешной двухфакторной аутентификации откроется интерфейс Портала администратора или Портала самообслуживания.
Портал самообслуживания является основным графическим интерфейсом пользователей Платформы и используется для управления виртуальными ресурсами в рамках одного или нескольких проектов. Каждая учётная запись может иметь доступ к неограниченному количеству проектов. Роли пользователей, а значит и их доступ к функциям Платформы могут отличаться от проекта к проекту.
Условное обозначение: VK CP UI (или MCS UI, устаревшее).
Доступ к Порталу самообслуживания Платформы осуществляется при помощи веб-браузера по адресу:
vkc.your_domain_name.ru
где your_domain_name.ru — это доменное имя Заказчика Платформы.
Для входа в Портал самообслуживания используется любая персональная учётная запись пользователя Платформы.
Портал администратора является основным графическим интерфейсом администраторов Платформы и используется для управления основными настройками, административными функциями Платформы и ролями групп пользователей в проектах.
Вместо Портала администратора возможно использовать OpenStack CLI.
Доступ к Порталу администратора Платформы осуществляется при помощи веб-браузера по адресу:
admin.your_domain_name.ru
где your_domain_name.ru — это доменное имя Заказчика Платформы.
Для входа в Портал администратора используется учётная запись Платформы, для которой были выставлены роли с префиксом sa_. При настроенной интеграции с LDAP-провайдером может быть использована учётная запись LDAP-провайдера. Выдачу ролей для пользователей из LDAP-провайдера можно автоматизировать штатными средствами Keycloak.
Портал мониторинга является основным графическим интерфейсом для мониторинга Платформы.
Условное обозначение: Zabbix.
Доступ к Порталу мониторинга Платформы осуществляется при помощи веб-браузера по адресу:
monitoring.your_domain_name.ru
где your_domain_name.ru — это доменное имя Заказчика Платформы.
В случае наличия интеграции с LDAP-провайдером для входа в Портал мониторинга используется учётная запись Администратора Платформы из LDAP-провайдера. В противном случае используется отдельная учётная запись администратора Zabbix.
Портал логирования является основным графическим интерфейсом для просмотра журналов событий Платформы.
Условное обозначение: OpenSearch.
Доступ к Порталу логирования Платформы осуществляется при помощи веб-браузера по адресу:
logs.your_domain_name.ru
где your_domain_name.ru — это доменное имя Заказчика Платформы.
В случае наличия интеграции с LDAP-провайдером для входа в Портал логирования может использоваться учётная запись Администратора Платформы из LDAP-провайдера. В противном случае используется отдельная учётная запись администратора для доступа к Порталу логирования.
Портал управления доступом является графическим интерфейсом администраторов Платформы для управления пользователями, группами пользователей и настройками защиты отдельных сервисов Платформы.
Условное обозначение: Keycloak.
Через этот интерфейс или через API Keycloak создаются, удаляются и настраиваются стандартные учетные записи Платформы. А также задаются различные параметры доступа к Платформе, например, интеграция Платформы с LDAP-провайдером в части учётных записей пользователей.
Доступ к Порталу управления доступом Платформы осуществляется при помощи веб-браузера по адресу:
idm.your_domain_name.ru
где your_domain_name.ru — это доменное имя Заказчика Платформы.
Для входа в Портал управления доступом используется стандартная учётная запись Платформы, имеющая соответствующие права доступа.
Для работы Пользователей Платформы использование командной строки не требуется.
Для администрирования Платформы может потребоваться использование следующих интерфейсов командной строки:
- SSH и Bash (выполнение команд после подключения к узлам Платформы).
- OpenStack CLI.
- Ansible.
- cURL.
Защищённый протокол для удалённого доступа к компьютерам, в том числе для подключения к узлам Платформы.
Базовый синтаксис для подключения к узлу Платформы (подробнее — в разделе Вход на деплой-ноду по SSH):
$ ssh <ИМЯ_ПОЛЬЗОВАТЕЛЯ>@<IP_ХОСТА>
Описание параметров можно найти в документации на ОС, в которой будет использоваться SSH (пример для Ubuntu).
Интерфейс командной строки для API-интерфейсов OpenStack.
По умолчанию OpenStack CLI развёрнут на узлах Платформы и не требует дополнительной настройки. При использовании локального OpenStack CLI может понадобиться установка зависимостей, подробнее — в разделе ПО для подключения к OpenStack CLI.
Базовый синтаксис приведён в разделе Справочник команд OpenStack.
Интерфейс командной строки для развёртывания, конфигурирования и обновления компонентов Платформы.
Базовый синтаксис приведён в официальной документации.
Инструмент командной строки, часто используемый для отправки HTTP-запросов. Поддерживает большое количество протоколов, в том числе HTTP-запросов к RESTful API.
$ curl [options/URLs]
Описание параметров приведено в официальной документации.
Пример использования приведён в разделе Использование REST API для управления Платформой.
Инструмент командной строки для управления Docker-контейнерами.
$ docker [options] <COMMAND> [<ARGUMENTS>]
Описание параметров приведено в официальной документации.
Инструмент командной строки для управления кластерами Kubernetes с целью создания и управления кластерами.
$ kubectl [command] [<TYPE>] [<NAME>] [flags]
Описание параметров приведено в официальной документации.