Установка и начало работы

twc — утилита командной строки для управления сервисами Timeweb Cloud. Ниже рассмотрим, как установить twc и приступить к работе.

Актуальная документация по работе с twc, сценарии использования утилиты, способы конфигурации и некоторые полезные приемы доступны на GitHub.

Установка

Установить twc можно следующими способами.

Установка с помощью pip (рекомендованный способ)

1. Убедитесь, что на компьютер установлены Python не ниже версии 3.8 и пакетный менеджер pip (см. инструкцию).
2. Установите пакет twc-cli с помощью pip командой:

pip install twc-cli

Установка из файла .tar.gz

1. Убедитесь, что на компьютер установлены Python не ниже версии 3.8 и пакетный менеджер pip (см. инструкцию).
2. Скачайте пакет twc-cli в формате .tar.gz со страницы загрузок.
3. Перейдите в терминале в директорию, где расположен файл .tar.gz, и установите его с помощью pip:

pip install ./twc_cli-1.0.0.tar.gz

Обновление

Рекомендуем регулярно обновлять twc. Команда для обновления:

pip install -U twc-cli

Начало работы

1. Прежде всего нужно получить токен доступа в панели управления Timeweb Cloud. Перейдите в раздел «Токены API» и выпустите новый токен с любым сроком действия.
2. Откройте терминал и запустите команду:

twc config

3. Введите токен и нажмите Enter. twc сохранит на вашем компьютере конфигурационный файл с токеном.

На этом настройка утилиты завершена, вы можете начать управлять сервисами.

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

twc --help

twc имеет множество субкоманд с различной степенью вложенности. Опция --help доступна на каждом уровне вложенности для всех субкоманд. Например, так можно последовательно прочитать справку по командам для управления облачными серверами:

twc server --help

twc server create --help

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