anbaric 1.58.2 → 1.59.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.
- package/docs/api/cli.md +11 -3
- package/package.json +5 -5
package/docs/api/cli.md
CHANGED
|
@@ -23,11 +23,19 @@ project — they walk up to the nearest `package.json`.
|
|
|
23
23
|
| --- | --- |
|
|
24
24
|
| `anbaric apps` | List deployed apps (name, status, port). |
|
|
25
25
|
| `anbaric app configure` | Create or update `.anbaric/app-config.json` (`name`, `internalPort`). |
|
|
26
|
-
| `anbaric app deploy` | Deploy the app and wait until it is live (prompts before replacing a running one). |
|
|
26
|
+
| `anbaric app deploy` | Deploy the app and wait until it is live (prompts before replacing a running one). A running version is drained first — see below. |
|
|
27
27
|
| `anbaric app update` | Deploy, replacing a running app **without** prompting. |
|
|
28
|
-
| `anbaric app status [name]` | Show deploy state, liveness, and recent logs. |
|
|
28
|
+
| `anbaric app status [name]` | Show deploy state (`building`, `draining`, `running`, `failed`, `stopped`), liveness, and recent logs. |
|
|
29
29
|
| `anbaric app tail [name]` | Stream the app's runtime logs. |
|
|
30
|
-
| `anbaric app tear-down [name]` | Stop and remove the app (prompts unless `--yes`). |
|
|
30
|
+
| `anbaric app tear-down [name]` | Stop and remove the app (prompts unless `--yes`). A running app is drained first. |
|
|
31
|
+
|
|
32
|
+
**Draining.** Replacing or removing an app never cuts a job off mid-step. The
|
|
33
|
+
running version is told to stop taking on new work — messages the platform
|
|
34
|
+
offers it are refused and wait for the new version — and given up to **five
|
|
35
|
+
minutes** to finish the steps it has in hand; `app deploy`, `app update` and
|
|
36
|
+
`app tear-down` show `draining (finishing n steps in flight)` while it does.
|
|
37
|
+
Only then is it stopped. A step still running at the deadline is stopped
|
|
38
|
+
regardless: once an app has taken a job on, what becomes of it is the app's.
|
|
31
39
|
|
|
32
40
|
The name is optional, because an `app` command is normally about the app you
|
|
33
41
|
are standing in: the CLI walks up from the working directory to the nearest
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "anbaric",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.59.0",
|
|
4
4
|
"description": "Everything needed to write an Anbaric app: state machines, jobs, document and secret stores, local in-memory implementations and the Anbaric Cloud clients",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -24,9 +24,9 @@
|
|
|
24
24
|
"prepublishOnly": "npm run build"
|
|
25
25
|
},
|
|
26
26
|
"dependencies": {
|
|
27
|
-
"anbaric-impl-cloud": "^1.
|
|
28
|
-
"anbaric-data-store": "^1.
|
|
29
|
-
"anbaric-state-machine": "^1.
|
|
30
|
-
"anbaric-tsapi": "^1.
|
|
27
|
+
"anbaric-impl-cloud": "^1.59.0",
|
|
28
|
+
"anbaric-data-store": "^1.59.0",
|
|
29
|
+
"anbaric-state-machine": "^1.59.0",
|
|
30
|
+
"anbaric-tsapi": "^1.59.0"
|
|
31
31
|
}
|
|
32
32
|
}
|