Написать в техподдержку Позвонить нам
Админпанель Выход

Содержание статьи:

    Интерфейсы управления

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

    Платформа MCS предоставляет несколько интерфейсов управления для пользователей:

    Панель управления MCS

    Панель управления MCS, или личный кабинет, состоит из информации о проекте (сверху), панели сервисов (слева) и основного рабочего экрана (по центру).

    Рассмотрим некоторые элементы этой панели:

    В верхней части можно увидеть:

    • Информацию о проекте
    • Привязку карты для автоматического пополнения баланса
    • Текущий баланс проекта и переход в раздел "Баланс"
    • Свойства учетной записи
    • Системные уведомления
    • Способы быстрого обращения в поддержку

    В панели сервисов располагаются основные сервисы MCS. Набор сервисов изменяется по мере дополнения функциональности платформы:

    Основная (центральная) часть экрана отражает возможности управления соответствующими сервисами в и ресурсами.

    API

    Для управления ресурсами платформы MCS можно использовать API для запуска инстансов, создания образов, назначения метаданных инстансам и образам, создания контейнеров и объектов хранения и выполнения других действий в проектах.

    Список доступных конечных точек подключения (endpoints) всегда доступен в панели MCS в разделе "API Endpoints".

    Список endpoints

    Сервис OpenStack Точка доступа сервиса
    Barbican https://public.infra.mail.ru:9311
    Cinder https://public.infra.mail.ru:8776/v3/ebb2c807e3c249ab847b7521a7f0a52b
    Glance https://infra.mail.ru:9292
    Gnocchi https://infra.mail.ru:8041
    Heat https://infra.mail.ru:8004/v1/ebb2c807e3c249ab847b7521a7f0a52b
    Karbor https://public.infra.mail.ru:8799/v1/ebb2c807e3c249ab847b7521a7f0a52b
    Keystone https://infra.mail.ru:35357/v3/
    Magnum https://infra.mail.ru:9511/v1
    Manila https://infra.mail.ru:8786/v2/ebb2c807e3c249ab847b7521a7f0a52b
    Neutron https://infra.mail.ru:9696
    Nova https://infra.mail.ru:8774/v2.1
    Octavia https://public.infra.mail.ru:9876
    Sahara https://infra.mail.ru:8386/v1.1/ebb2c807e3c249ab847b7521a7f0a52b
    Trove https://infra.mail.ru:8779/v1.0/ebb2c807e3c249ab847b7521a7f0a52b
    Объектное хранилище S3
    S3 (STANDARD) https://hb.bizmrg.com/
    S3 (STANDARD_IA) https://ib.bizmrg.com/
    Машинное обучение
    Vision (изображения) https://smarty.mail.ru/
    Vision (видео) https://smarty.mail.ru/

    Примеры использования API

    После аутентификации с помощью Identity можно использовать другие API-интерфейсы для создания и управления ресурсами в проекте. 

    Чтобы начать отправлять запросы API, используется один из следующих методов:

    • cURL. Инструмент командной строки, который позволяет отправлять HTTP-запросы и получать ответы.
    • Openstack CLI. Клиент, который позволяет получать доступ к API через простые в использовании команды.
    • REST клиенты. И Mozilla, и Google предоставляют браузерные графические интерфейсы для REST. Для Firefox см. RESTClient. Для Chrome см. rest-client.
    • OpenStack Python Software Development Kit (SDK). SDK для написания скриптов автоматизации Python, которые создают ресурсы в проекте и управляют ими. В SDK реализованы привязки Python к API-интерфейсу OpenStack, который позволяет выполнять задачи автоматизации в Python, выполняя вызовы объектов Python вместо непосредственных вызовов REST. Все инструменты командной строки OpenStack реализованы с использованием Python SDK.
    • OpenStack APIs

    Утилиты управления (CLI)

    Работа с виртуальной инфраструктурой также возможна через OpenStackClient. Это клиент, позволяющий использовать API OpenStack через интерфейс командной строки c использованием единой и простой структуры команд. 

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

    Установка openstack-client

    Пакет python3-openstackclient включает в себя базовый набор команд для управления платформой.

    Следующие инструкции помогут установить openstackclient:

    Linux

    C помощью apt (Debian, Ubuntu):

    apt update
    apt install python3-openstackclient 

    С помощью dnf (RHEL 8, CentOS 8,  Fedora):

    dnf install https://www.rdoproject.org/repos/rdo-release.el8.rpm 
    dnf update
    dnf install python3-openstackclient

    С помощью yum (CentOS 7):

    yum install https://rdoproject.org/repos/rdo-release.rpm 
    yum update 
    yum install python2-openstackclient

    C помощью pip3:

    Для установки с помощью pip3 в системе должны присутствовать пакеты: gcc, pyhton3-dev, python3-pip.

    pip3 install -UI pbr testresources setuptools pytz wheel 
    pip3 install -UI python-openstackclient

    Windows

    Прежде чем начать, следует установить последнюю версию Python3 и Microsoft Build Tools. В установщике Visual Studio необходимо выбрать "Средства сборки C++" в разделе "Рабочие нагрузки", в компонентах установки отметить только пакет SDK для Windows 10 и MSVC - средства сборки C++.

    Далее, в командной строке:

    pip3 install -UI pbr setuptools pytz wheel 
    pip3 install -UI python-openstackclient

    Установка дополнительных пакетов openstack

    Следующие отдельные клиенты устарели в пользу общего клиента openstack-client. Вместо того, чтобы устанавливать и изучать все эти клиенты, рекомендуется установить и использовать клиент OpenStack. В некоторых случаях необходимо установить клиент отдельного проекта, поскольку функциональности клиента OpenStack может быть недостаточно. Для установки пакета отдельного клиента, следует заменить имя PROJECT в этой команде pip install, используя приведенный ниже список:

    # pip install python-PROJECTclient
    • cinder - API блочного хранилища и расширений
    • glance - API образов
    • heat - API оркестрации
    • magnum - API управления инфраструктурой контейнеров Kubernetes
    • manila - Shared file systems API файлового хранилища
    • neutron - API сетей
    • nova - API облачных вычислений (ВМ) и расширений
    • sahara - API обработки больших данных
    • trove - API баз данных

    S3 CLI

    Платформа MCS использует S3-совместимое объектное хранилище в качестве сервиса Объектное хранилище (Cloud Storage).

    В качестве примера можно установить AWS S3 CLI, который позволит работать с S3 сервисом MCS:

    Linux

    Установка осуществляется с помощью команды:

    pip install awscli

    Windows

    Установить можно с помощью 64-битной и 32-битной программы-установщика, а также при помощи команды:

    pip install awscli

    Авторизация

    Загрузите в панели MCS API ключ:

    Linux

    Выполните импорт переменных из файла ключа с помощью команды source:

    source file.sh 

    Windows

    Откройте загруженный из личного кабинета файл ключа API, найдите в нем переменные, начинающиеся на OS_, и импортируйте в командную строку с помощью команды SET по примеру, в каждую переменную подставив значение из сохраненного API ключа без кавычек:

    set OS_INTERFACE=public
    set OS_AUTH_URL=https://infra.mail.ru:35357/v3/
    set OS_USERNAME=email
    set OS_PROJECT_ID=projectID
    set OS_USER_DOMAIN_NAME=users
    set OS_PASSWORD=your_password
    set OS_IDENTITY_API_VERSION=3

    Для PowerShell следует использовать назначение переменных следующим образом: 

    $env:OS_INTERFACE = "public"
    $env:OS_AUTH_URL = "https://infra.mail.ru:35357/v3/"
    $env:OS_USERNAME = "email"
    $env:OS_PROJECT_ID = "projectID"
    $env:OS_USER_DOMAIN_NAME = "users"
    $env:OS_PASSWORD = "your_password"
    $env:OS_IDENTITY_API_VERSION = "3"

    Примечание

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

    Проверка

    Проверьте работу CLI с помощью команды, например:

    openstack flavor list

    В результате будет получен список доступных конфигураций инстансов.

    Или

    aws --version

    Terraform

    C помощью Terraform можно управлять инфраструктурой в облаке как кодом (IaС). Это позволяет затрачивать меньше времени на рутинные операции и снижает риск возникновения ошибок за счет использования скриптов.

    Установка Terraform

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

    Рекомендуется поместить распакованный файл в выделенную директорию для последующего вызова.

    Авторизация

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

    Файл Openstack RC расположен в Настройках проекта в личном кабинете:

    Проверить работу можно используя команду:

    terraform init

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

    Полезна ли была эта статья?