tatnet 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +50 -5
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -6,7 +6,7 @@
6
6
 
7
7
  `tatnet` управляет облаком [TatNet](https://tatnet.ru) из терминала:
8
8
  виртуальные машины, приложения, базы Postgres и Valkey, DNS, объектное
9
- хранилище, SSH-ключи.
9
+ хранилище, SSH-ключи, VPC, NAT и плавающие IP.
10
10
 
11
11
  Построен поверх [tatnet-go](https://github.com/tatnet-ru/tatnet-go) —
12
12
  клиента, генерируемого из контракта `/v1`. Рукописного HTTP здесь нет, и
@@ -106,7 +106,7 @@ tatnet vm get web-1 # по имени или hostname, н
106
106
  tatnet vm stop web-1
107
107
  tatnet vm backup create web-1 --name до-обновления
108
108
 
109
- tatnet app list # все приложения аккаунта, без -p
109
+ tatnet app list --all-projects # все доступные проекты аккаунта
110
110
  tatnet app get магазин # проект не нужен — узнаётся из приложения
111
111
  tatnet app deploy магазин
112
112
  tatnet app env set магазин DATABASE_URL 'postgres://…' --secret
@@ -206,9 +206,8 @@ tatnet --profile стенд vm list
206
206
 
207
207
  ## `tatnet api` — всё остальное
208
208
 
209
- Своими командами выведены 91 операция из 161. Остальные — балансировщики,
210
- сети, Kubernetes, функции, тома, домены, сертификаты — доступны прямым
211
- вызовом:
209
+ Для разделов без отдельных команд — балансировщиков, Kubernetes,
210
+ функций, томов, доменов и сертификатов — доступен прямой вызов API:
212
211
 
213
212
  ```bash
214
213
  tatnet api --list load-balancers # что вообще есть
@@ -267,3 +266,49 @@ go run ./cmd/tatnet --help
267
266
  ## Лицензия
268
267
 
269
268
  [Apache-2.0](LICENSE).
269
+
270
+ ## Поиск приложений и проверка выката
271
+
272
+ `app list` использует проект из `--project`, `$TATNET_PROJECT` или профиля.
273
+ В табличном выводе CLI показывает этот охват и его источник в stderr.
274
+ `--all-projects` игнорирует проект профиля и окружения и перечисляет все
275
+ проекты, доступные ключу; одновременно задавать `--project` нельзя.
276
+ Фильтры сопоставляют точные значения, `--limit` ограничивает число совпадений.
277
+
278
+ ```bash
279
+ tatnet app list --all-projects --repo manzhikov/tatnet-frontend --branch main
280
+ tatnet app list --all-projects --domain min.tatnet.ru
281
+ tatnet app deploy web --commit <полный-SHA> --wait --logs
282
+ tatnet app wait web --commit <полный-SHA> --deadline 30m
283
+ tatnet app wait web --build <build-id>
284
+ ```
285
+
286
+ Ожидание закрепляет конкретную сборку и подтверждает `status=success` вместе
287
+ с `deploy_state=live`. Сборка другого коммита не удовлетворяет ожидание.
288
+ Ошибки сборки/запуска и истечение срока дают ненулевой код выхода; при
289
+ ошибке CLI пытается прочитать лог. `--logs` включает ожидание в `app deploy`.
290
+ `tatnet deploy` из папки также ждёт `live`; `--no-wait` только ставит сборку
291
+ в очередь. Строки логов и сведения об охвате идут в stderr, JSON остаётся
292
+ пригодным для обработки скриптами.
293
+
294
+ ## Сети аккаунта
295
+
296
+ ```bash
297
+ tatnet vpc list --cluster <region-id>
298
+ tatnet vpc create --name private --cluster <region-id> --subnet 10.20.0.0/24
299
+ tatnet vpc get private
300
+ tatnet vpc nat enable private # выделяет новый публичный IP
301
+ tatnet vpc nat enable private --floating-ip <fip-id>
302
+ tatnet vpc reserved-ip create private --name fixed --address 10.20.0.5 --mac 02:00:00:00:00:01
303
+ tatnet vpc reserved-ip delete private <reservation-id> --yes
304
+ tatnet floating-ip create --cluster <region-id> --name public
305
+ tatnet floating-ip attach public --interface <vm-interface-id>
306
+ tatnet floating-ip detach public --yes
307
+ tatnet floating-ip delete public --yes
308
+ tatnet vpc nat disable private --yes
309
+ tatnet vpc delete private --yes
310
+ ```
311
+
312
+ Сеть выбирается по UUID или точному имени; при одинаковых именах нужно
313
+ указать UUID. Плавающий IP можно выбрать по UUID, имени или адресу.
314
+ Эти ресурсы принадлежат аккаунту и не требуют `--project`.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "tatnet",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Консольный клиент облака TatNet (tatnet.ru)",
5
5
  "keywords": [
6
6
  "tatnet",
@@ -29,12 +29,12 @@
29
29
  "node": ">=18"
30
30
  },
31
31
  "optionalDependencies": {
32
- "@tatnet/cli-darwin-arm64": "0.6.0",
33
- "@tatnet/cli-darwin-x64": "0.6.0",
34
- "@tatnet/cli-linux-arm64": "0.6.0",
35
- "@tatnet/cli-linux-x64": "0.6.0",
36
- "@tatnet/cli-win32-arm64": "0.6.0",
37
- "@tatnet/cli-win32-x64": "0.6.0"
32
+ "@tatnet/cli-darwin-arm64": "0.7.0",
33
+ "@tatnet/cli-darwin-x64": "0.7.0",
34
+ "@tatnet/cli-linux-arm64": "0.7.0",
35
+ "@tatnet/cli-linux-x64": "0.7.0",
36
+ "@tatnet/cli-win32-arm64": "0.7.0",
37
+ "@tatnet/cli-win32-x64": "0.7.0"
38
38
  },
39
39
  "license": "Apache-2.0"
40
40
  }