Написать в техподдержку Позвонить нам
Admin Panel Logout

In this article:

    Management interfaces

    Administrators need to administer and manage project resources to perform various work functions. It is important that these controls are clear and secure.

    The MCS platform provides several management interfaces for users:

    MCS control panel

    MCS control panel, or personal account , consists of information about the project (top), services panel (left) and the main working screen (center).

    Let's consider some elements of this panel:

    At the top you can see:

    • Information about the project
    • Linking a card for automatic balance top-up
    • Current project balance and transition to the "Balance" section
    • Account settings
    • System notifications
    • Ways to quickly contact support

    The services panel contains the main MCS services. The set of services changes as the functionality of the platform is added:

    The main (central) part of the screen reflects the ability to manage the corresponding services and resources.

    API

    To manage resources in the MCS platform, you can use the API to launch instances, create images, assign metadata to instances and images, create containers and storage objects, and more on projects.

    The list of available connection endpoints is always available in the MCS panel under "API Endpoints" .

    Endpoints list

    OpenStack Service Service access point
    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 Object Storage
    S3 (STANDARD) https://hb.bizmrg.com/
    S3 (STANDARD_IA) https://ib.bizmrg.com/
    Machine learning
    Vision (images) https://smarty.mail.ru/
    Vision (video) https://smarty.mail.ru/

    Examples of using the API

    Once authenticated with Identity, you can use other APIs to create and manage resources in your project.

    To start sending API requests, use one of the following methods:

    • cURL . Command line tool that allows you to send HTTP requests and receive responses.
    • Openstack CLI . A client that allows you to access the API through easy-to-use commands.
    • REST clients . Both Mozilla and Google provide browser-based GUIs for REST. For Firefox see RESTClient . For Chrome see rest-client .
    • OpenStack Python Software Development Kit (SDK) . SDK for writing Python automation scripts that create and manage resources in a project. The SDK implements Python bindings to the OpenStack API, which allows you to perform automation tasks in Python by making calls to Python objects instead of direct REST calls. All OpenStack command line tools are implemented using the Python SDK.
    • OpenStack APIs

    Management Utilities (CLI)

    Working with virtual infrastructure is also possible through OpenStackClient. It is a client that allows you to use the OpenStack API through a command line interface using a single and simple command structure.

    A complete list of clients and information on their use can be found in the official developer documentation .

    Installing openstack-client

    The python3-openstackclient package includes a basic set of commands for managing the platform.

    The following instructions will help you install openstackclient:

    Linux

    With apt (Debian, Ubuntu):

     apt update
    apt install python3-openstackclient

    With dnf (RHEL 8, CentOS 8, Fedora):

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

    With yum (CentOS 7):

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

    With pip3:

    To install using pip3, the following packages must be present in the system: gcc, pyhton3-dev, python3-pip.

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

    Windows

    Before getting started, you should install the latest Python3 and Microsoft Build Tools . In the Visual Studio installer, select "C ++ Build Tools" in the "Workloads" section, in the installation components, check only the Windows 10 SDK and MSVC - C ++ Build Tools.

    Next, on the command line:

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

    Installing additional openstack packages

    The following individual clients have been deprecated in favor of the generic openstack-client. Instead of installing and examining all of these clients, it is recommended that you install and use the OpenStack client. In some cases, you need to install the client for a separate project because the functionality of the OpenStack client may not be enough. To install a single client package, replace the PROJECT name in this pip install command using the list below:

     # pip install python-PROJECTclient
    • cinder - block storage API and extensions
    • glance - Image API
    • heat - orchestration API
    • magnum - Kubernetes container infrastructure management API
    • manila - Shared file systems file storage API
    • neutron - networking API
    • nova - Cloud Computing (VM) API and Extensions
    • sahara - big data API
    • trove - Database API

    S3 CLI

    MCS platform uses S3-compatible object storage as a service Object repository (Cloud Storage).

    As an example, you can install the AWS S3 CLI, which will allow you to work with the S3 MCS service:

    Linux

    Installation is carried out using the command:

     pip install awscli

    Windows

    You can install using the 64-bit and 32-bit installer, as well as using the command:

     pip install awscli

    Authorization

    Load the key in the MCS API panel:

    Linux

    Import variables from the key file using the source command:

     source file.sh

    Windows

    Open the API key file downloaded from your personal account, find variables starting with OS_ in it, and import them into the command line using the SET command, for example, substituting the value from the saved API key without quotes into each variable:

     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

    For PowerShell, use variable assignment like this:

     $ 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"

    Note

    For the OS_PASSWORD variable, you need to enter a valid account password, it is not in the API key.

    Check

    Test the CLI with a command like:

     openstack flavor list

    The result will be a list of available instance configurations.

    Or

     aws --version

    Terraform

    With Terraform, you can manage your infrastructure in the cloud as code (IaC). This allows you to spend less time on routine operations and reduces the risk of errors due to the use of scripts.

    Installing Terraform

    To get started, download the package from the developer's official website in accordance with the operating system used. The downloaded archive contains binary code and is not a standalone installer.

    It is recommended to place the unpacked file in a dedicated directory for later recall.

    Authorization

    To use Terraform, download the provider file, change the configuration by adding the account password to the file and place it in the root of the directory with the binary file.

    The Openstack RC file is located in the Project Settings in your personal account :

    You can check the work using the command:

     terraform init

    The configuration will be initialized, the result of which will be the creation of an additional directory and the saving of variables.

    Was this article helpful?