Настроить OpenStack CLI

Настроить консольный клиент CLI можно:

• средствами операционной системы;
• в Docker-контейнере.

Настроить OpenStack CLI средствами ОС

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

2. Добавьте сервисного пользователя.

3. Скачайте RC-файл сервисного пользователя для авторизации в OpenStack API.

4. Настройте авторизацию в OpenStack API.

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

Ubuntu/Debian

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

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

   sudo apt update
   sudo apt install python3 virtualenv

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

   sudo apt install python3-pip

4. Создайте виртуальную среду для работы с OpenStack:

   virtualenv env

5. Активируйте виртуальную среду:

   source env/bin/activate

6. Установите OpenStack CLI в виртуальную среду:

   pip3 install python-openstackclient

7. Убедитесь, что OpenStack CLI установлен:

   openstack --version

   В ответе появится номер версии OpenStack CLI. Например:

   openstack 6.1.0

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

   pip3 install python-octaviaclient

9. Опционально: для работы с образами облачных серверов установите компонент Glance:

   pip3 install python-glanceclient

10. Опционально: для работы с файловыми хранилищами установите компонент Manila:

    pip3 install python-manilaclient==3.4.0

CentOS

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

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

   sudo dnf update -y
   sudo dnf install python3 -y
   sudo dnf install virtualenv -y
   sudo dnf install python3-pip -y

3. Установите OpenStack CLI в виртуальную среду:

   pip3 install python-openstackclient

4. Убедитесь, что OpenStack CLI установлен:

   openstack --version

   В ответе появится номер версии OpenStack CLI. Например:

   openstack 6.1.0

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

   pip3 install python-octaviaclient

6. Опционально: для работы с образами облачных серверов установите компонент Glance:

   pip3 install python-glanceclient

7. Опционально: для работы с файловыми хранилищами установите компонент Manila:

   pip3 install python-manilaclient==3.4.0

macOS

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

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

   brew install python3

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

   pip3 install virtualenv

4. Установите OpenStack CLI в виртуальную среду:

   brew install openstackclient

5. Убедитесь, что OpenStack CLI установлен:

   openstack --version

   В ответе появится номер версии OpenStack CLI. Например:

   openstack 6.1.0

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

   pip3 install python-octaviaclient

7. Опционально: для работы с образами установите компонент Glance:

   pip3 install python-glanceclient

8. Опционально: для работы с файловыми хранилищами установите компонент Manila:

   pip3 install python-manilaclient==3.4.0

Windows

1. Установите Python, например, версию Python 3.12.0. Во время установки отметьте чекбокс Add python.exe to PATH.

2. Установите Microsoft C++ Build Tools. Во время установки в разделе Workloads в блоке Desktop & Mobile отметьте чекбокс Desktop development with C++.

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

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

   pip3 install python-openstackclient

5. Убедитесь, что OpenStack CLI установлен:

   openstack --version

   В ответе появится номер версии OpenStack CLI. Например:

   openstack 6.1.0

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

   pip3 install python-octaviaclient

7. Опционально: для работы с образами облачных серверов установите компонент Glance:

   pip3 install python-glanceclient

8. Опционально: для работы с файловыми хранилищами установите компонент Manila:

   pip3 install python-manilaclient==3.4.0

2. Добавить сервисного пользователя

Для управления ресурсами проекта через OpenStack API добавьте сервисного пользователя с разрешением в области доступа Проекты и ролью:

• member;
• или reader.

Добавлять пользователей может Владелец аккаунта или пользователи с ролью iam_admin.

3. Скачать RC-файл

Для настройки авторизации нужно скачать RC-файл сервисного пользователя.

1. В панели управления в верхнем меню нажмите Аккаунт.

2. Перейдите в раздел Сервисные пользователи.

3. Откройте страницу сервисного пользователя, которого вы добавили на этапе 2 → вкладка Доступ.

4. В блоке RC-файлы:

   4.1. Выберите проект.

   4.2. Выберите регион.

   4.3. Выберите пул.

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

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

к сведению

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

Linux/macOS

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

2. Перейдите в директорию с RC-файлом, который вы скачали на этапе 3:

   cd <directory_name>

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

3. Примените переменные окружения из RC-файла:

   source <rcfile_name>

   Укажите <rcfile_name> — имя RC-файла, который вы скачали на этапе 3. По умолчанию rc.sh.

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

5. Убедитесь, что OpenStack CLI работает. Для этого откройте список облачных серверов:

   openstack server list

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

Windows

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

