대화형 웹 터미널
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
대화형 웹 터미널은 CI 파이프라인에 대한 일회성 명령을 실행하기 위해 GitLab의 터미널에 대한 접근을 사용자에게 제공합니다. GitLab.com의 인스턴스 runner는 대화형 웹 터미널을 제공하지 않습니다. 대화형 웹 터미널이 작동하려면 두 가지를 구성해야 합니다:
대화형 웹 터미널은 CI 파이프라인에 대한 일회성 명령을 실행하기 위해 GitLab의 터미널에 대한 접근을 사용자에게 제공합니다. SSH를 사용한 디버깅 방법으로 생각할 수 있지만 job 페이지에서 직접 수행됩니다. 이는 GitLab Runner가 배포된 환경에 대한 셸 접근 권한을 사용자에게 제공하는 것이므로 사용자를 보호하기 위해 일부 보안 예방 조치가 취해졌습니다.
GitLab.com의 인스턴스 runner는 대화형 웹 터미널을 제공하지 않습니다. 지원 추가 진행 상황은 이 이슈를 팔로우하세요. GitLab.com에 호스팅된 그룹 및 프로젝트의 경우 자체 그룹 또는 프로젝트 runner를 사용할 때 대화형 웹 터미널을 사용할 수 있습니다.
구성#
대화형 웹 터미널이 작동하려면 두 가지를 구성해야 합니다:
- runner에는
[session_server]가 올바르게 구성되어 있어야 합니다. - GitLab 인스턴스에 역방향 프록시를 사용하는 경우 웹 터미널을 활성화해야 합니다.
Helm 차트에 대한 부분 지원#
대화형 웹 터미널은 gitlab-runner Helm 차트에서 부분적으로 지원됩니다.
다음 경우에 활성화됩니다:
- 레플리카 수가 하나인 경우
loadBalancer서비스를 사용하는 경우
이러한 제한 사항을 수정하기 위한 지원은 다음 이슈에서 추적됩니다:
실행 중인 job 디버깅#
모든 executor가 지원되지는 않습니다.
docker executor는 빌드 스크립트가 완료된 후 계속 실행되지 않습니다. 해당 시점에 터미널이 자동으로 연결을 끊고 사용자가 완료할 때까지 기다리지 않습니다. 이 동작을 개선하기 위한 업데이트는 이 이슈를 팔로우하세요.
때로는 job이 실행 중일 때 예상대로 진행되지 않습니다. 디버깅을 위한 셸이 있으면 도움이 됩니다. job이 실행될 때 오른쪽 패널에 현재 job에 대한 터미널을 여는 debug 버튼([external-link])이 표시됩니다. job을 시작한 사람만 디버깅할 수 있습니다.
선택하면 터미널 페이지가 새 탭으로 열리고 표준 셸처럼 터미널에 접근하고 명령을 입력할 수 있습니다.
job이 완료된 후 터미널이 열려 있으면 구성된 [session_server].session_timeout 기간이 지날 때까지 job이 완료되지 않습니다. 이를 방지하려면 job이 완료된 후 터미널을 닫을 수 있습니다.
