From 985b051569ed6a1fb355af6b9c5922612f603bed Mon Sep 17 00:00:00 2001
From: Axel Navarro <navarroaxel@gmail.com>
Date: Fri, 16 Apr 2021 12:28:05 -0300
Subject: [PATCH] gh-run: add page (#5766)

---
 pages/common/gh-run.md | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 pages/common/gh-run.md

diff --git a/pages/common/gh-run.md b/pages/common/gh-run.md
new file mode 100644
index 000000000..c6c7d2d65
--- /dev/null
+++ b/pages/common/gh-run.md
@@ -0,0 +1,36 @@
+# gh run
+
+> View, run and watch recent GitHub Actions workflow runs.
+> More information: <https://cli.github.com/manual/gh_run>.
+
+- Interactively select a run to see information about the jobs:
+
+`gh run view`
+
+- Display information about a specific run:
+
+`gh run view {{workflow_run_number}}`
+
+- Display information about the steps of a job:
+
+`gh run view --job={{job_number}}`
+
+- Display the log of a job:
+
+`gh run view --job={{job_number}} --log`
+
+- Check a specific workflow and exit with a non-zero status if the run failed:
+
+`gh run view {{workflow_run_number}} --exit-status && {{echo "run pending or passed"}}`
+
+- Interactively select an active run and wait until it's done:
+
+`gh run watch`
+
+- Display the jobs for a run and wait until it's done:
+
+`gh run watch {{workflow_run_number}}`
+
+- Re-run a specific workflow:
+
+`gh run rerun {{workflow_run_number}}`