tatnet 0.13.0 → 0.15.0

package/README.md

@@ -8,6 +8,10 @@
 виртуальные машины, приложения, базы Postgres и Valkey, DNS, объектное
 хранилище, SSH-ключи, VPC, NAT и плавающие IP.
 
+`tatnet app update <приложение> --branch main` меняет Git-ветку будущих
+сборок и автодеплоя. Требуется `app:update`. Чтобы выкатить выбранную ветку,
+отдельно выполните `tatnet app deploy <приложение>`.
+
 Managed Kafka: `tatnet kafka regions` показывает почасовые ставки и процент
 управления; `tatnet --project <id> kafka get <cluster-id>` — стоимость часа,
 управление и прогноз за 730 часов. Оплата: VM + 30% за управление, IPv4 и
@@ -125,6 +129,8 @@ tatnet profile set-project прод    # проект по умолчанию
 
 ```bash
 tatnet vm list
+tatnet vm plans --cluster <region-uuid> -o json  # UUID тарифов, CPU, память в МиБ, цены в рублях
+tatnet vm plans --role k8s                     # тарифы для узлов Kubernetes
 tatnet vm get web-1                       # по имени или hostname, не только по id
 tatnet vm stop web-1
 tatnet vm backup create web-1 --name до-обновления
@@ -329,6 +335,7 @@ tatnet floating-ip attach public --interface <vm-interface-id>
 tatnet floating-ip detach public --yes
 tatnet floating-ip delete public --yes
 tatnet vpc nat disable private --yes
+tatnet vpc nat disable private --retain-ip --expected-floating-ip <id> --yes # сохранить ожидаемый IP за аккаунтом
 tatnet vpc delete private --yes
 ```
 
@@ -336,6 +343,10 @@ tatnet vpc delete private --yes
 указать UUID. Плавающий IP можно выбрать по UUID, имени или адресу.
 Эти ресурсы принадлежат аккаунту и не требуют `--project`.
 
+`nat disable --retain-ip` сохраняет адрес и его тарификацию. Перед повторным
+`nat enable --floating-ip <fip-id>` дождитесь статуса `available` у адреса
+через `tatnet floating-ip get <fip-id>`. Без флага адрес освобождается.
+
 ## Инференс
 
 `tatnet ai` обращается к общему API `https://ai.tatnet.cloud/v1`.
@@ -380,4 +391,37 @@ tatnet s3 connection-info --region spb-1
 закрытый для новых бакетов регион возвращает ошибку; размещение существующего
 бакета не меняется.
 
-При создании ВМ можно сразу включить ежедневные бэкапы: `tatnet vm create ... --auto-backups --backup-hour-utc 3 --backup-retention-days 14`. Настройки сохраняются вместе с ВМ; хранение оплачивается отдельно по фактическому объёму после сжатия.
+### Бэкапы ВМ
+
+При создании ВМ можно сразу включить ежедневные бэкапы: `tatnet vm create ... --auto-backups --backup-hour-utc 3 --backup-retention-days 14`.
+Для существующей ВМ: `tatnet vm backup policy VM_UUID --enabled --hour-utc 3 --retention-days 14`.
+Время задаётся в UTC, срок хранения — 1–365 дней.
+Хранение стоит 6 ₽/ГБ в месяц (730 часов) за фактический объём после сжатия,
+отдельно от подписки ВМ. Слоты больше не используются; `--backup-count` удалён.
+Отключение расписания (`--enabled=false`) сохраняет копии и оплату их хранения.
+Ручные копии не истекают автоматически. Перед удалением ВМ удалите её копии;
+старые блокировки и зависимости инкрементальных цепочек сохраняются.
+[Полная инструкция](https://docs.tatnet.ru/docs/infrastructure/vm-backups).
+
+## Несколько VPC на ВМ
+
+Каждая VPC подключается отдельным сетевым интерфейсом в том же аккаунте и регионе.
+Перед изменением интерфейсов ВМ нужно выключить; настройки применяются при запуске.
+Основной интерфейс и маршрут по умолчанию защищены от отключения.
+
+```sh
+tatnet vm interface attach <vm> --vpc <vpc-id>
+tatnet vm interface detach <vm> <interface-id>
+```
+При создании повторяйте `--interface type=vpc,vpc_id=<id>` для каждой VPC.
+
+### Реплики PostgreSQL
+
+`tatnet pg read-replicas <кластер> --count 1` добавляет выделенную оплачиваемую
+асинхронную реплику; `--count 0` удаляет реплики. HA настраивается отдельно.
+Проверяйте `read_replicas_pending`, `read_host`, `read_port` и лаг узлов через
+`tatnet pg get <кластер> -o json`. При создании доступен `--read-replicas`.
+
+Обновлённый контракт также предоставляет управление подпиской ВМ:
+`tatnet vm subscription get <ВМ>` и `tatnet vm subscription update <ВМ>
+--period-type 1m --auto-renew=false`. Период календарного месяца — `1m`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tatnet",
-  "version": "0.13.0",
+  "version": "0.15.0",
   "description": "Консольный клиент облака TatNet (tatnet.ru)",
   "keywords": [
     "tatnet",
@@ -29,12 +29,12 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "@tatnet/cli-darwin-arm64": "0.13.0",
-    "@tatnet/cli-darwin-x64": "0.13.0",
-    "@tatnet/cli-linux-arm64": "0.13.0",
-    "@tatnet/cli-linux-x64": "0.13.0",
-    "@tatnet/cli-win32-arm64": "0.13.0",
-    "@tatnet/cli-win32-x64": "0.13.0"
+    "@tatnet/cli-darwin-arm64": "0.15.0",
+    "@tatnet/cli-darwin-x64": "0.15.0",
+    "@tatnet/cli-linux-arm64": "0.15.0",
+    "@tatnet/cli-linux-x64": "0.15.0",
+    "@tatnet/cli-win32-arm64": "0.15.0",
+    "@tatnet/cli-win32-x64": "0.15.0"
   },
   "license": "Apache-2.0"
 }