tatnet 0.1.3 → 0.1.5

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 +49 -8
  2. package/package.json +9 -9
package/README.md CHANGED
@@ -1,7 +1,12 @@
1
1
  # tatnet — консольный клиент TatNet
2
2
 
3
- `tatnet` управляет облаком TatNet из терминала: виртуальные машины,
4
- приложения, базы Postgres и Valkey, DNS, объектное хранилище, SSH-ключи.
3
+ [tatnet.ru](https://tatnet.ru) · [панель](https://min.tatnet.ru) ·
4
+ [документация](https://docs.tatnet.ru) ·
5
+ [справочник API](https://api.tatnet.ru/v1/docs)
6
+
7
+ `tatnet` управляет облаком [TatNet](https://tatnet.ru) из терминала:
8
+ виртуальные машины, приложения, базы Postgres и Valkey, DNS, объектное
9
+ хранилище, SSH-ключи.
5
10
 
6
11
  Построен поверх [tatnet-go](https://github.com/tatnet-ru/tatnet-go) —
7
12
  клиента, генерируемого из контракта `/v1`. Рукописного HTTP здесь нет, и
@@ -22,15 +27,37 @@ npm i -g tatnet
22
27
  ```
23
28
 
24
29
  Бинарник качается не при установке, а приезжает готовым подпакетом на вашу
25
- платформу (`optionalDependencies` с полями `os`/`cpu`), поэтому работает и
26
- под `--ignore-scripts`, и из офлайн-кэша. Поддержаны linux, macOS и Windows
27
- на x64 и arm64.
30
+ платформу (`@tatnet/cli-<os>-<arch>` в `optionalDependencies` с полями
31
+ `os`/`cpu`), поэтому работает и под `--ignore-scripts`, и из офлайн-кэша.
32
+ Поддержаны linux, macOS и Windows на x64 и arm64.
33
+
34
+ ### Что именно вы ставите
35
+
36
+ В пакете лежит скомпилированный бинарник — как у `esbuild`, `swc`, `biome`
37
+ и `turbo`. Проверить, что в нём, можно не на слово:
38
+
39
+ ```bash
40
+ npm audit signatures # подпись и происхождение пакета
41
+ npm view tatnet dist.integrity # хеш тарболла в реестре
42
+ ```
43
+
44
+ Пакеты публикуются с **provenance-аттестацией**: npm подписывает связь
45
+ «этот тарболл собран вот этим прогоном GitHub Actions из вот этого коммита
46
+ публичного репозитория», и на странице пакета видно, каким именно. Сам
47
+ бинарник при этом не собирается на месте публикации — он берётся из
48
+ [релиза](https://github.com/tatnet-ru/tatnet-cli/releases) со сверкой
49
+ `checksums.txt`, а релиз собирает goreleaser в открытом прогоне.
50
+
51
+ Цепочка целиком проверяема снаружи: коммит → прогон сборки → артефакт
52
+ релиза с контрольной суммой → тот же файл в пакете npm. Ничего не
53
+ скачивается при установке и ничего не выполняется в `postinstall` — его
54
+ здесь нет вовсе.
28
55
 
29
56
  Бинарником с [релизов](https://github.com/tatnet-ru/tatnet-cli/releases)
30
57
  (файлы несут номер версии, подставьте свою):
31
58
 
32
59
  ```bash
33
- VER=0.1.3
60
+ VER=0.1.5
34
61
  curl -sSL "https://github.com/tatnet-ru/tatnet-cli/releases/download/v$VER/tatnet_${VER}_linux_amd64.tar.gz" | tar xz
35
62
  sudo install tatnet /usr/local/bin/
36
63
  ```
@@ -46,8 +73,9 @@ go install github.com/tatnet-ru/tatnet-cli/cmd/tatnet@latest
46
73
 
47
74
  ## Начало работы
48
75
 
49
- Ключ создаётся в панели: **Аккаунт → API-ключи**. Ключ принадлежит одному
50
- аккаунту и несёт свою политику прав, поэтому аккаунт нигде не указывается.
76
+ Ключ создаётся в панели: **[min.tatnet.ru/api-keys](https://min.tatnet.ru/api-keys)**.
77
+ Ключ принадлежит одному аккаунту и несёт свою политику прав, поэтому аккаунт
78
+ нигде не указывается.
51
79
 
52
80
  ```bash
53
81
  tatnet auth login # спросит ключ, проверит его и сохранит
@@ -167,3 +195,16 @@ go build ./...
167
195
  go test ./...
168
196
  go run ./cmd/tatnet --help
169
197
  ```
198
+
199
+ ## Ссылки
200
+
201
+ | | |
202
+ |---|---|
203
+ | Облако TatNet | [tatnet.ru](https://tatnet.ru) |
204
+ | Панель управления | [min.tatnet.ru](https://min.tatnet.ru) |
205
+ | Ключи доступа | [min.tatnet.ru/api-keys](https://min.tatnet.ru/api-keys) |
206
+ | Документация платформы | [docs.tatnet.ru](https://docs.tatnet.ru) |
207
+ | Справочник `/v1` | [api.tatnet.ru/v1/docs](https://api.tatnet.ru/v1/docs) |
208
+ | Контракт OpenAPI | [api.tatnet.ru/v1/openapi.json](https://api.tatnet.ru/v1/openapi.json) |
209
+ | Go-клиент того же API | [tatnet-ru/tatnet-go](https://github.com/tatnet-ru/tatnet-go) |
210
+ | Пакет в npm | [npmjs.com/package/tatnet](https://www.npmjs.com/package/tatnet) |
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "tatnet",
3
- "version": "0.1.3",
4
- "description": "Консольный клиент публичного API TatNet",
3
+ "version": "0.1.5",
4
+ "description": "Консольный клиент облака TatNet (tatnet.ru)",
5
5
  "keywords": [
6
6
  "tatnet",
7
7
  "cli",
@@ -11,7 +11,7 @@
11
11
  "dns",
12
12
  "s3"
13
13
  ],
14
- "homepage": "https://github.com/tatnet-ru/tatnet-cli#readme",
14
+ "homepage": "https://tatnet.ru",
15
15
  "bugs": "https://github.com/tatnet-ru/tatnet-cli/issues",
16
16
  "repository": {
17
17
  "type": "git",
@@ -28,11 +28,11 @@
28
28
  "node": ">=18"
29
29
  },
30
30
  "optionalDependencies": {
31
- "@tatnet/cli-darwin-arm64": "0.1.3",
32
- "@tatnet/cli-darwin-x64": "0.1.3",
33
- "@tatnet/cli-linux-arm64": "0.1.3",
34
- "@tatnet/cli-linux-x64": "0.1.3",
35
- "@tatnet/cli-win32-arm64": "0.1.3",
36
- "@tatnet/cli-win32-x64": "0.1.3"
31
+ "@tatnet/cli-darwin-arm64": "0.1.5",
32
+ "@tatnet/cli-darwin-x64": "0.1.5",
33
+ "@tatnet/cli-linux-arm64": "0.1.5",
34
+ "@tatnet/cli-linux-x64": "0.1.5",
35
+ "@tatnet/cli-win32-arm64": "0.1.5",
36
+ "@tatnet/cli-win32-x64": "0.1.5"
37
37
  }
38
38
  }