diff options
author | Steve Azzopardi <steveazz@outlook.com> | 2018-07-19 17:49:32 +0300 |
---|---|---|
committer | Steve Azzopardi <steveazz@outlook.com> | 2018-08-16 14:50:38 +0300 |
commit | b7fa2e0beb51ba2f489c67fbcabaff4169816305 (patch) | |
tree | c3fa2f34139b1a822f0924af222a4230f3f16f40 /doc/ci/interactive_web_terminal | |
parent | ce18246c24040444646884a6a13e472ae83f74ee (diff) |
Add documentation for interactive web terminals
Create a new page for the interactive web terminals since it doesn't fit in any
other place.
Add link in CI home page.
Diffstat (limited to 'doc/ci/interactive_web_terminal')
-rw-r--r-- | doc/ci/interactive_web_terminal/img/finished_job_with_terminal_open.png | bin | 0 -> 40247 bytes | |||
-rw-r--r-- | doc/ci/interactive_web_terminal/img/interactive_web_terminal_page.png | bin | 0 -> 23431 bytes | |||
-rw-r--r-- | doc/ci/interactive_web_terminal/img/interactive_web_terminal_running_job.png | bin | 0 -> 26692 bytes | |||
-rw-r--r-- | doc/ci/interactive_web_terminal/index.md | 48 |
4 files changed, 48 insertions, 0 deletions
diff --git a/doc/ci/interactive_web_terminal/img/finished_job_with_terminal_open.png b/doc/ci/interactive_web_terminal/img/finished_job_with_terminal_open.png Binary files differnew file mode 100644 index 00000000000..80be16301e8 --- /dev/null +++ b/doc/ci/interactive_web_terminal/img/finished_job_with_terminal_open.png diff --git a/doc/ci/interactive_web_terminal/img/interactive_web_terminal_page.png b/doc/ci/interactive_web_terminal/img/interactive_web_terminal_page.png Binary files differnew file mode 100644 index 00000000000..b59c1b6bc43 --- /dev/null +++ b/doc/ci/interactive_web_terminal/img/interactive_web_terminal_page.png diff --git a/doc/ci/interactive_web_terminal/img/interactive_web_terminal_running_job.png b/doc/ci/interactive_web_terminal/img/interactive_web_terminal_running_job.png Binary files differnew file mode 100644 index 00000000000..cc60ecdfdc9 --- /dev/null +++ b/doc/ci/interactive_web_terminal/img/interactive_web_terminal_running_job.png diff --git a/doc/ci/interactive_web_terminal/index.md b/doc/ci/interactive_web_terminal/index.md new file mode 100644 index 00000000000..2b4048599da --- /dev/null +++ b/doc/ci/interactive_web_terminal/index.md @@ -0,0 +1,48 @@ +# Getting started with interactive web terminals + +> Introduced in GitLab 11.2. + +Interactive web terminals give the user access to a terminal in GitLab for +running one-of commands for their CI pipeline. + +NOTE: **Note:** +This is not available for the shared Runners on GitLab.com. +To make use of this feature, you need to provide your +[own Runner](https://docs.gitlab.com/runner/install/) and properly +[configure it](#configuration). + +## Configuration + +Two things need to be configured for the interactive web terminal to work: + +- The Runner needs to have [`[session_server]` configured + properly][session-server] +- Web terminals need to be + [enabled](../../administration/integration/terminal.md#enabling-and-disabling-terminal-support) + +## Debugging a running job + +NOTE: **Note:** Not all executors are +[supported](https://docs.gitlab.com/runner/executors/#compatibility-chart). + +Sometimes, when a job is running, things don't go as you would expect, and it +would be helpful if one can have a shell to aid debugging. When a job is +running, on the right panel you can see a button that will open the terminal +for the current job. + +![Example of job running with terminal +available](img/interactive_web_terminal_running_job.png) + +When clicked, you will be redirected to a new page where you can access the +terminal and type commands like a normal shell. + +![terminal of the job](img/interactive_web_terminal_page.png) + +If you have the terminal open and the job has finished with its tasks, the +terminal will block the job from finishing for the duration configured in +[`[session_server].terminal_max_retention_time`][session-server] until you +close the terminal window. + +![finished job with terminal open](img/finished_job_with_terminal_open.png) + +[session-server]: https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-session_server-section |