azure-pipelines-tui 0.5.1 → 0.5.2
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/README.md +54 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,6 +1,10 @@
|
|
|
1
1
|
# Azure Pipelines TUI
|
|
2
2
|
|
|
3
|
-
A terminal UI for
|
|
3
|
+
A terminal UI for Azure DevOps pipelines. Two standout features:
|
|
4
|
+
|
|
5
|
+
### Live pipeline run viewer
|
|
6
|
+
|
|
7
|
+
Follow a running or completed pipeline build in real time. A stage/job tree on the left streams log output on the right via SignalR — no browser required.
|
|
4
8
|
|
|
5
9
|
```
|
|
6
10
|
┌ Pipeline ──────────────┐┌ Logs — Initialize job ───────────────────────────────┐
|
|
@@ -12,6 +16,24 @@ A terminal UI for live-following Azure DevOps pipeline runs, with streaming logs
|
|
|
12
16
|
└────────────────────────┘└──────────────────────────────────────────────────────┘
|
|
13
17
|
```
|
|
14
18
|
|
|
19
|
+
### Stages dashboard for GitOps
|
|
20
|
+
|
|
21
|
+
Per-branch overview of Plan/Apply stage pairs across recent runs. Shows the current deployment state for every branch at a glance — and when a run failed, also shows the last successful result alongside it.
|
|
22
|
+
|
|
23
|
+
```
|
|
24
|
+
Stage / Branch Plan Apply
|
|
25
|
+
┌ Stages: Deploy-to-prod (48 runs) ────────────────────────────────────────────┐
|
|
26
|
+
│ Deploy │
|
|
27
|
+
│ main ✓ 5m ✓ 2h │
|
|
28
|
+
│ feature/PLAT-123 ✗ 30m (✓2d) - │
|
|
29
|
+
│ release/v1.2 ✓ 1h ✓ 3h │
|
|
30
|
+
│ │
|
|
31
|
+
│ Infra │
|
|
32
|
+
│ main ✓ 1h ✗ 3h (✓1d) │
|
|
33
|
+
│ feature/PLAT-456 ○ wait - │
|
|
34
|
+
└───────────────────────────────────────────────────────────────────────────────┘
|
|
35
|
+
```
|
|
36
|
+
|
|
15
37
|
## Requirements
|
|
16
38
|
|
|
17
39
|
- Node.js 18+
|
|
@@ -40,6 +62,37 @@ npx azure-pipelines-tui <build-url> # Single pipeline run (ful
|
|
|
40
62
|
| `r` | Retry/restart selected stage |
|
|
41
63
|
| `q` `Ctrl+C` | Quit |
|
|
42
64
|
|
|
65
|
+
## Stages dashboard
|
|
66
|
+
|
|
67
|
+
Status icons:
|
|
68
|
+
|
|
69
|
+
| Icon | Meaning |
|
|
70
|
+
|------|---------|
|
|
71
|
+
| `✓ 5m` | Succeeded, finished 5 minutes ago |
|
|
72
|
+
| `✗ 30m (✓2d)` | Failed, last success was 2 days ago |
|
|
73
|
+
| `▶ –` | In progress |
|
|
74
|
+
| `⚠ 5m` | Succeeded with warnings |
|
|
75
|
+
| `⊘ –` | Skipped / canceled, no prior run |
|
|
76
|
+
| `○ –` | Pending |
|
|
77
|
+
| `-` | Stage did not run |
|
|
78
|
+
|
|
79
|
+
The `*` suffix (e.g. `✓ 2d *`) means the most recent run was skipped or canceled — the cell shows the last active run instead.
|
|
80
|
+
|
|
81
|
+
### Key bindings
|
|
82
|
+
|
|
83
|
+
| Key | Action |
|
|
84
|
+
|-----|--------|
|
|
85
|
+
| `↑` `↓` | Navigate rows |
|
|
86
|
+
| `Enter` | Open the run in the browser |
|
|
87
|
+
| `r` | Refresh data |
|
|
88
|
+
| `b` | Open pipeline summary in browser |
|
|
89
|
+
| `p` | Go to pipelines list |
|
|
90
|
+
| `e` | Go to environments overview |
|
|
91
|
+
| `Esc` | Back |
|
|
92
|
+
| `q` | Quit |
|
|
93
|
+
|
|
94
|
+
See [docs/stages-dashboard-design.md](docs/stages-dashboard-design.md) for the full design.
|
|
95
|
+
|
|
43
96
|
## How to run locally
|
|
44
97
|
|
|
45
98
|
```bash
|