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

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

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

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

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

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

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

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

3. Нажмите кнопку Войти в личный кабинет.

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

4. В шапке Портала самообслуживания выберите проект для дальнейшей работы (подробнее — в разделе Выбор проекта).

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

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

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

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

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

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

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

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

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

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

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

• python3-keystoneclient-3.10.4.
• python3-novaclient-7.1.57-1.
• python3-cinderclient-1.11.4-1.
• python3-glanceclient-2.6.57.
• python3-neutronclient-6.1.3-1.
• python3-octaviaclient-1.8.5-1.

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

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

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

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

    
   # dnf install python3-openstackclient

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

    
   $ source ~/<ПРОЕКТ>-openrc.sh

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

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

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

    
   Please enter your API token for project 5e5653f0e0024f9a9da58aa7573997be

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

    
   $ openstack flavor list

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

    
   +--------------------------------------+----------------+-------+------+-----------+-------+-----------+| ID                                   | Name           |   RAM | Disk | Ephemeral | VCPUs | Is Public |+--------------------------------------+----------------+-------+------+-----------+-------+-----------+| 2e275f1f-c032-4425-b0fb-dbf8583f62d3 | Standard-12-24 | 24576 |    0 |         0 |    12 | True      |...+--------------------------------------+----------------+-------+------+-----------+-------+-----------+

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

Некоторые операции на Платформе выполняются только с помощью 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: <ТОКЕН>" <ЗАПРОС>

Здесь:

• <ТОКЕН> — значение параметра Токен для доступа к API.
• <ЗАПРОС> — текст запроса.

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

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

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

• Портал самообслуживания.
• OpenStack CLI.

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

1. Подключитесь к OpenStack CLI (подробнее — в разделе Подключение к OpenStack CLI).

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

    
   $ openstack catalog list

1. Установите Terraform c официального зеркала.

2. Подключитесь к OpenStack CLI (подробнее — в разделе Подключение к 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.

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

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