Подготовка к работе

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

Чтобы использовать Портал самообслуживания:

1. При помощи любого поддерживаемого веб-браузера откройте страницу с адресом:

    
   vkc.<ДОМЕННОЕ_ИМЯ>

   Здесь <ДОМЕННОЕ_ИМЯ> — это доменное имя вашей компании, где развёрнута Платформа.

2. Введите логин и пароль своей учётной записи.

3. Нажмите кнопку Войти. На электронную почту, которая используется в качестве логина, придёт письмо с кодом.

4. Введите код из письма и нажмите кнопку Войти.

При работе с Порталом самообслуживания:

• По умолчанию ограничений на количество одновременных сеансов доступа нет. Установить ограничение в один активный сеанс доступа для каждой учётной записи может только администратор.

• После 1 часа бездействия сеанс доступа будет завершён. Пройдите аутентификацию заново.

• Учётная запись может быть заблокирована, если Платформа не использовалась более 45 дней.

  При входе в Портал самообслуживания с помощью заблокированной учётной записи на экране появится ошибка входа «403».

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

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

Для доступа к OpenStack CLI пользователю Платформы потребуются следующие инструменты и файлы:

• Программное обеспечение (ПО), обеспечивающее доступ к OpenStack CLI (подробнее — в разделе ПО для подключения к OpenStack CLI).
• Конфигурационный файл с параметрами подключения к проекту (подробнее — в разделе Конфигурационный файл для подключения).

Чтобы подключиться к среде с установленным ПО для доступа к OpenStack CLI:

1. Установите OpenStack CLI:

    
   $ pip install python-openstackclient

2. Установите службу Manila:

    
   $ pip install python-manilaclient

3. Установите службу Trove:

    
   $ pip install python-troveclient

4. Выполните загрузку параметров подключения из конфигурационного файла:

    
   $ source ~/<USER_PROJECT>-openrc.sh

   Здесь ~/<USER_PROJECT>-openrc.sh — путь к конфигурационному файлу для подключения к соответствующему проекту.

5. При необходимости введите токен API.

   Пример запроса токена API

    
   Please enter your API token for project 5e5653f0e0024f9a9da58aa7573997be

6. Проверьте подключение OpenStack CLI:

    
   $ openstack flavor list

   Пример ожидаемого результата

    
   +-----+-----------+-------+------+-----------+-------+-----------+| ID  |   Name    |  RAM  | Disk | Ephemeral | VCPUs | Is_Public |+-----+-----------+-------+------+-----------+-------+-----------+|  1  | m1.tiny   | 512   |    1 |         0 |     1 | True      |+-----+-----------+-------+------+-----------+-------+-----------+

   В случае получения ошибки, обратитесь к администратору Платформы.

Для подключения рекомендуется использование пакета python3-openstackclient-5.6.0.

Пакеты для запуска:

• python3-keystoneclient-3.10.0.
• python3-novaclient-7.1.2.
• python3-cinderclient-1.11.1.
• python3-glanceclient-2.6.0.
• python3-neutronclient-6.1.1.
• python3-octaviaclient-1.8.2.

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

Чтобы получить конфигурационный файл в Портале самообслуживания:

1. Выполните подготовительные операции (подробнее — в разделе Подготовка к работе).
2. Нажмите на имя пользователя в шапке страницы и выберите пункт Настройки проекта.
3. Перейдите на вкладку Доступ по API и нажмите кнопку Скачать openrc версии 3.
4. Сохраните файл на локальном диске. Скачанный файл является конфигурационным файлом для подключения к OpenStack CLI.

 
#!/usr/bin/env bashexport OS_AUTH_URL="https://URL.ru:5000/v3/"export OS_AUTH_TYPE="v3token"export OS_PROJECT_ID="7a1dd7b9be3246a4b113e349b288a210"export OS_REGION_NAME="RegionOne"unset OS_PROJECT_NAMEunset OS_PROJECT_DOMAIN_ID# unset v2.0 items in case setunset OS_TENANT_IDunset OS_TENANT_NAMEecho "Please enter your API token for project $OS_PROJECT_ID"read -sr OS_TOKEN_INPUTexport OS_TOKEN=$OS_TOKEN_INPUTexport OS_INTERFACE=publicexport OS_IDENTITY_API_VERSION=3

Некоторые операции в Платформе (например, удаление вычислительного узла из nova-placement-api) выполняются только с помощью REST API.

HTTP/HTTPS запросы к REST API по умолчанию будут работать с деплой-ноды и/или управляющего узла. Для того чтобы они работали из других подсетей необходимо открыть доступ из них (Firewall и маршрутизация).

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

Получить токен аутентификации можно в Портале самообслуживания:

1. Выполните вход в Портал самообслуживания с учётными данными Пользователя Платформы.
2. Нажмите на имя пользователя в шапке страницы и выберите пункт Настройки проекта.
3. Перейдите на вкладку Доступ по API.
4. Скопируйте значение параметра Токен для доступа к API.

 
TOKEN=$(openstack token issue -c id -f value)

 
# curl -X POST -H "X-Auth-Token: <ТОКЕН>" <ТЕКСТ_ЗАПРОСА>

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

1. Выполните вход в Портал самообслуживания с учётными данными Пользователя Платформы.
2. Нажмите на имя пользователя в шапке страницы и выберите пункт Настройки проекта.
3. Перейдите на вкладку Доступ по API.
4. В нижней части экрана нажмите кнопку Перевыпустить.

Чтобы получить точки доступа к API, используйте один из интерфейсов:

• Портал самообслуживания (подробнее — в Руководстве пользователя VK Private Cloud).
• OpenStack CLI.

1. Выполните вход в Портал самообслуживания с учётными данными Пользователя Платформы.
2. Нажмите на имя пользователя в шапке страницы и выберите пункт Настройки проекта.
3. Перейдите на вкладку API Endpoints.
4. Скопируйте значение параметра Точка доступа сервиса.

1. Выполните подготовительные операции (подробнее — в разделе OpenStack CLI).
2. Выполните команду:

 
$ openstack catalog list

1. Скачайте и установите Terraform c официального сайта.

2. Выполните подготовительные операции (подробнее — в разделе OpenStack CLI).

3. Перейдите в Личный кабинет.

4. Нажмите на имя пользователя в шапке страницы и выберите пункт Настройки проекта.

5. Перейдите на вкладку Terraform.

6. Скачайте основной файл конфигурации Terraform и файл конфигурации зеркала Terraform, нажав одноимённые кнопки.

   Будут скачаны файлы с именами vkcs_provider.tf и terraform.rc.

7. Выполните с файлами следующие действия:

   Для Windows — введите %APPDATA% в адресную строку проводника Windows и скопируйте в открывшуюся директорию terraform.rc.

   Для других ОС — переименуйте файл конфигурации зеркала Terraform из terraform.rc в .terraformrc и скопируйте его в корень домашней директории пользователя.

8. Скопируйте файл vkcs_provider.tf в рабочую директорию, из которой планируете работать с проектом.

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

В директории, из которой планируете работать с проектом, выполните команду terraform init.

Будут созданы дополнительные файлы, необходимые для работы Terraform.

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

2. Выполните команду terraform apply.

3. При запросе подтверждения введите yes.

Дождитесь завершения операции.

Созданные ресурсы появятся в Портале самообслуживания.