Перейти к содержимому

Быстрый старт

Пройдя шаги быстрого старта, вы:

  1. Установите MWS CLI.
  2. Создадите и инициализируете профиль.
  3. Выполните тестовый запрос.

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

Заголовок раздела «1. Установите MWS CLI»
  • Linux, MacOS
  • Windows

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

    bash
    curl -sSL https://storage.mwsapis.ru/mws-cli/install.sh | bash

  2. Убедитесь, что путь к исполняемому файлу MWS CLI добавлен в PATH. Если PATH не содержит пути к MWS CLI, добавьте его самостоятельно:

    • Для Linux: /home/<имя пользователя>/.local/bin;
    • Для MacOS: /Users/<имя пользователя>/.local/bin.

  3. (если используется fish) Подключите автодополнение команд:

    bash
    mws completion fish

  4. Перезапустите терминал.

  5. Проверьте работу MWS CLI:

    bash
    mws version

    При успешной установке отобразится текущая версия MWS CLI.

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

Заголовок раздела «2. Создайте первый профиль»

Аутентификация в MWS CLI будет выполнена от имени пользователя.

Во время аутентификации MWS CLI предложит автоматически открыть страницу веб-консоли в браузере и авторизоваться. Также страницу можно открыть вручную, если нужно авторизоваться с другого устройства (например, если вы работаете с ВМ, где нельзя открыть браузер).

  • Автоматически из MWS CLI
  • Вручную на другом устройстве

  1. Инициализируйте профиль default:

    bash
    mws init --project <имя проекта>

    Здесь <имя проекта> — это проект, в котором должны выполняться команды MWS CLI.


    В результате выполнения команды сгенерируется ссылка, которая откроется в вашем браузере по умолчанию.

  2. В открывшемся окне браузера введите учетные данные и войдите в веб-консоль.

  3. После аутентификации в браузере вернитесь в окно терминала. Если инициализация выполнена успешно, в терминале появится сообщение:

    bash
    Profile "default" successfully initialized at "/Users/<имя пользователя>/.mws/config/default.yaml"

  4. Закройте окно браузера.

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

Заголовок раздела «3. Выполните тестовый запрос»

Чтобы проверить работу MWS CLI, запросите список типов ВМ:

bash
mws compute vm-type list

Ожидаемый результат:

bash
+--------------------+-------------+--------+-------------+
|       ID           | DESCRIPTION | STATUS | UPDATE TIME |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-16-128 |             | OK     |             |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-16-32  |             | OK     |             |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-16-64  |             | OK     |             |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-2-16   |             | OK     |             |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-2-4    |             | OK     |             |
+--------------------+-------------+--------+-------------+
| vmTypes/gen-2-8    |             | OK     |             |
+--------------------+-------------+--------+-------------+