Перейти к основному содержимому
OpenStack CLI
Последнее изменение:

OpenStack CLI

OpenStack CLI — это консольный клиент для работы с OpenStack API. Через OpenStack CLI в Selectel можно управлять облачной инфраструктурой: серверами, группами размещения, сетевыми дисками, сетями, образами и балансировщиками нагрузки.

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

Актуальные версии компонентов, которые поддерживаются в Selectel, можно посмотреть в таблице Версии компонентов OpenStack.

OpenStack CLI можно установить в локальной системе.

  1. Установите OpenStack CLI и дополнительные пакеты. Если для работы с OpenStack CLI вы хотите использовать Docker-контейнер, этот шаг выполнять не нужно.
  2. Создайте сервисного пользователя для авторизации в OpenStack API.
  3. Настройте авторизацию в OpenStack API.

Версии компонентов OpenStack

Версия релизаВерсия API
KeystoneZed3.14
PlacementZed1.0 (максимальная микроверсия — 1.39)
NovaZed2.1 (максимальная микроверсия — 2.93)
NeutronUssuri2.0
CinderWallaby3.0 (максимальная микроверсия — 3.64)
GlanceZed2.16
KarborWallaby1.0
ManilaZed2.0 (максимальная микроверсия — 2.75)
HeatZed1.0
Octavia2023.12.26
Gnocchi4.51.0

Установить OpenStack CLI

  1. Откройте CLI.

  2. Установите Python 3:

    sudo apt update
    sudo apt install python3
  3. Установите pip3:

    sudo apt install python3-pip
  4. Установите OpenStack CLI:

    pip3 install python-openstackclient
  5. Проверьте, что OpenStack CLI установлен:

    openstack --version

    В ответе появится номер версии.

  6. Опционально: установите компонент Octavia для работы с облачными балансировщиками нагрузки — для совместимости с версией релиза Yoga требуется версия 3.4.0:

    pip3 install python-octaviaclient===3.4.0
  7. Опционально: установите компонент Glance для работы с образами:

    pip3 install python-glanceclient

Создать сервисного пользователя

Для авторизации в OpenStack API нужно создать сервисного пользователя с ролью Администратор проекта или Наблюдатель проекта и добавить его в проект.

  1. В панели управления перейдите в раздел Управление доступомУправление пользователями.

  2. Нажмите Добавить пользователя.

  3. Выберите тип Сервисный пользователь.

  4. Введите имя пользователя. Оно будет использоваться при авторизации.

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

  6. Сохраните пароль — после создания пользователя посмотреть пароль нельзя, только изменить.

  7. Выберите роль пользователя:

    • Администратор проекта — может создавать, редактировать и удалять ресурсы проекта;
    • Наблюдатель проекта — может просматривать ресурсы проекта.
  8. Отметьте проекты, в которые нужно добавить пользователя.

  9. Нажмите Добавить пользователя.

Настроить авторизацию

Для авторизации в OpenStack API нужно добавить переменные окружения. В Unix-системах (Ubuntu, Debian, CentOS и macOS) для этого нужно запустить скрипт из RС-файла, который можно скачать в панели управления, в Windows — добавить переменные вручную.

осторожно

Авторизацию в OpenStack API можно настроить только для одного сервисного пользователя, проекта и пула. При необходимости можно изменить данные для авторизации.

  1. В панели управления перейдите в раздел Облачная платформаДоступ.

  2. Откройте вкладку Внешний доступ.

  3. Выберите созданного сервисного пользователя с ролью Администратор проекта или Наблюдатель проекта.

  4. Выберите пул. Управлять инфраструктурой проекта можно будет только в этом пуле.

  5. Нажмите Скачать.

  6. В локальной системе перейдите в директорию со скачанным RC-файлом:

    cd <directory_name>

    Укажите <directory_name> — имя директории с RC-файлом.

  7. Запустите скрипт из RC-файла:

    source <file_name.sh>

    Укажите <file_name.sh> — имя RC-файла, по умолчанию rc.sh.

  8. Введите пароль OpenStack — пароль сервисного пользователя, для которого создан RC-файл.

  9. Проверьте работу OpenStack CLI, например, откройте список облачных серверов:

    openstack server list

    Если в пуле и проекте, которые указаны в RC-файле, созданы облачные серверы, то в выводе команды появится их список. Если серверы пока не созданы, в выводе команды будет пустая строка.

Изменить данные для авторизации

Чтобы изменить данные для авторизации:

  • задайте новые значения переменных окружения. Для Ubuntu, Debian, CentOS и macOS — измените переменные в RC-файле; для Windows — задайте значения напрямую;
  • передайте новые значения в командах OpenStack CLI ключами. Например, для изменения пула используйте ключ --os-region-name. Список всех опций и примеры можно посмотреть в разделе Options документации OpenStack.