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