Timeweb Cloud CLI. Часть 1: S3
Салют! Не так давно компания Timeweb Cloud выпустила новую версию своего CLI (twc), который позволяет легко и удобно управлять всеми предоставляемыми ресурсами облачной платформы. В этой серии статей рассмотрим основные сценарии применения этого инструмента.
В данном материале речь пойдёт о работе с облачным объектным хранилищем S3 — это сервис для хранения любых данных в виде объектов, работа с которым осуществляется через программный интерфейс S3 API, в нём можно размещать любые типы статических данных.
Они будут храниться в одном месте и едином формате, и вы сможете в любой момент получать к ним доступ через API или графический интерфейс. Удобно размещать там, например, бэкапы, статические и медиа файлы, архивы, логи.
❯ Установка и настройка
Для установки twc (при наличии в системе python 3.7+ и пакетного менеджера pip) достаточно одной команды:
pip install twc-cli
Затем необходимо предоставить утилите доступ к нашему облаку, для этого требуется получить токен доступа в панели управления Timeweb Cloud, выпустить его можно в разделе «API и Terraform».
Далее откройте терминал и запустите команду:
twc config
Копируем токен и нажимаем Enter. Утилита сохранит на вашем компьютере конфигурационный файл с токеном, на этом её настройка завершена, можно начинать управлять сервисами.
❯ Начало работы
Прежде чем создать бакет, необходимо выбрать тариф, который определяет базовые параметры нашего хранилища: регион размещения, цену и доступный объём. Для этого мы можем получить список доступных пресетов (по умолчанию будет выбран минимальный тариф с 10 Гб диска):
twc s3 list-presets
ID REGION PRICE DISK
383 ru-1 639 250G
385 ru-1 1119 500G
387 ru-1 2079 1000G
389 ru-1 79 10G
471 ru-1 3999 2000G
473 ru-1 349 100G
Создать новый бакет:
twc s3 mb --preset-id 473 имя-бакета
По умолчанию создаётся приватный бакет, изменить его тип можно с помощью команды:
twc s3 set --type public имя-бакета
Кроме того к бакету можно привязать домен (если у него есть CNAME-запись s3.timeweb.com) и запросить SSL-сертификат Let’s Encrypt для него (продлеваться будет автоматически), на всё про всё потребуется две команды:
twc s3 subdomain add my-bucket.example.com имя-бакета
twc s3 subdomain gencert my-bucket.example.com
Подробнее про привязку доменов тут .
❯ Подготовка конфигурации для S3 клиента
twc не реализует методы S3 API, поэтому для работы с объектами внутри бакетов можно использовать готовые S3-клиенты такие как s3cmd или rclone, для конфигурации любого из них достаточно одной команды, например для rclone:
mkdir -p ~/.config/rclone
twc s3 genconfig --client rclone > ~/.config/rclone/rclone.conf
Наконец, всё готово, можно работать с бакетами по схеме twc, например для просмотра списка бакетов:
rclone ls twc:/
Или можно синхронизировать файлы между бакетом и локальной директорией:
rclone -P sync twc:<бакет> /root/test❯ Итого
В этой статье мы рассмотрели использование CLI интерфейса от Timeweb для управления S3 хранилищем. Стоит отметить, что twc позволяет легко создавать новые бакеты с помощью готовых пресетов, генерировать конфигурацию для S3 клиентов и даже автоматически продлевать SSL сертификаты для бакетов, всё это вкупе с простым и понятным синтаксисом значительно облегчает работу.
Новости, обзоры продуктов и конкурсы от команды Timeweb.Cloud — в нашем Telegram-канале ↩
