SSH

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed
note
SSH executor는 현재 Bash에서 생성된 스크립트만 지원하며 캐싱 기능은 현재 지원되지 않습니다.

이것은 원격 머신에서 명령을 실행하여 빌드를 실행할 수 있게 해주는 간단한 실행기입니다.

note
GitLab Runner가 SSH executor를 사용하는 원격 시스템에서 일반적인 사전 조건을 충족시키도록 합니다.

SSH executor 사용

SSH executor를 사용하려면, [runners.ssh] 섹션에서 executor = "ssh"를 지정하십시오. 예를 들어: 

[[runners]]
  executor = "ssh"
  [runners.ssh]
    host = "example.com"
    port = "22"
    user = "root"
    password = "password"
    identity_file = "/path/to/identity/file"

password 또는 identity_file 또는 둘 다를 사용하여 서버에 대해 인증할 수 있습니다. GitLab Runner는 /home/user/.ssh/id_(rsa|dsa|ecdsa)에서 identity_file을 암시적으로 읽지 않습니다. identity_file은 명시적으로 지정되어야 합니다.

프로젝트의 소스는 다음 위치로 체크아웃됩니다: ~/builds/<short-token>/<concurrent-id>/<namespace>/<project-name>.

여기서:

  • <short-token>은 러너 토큰의 줄인 버전 (첫 8자리)
  • <concurrent-id>는 프로젝트의 컨텍스트에서 특정 러너에서 로컬 작업 ID를 식별하는 고유 번호
  • <namespace>는 GitLab에 저장된 프로젝트가 있는 공간
  • <project-name>은 GitLab에 저장된 프로젝트의 이름입니다

~/builds 디렉터리를 덮어쓰려면, config.toml의 [[runners]] 섹션 아래에 builds_dir 옵션을 지정하십시오.

작업 artifact를 업로드하려면, SSH로 연결하는 호스트에 gitlab-runner를 설치하십시오.

엄격한 호스트 키 확인 구성

SSH StrictHostKeyChecking을 활성화하려면, [runners.ssh.disable_strict_host_key_checking]을 false로 설정하십시오. 현재 기본값은 true입니다.

GitLab 15.0 이상에서는 기본값이 false로 설정되어 있어 호스트 키 확인이 필요합니다.