7397326a39
We have had multiple issues on why web terminals are not working on GitLab.com, there is current work in progress to make it stable and work in https://gitlab.com/gitlab-org/gitlab-ce/issues/52611
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
# Getting started with interactive web terminals **[CORE ONLY]**
|
|
|
|
> [Introduced](https://gitlab.com/gitlab-org/gitlab-ce/issues/50144) in GitLab 11.3.
|
|
|
|
Interactive web terminals give the user access to a terminal in GitLab for
|
|
running one-off commands for their CI pipeline.
|
|
|
|
NOTE: **Note:**
|
|
GitLab.com does not support interactive web terminal at the moment. Please
|
|
follow [this issue](https://gitlab.com/gitlab-org/gitlab-ce/issues/52611) for
|
|
progress.
|
|
|
|
## 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]
|
|
- If you are using a reverse proxy with your GitLab instance, 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).
|
|
|
|
NOTE: **Note:** The `docker` executor does not keep running
|
|
after the build script is finished. At that point, the terminal will automatically
|
|
disconnect and will not wait for the user to finish. Please follow [this
|
|
issue](https://gitlab.com/gitlab-org/gitlab-runner/issues/3605) for updates on
|
|
improving this behavior.
|
|
|
|
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 `debug` that will open the terminal
|
|
for the current job.
|
|
|
|
|
|
|
|
When clicked, a new tab will open to the terminal page where you can access
|
|
the terminal and type commands like a normal shell.
|
|
|
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
[session-server]: https://docs.gitlab.com/runner/configuration/advanced-configuration.html#the-session_server-section
|