2. Добавьте переменные окружения:

   set OS_AUTH_URL=<url>
   set OS_IDENTITY_API_VERSION=3
   set OS_VOLUME_API_VERSION=3
   set CLIFF_FIT_WIDTH=1
   set OS_PROJECT_DOMAIN_NAME=<account_id>
   set OS_PROJECT_ID=<project_id>
   set OS_TENANT_ID=<project_id>
   set OS_TENANT_NAME=<project_name>
   set OS_REGION_NAME=<pool>
   set OS_USER_DOMAIN_NAME=<account_id>
   set OS_USERNAME=<user_name>
   set OS_PASSWORD=<user_password>

   Укажите:

   • <account_id> — номер аккаунта. Можно посмотреть в панели управления в правом верхнем углу;
   • <project_id> — ID проекта. Можно скопировать в панели управления: в верхнем меню нажмите Продукты и выберите Облачные серверы → откройте меню проектов (название текущего проекта) → в строке проекта нажмите;
   • <project_name> — имя проекта. Можно посмотреть в панели управления: в верхнем меню нажмите Продукты и выберите Облачные серверы → откройте меню проектов (название текущего проекта) → скопируйте имя проекта;
   • <pool> — пул, например ru-2. Управлять инфраструктурой проекта можно будет только в этом пуле;
   • <user_name> — имя сервисного пользователя, которого вы добавили на этапе 2;
   • <user_password> — пароль сервисного пользователя. После создания пользователя посмотреть пароль нельзя — можно только сгенерировать новый. Подробнее в подразделе Изменить пароль сервисного пользователя инструкции Изменить данные и роль пользователя.

3. Убедитесь, что OpenStack CLI работает. Для этого откройте список облачных серверов:

   openstack server list

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

Настроить OpenStack CLI в Docker-контейнере

1. Установите Docker.

2. Добавьте сервисного пользователя.

3. Скачайте RC-файл для авторизации в OpenStack API.

4. Установите OpenStack CLI в Docker-контейнере.

1. Установить Docker

Для установки Docker на локальный компьютер используйте инструкцию Установить Docker официальной документации Docker.

2. Добавить сервисного пользователя

Для управления ресурсами проекта через OpenStack API добавьте сервисного пользователя с разрешением в области доступа Проекты и ролью:

• member;
• или reader.

Добавлять пользователей может Владелец аккаунта или пользователи с ролью iam_admin.

3. Скачать RC-файл

к сведению

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

1. В панели управления в верхнем меню нажмите Аккаунт.

2. Перейдите в раздел Сервисные пользователи.

3. Откройте страницу сервисного пользователя, которого вы добавили на этапе 2 → вкладка Доступ.

4. В блоке RC-файлы:

   4.1. Выберите проект.

   4.2. Выберите регион.

   4.3. Выберите пул.

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

4. Установить OpenStack CLI в Docker-контейнере

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

2. Создайте директорию для работы с Docker:

   mkdir <docker_directory>

   Укажите <docker_directory> — имя директории, в которую будет добавлен RC-файл и создан Dockerfile.

3. Переместите RC-файл в директорию:

   mv <rcfile_name> <docker_directory>

   Укажите:

   • <rcfile_name> — имя RC-файла, который вы скачали на этапе 3. По умолчанию rc.sh;
   • <docker_directory> — имя директории, в которую будет добавлен RC-файл и создан Dockerfile.

4. Создайте в этой директории пустой Dockerfile с помощью текстового редактора nano:

   nano Dockerfile

5. Добавьте в Dockerfile команды для установки OpenStack CLI:

   FROM alpine:3.17
   
   RUN apk add --update --no-cache python3 python3-dev libffi libffi-dev \
       git openssl openssl-dev cargo build-base iputils curl linux-headers \
       py3-pip py3-cffi py3-tz py3-pbr py3-setuptools && \
       pip3 install -UI git+https://github.com/openstack/python-openstackclient.git@stable/2024.2 \
                 git+https://github.com/openstack/python-glanceclient.git@stable/2024.2 \
                 git+https://github.com/openstack/python-octaviaclient.git@stable/2024.2 \
                 git+https://github.com/openstack/python-manilaclient.git@unmaintained/zed \
                 git+https://github.com/openstack/osc-lib.git@stable/2024.2 \
         && apk del build-base linux-headers python3-dev libffi-dev openssl-dev git cargo iputils curl && rm -rf /var/cache
   
   CMD ["sh"]

6. Выйдите из текстового редактора nano с сохранием изменений: нажмите Ctrl+Х, а затем Y+Enter.

7. Соберите Docker-контейнер:

   docker build -t osc:dalmatian .

8. Запустите Docker-контейнер:

   docker run -ti --rm -v $(pwd):/workspace osc:dalmatian

9. Перейдите в директорию workspace:

   cd /workspace

10. Примените переменные окружения из RC-файла:

    source <rcfile_name>

    Укажите <rcfile_name> — имя RC-файла, который вы скачали на этапе 3. По умолчанию rc.sh.

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

12. Убедитесь, что OpenStack CLI работает. Для этого откройте список облачных серверов:

openstack server list

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