GitLab Runner에서 지원하는 쉘 유형

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-Managed

GitLab Runner은 실행중인 시스템에 빌드를 실행할 수 있게 하는 셸 스크립트 생성기를 구현합니다.

셸 스크립트에는 빌드의 모든 단계를 실행하는 명령이 포함되어 있습니다:

git clone
빌드 캐시 복원
빌드 명령어
빌드 캐시 업데이트
빌드 아티팩트 생성 및 업로드

쉘은 구성 옵션이 없습니다. 빌드 단계는 .gitlab-ci.yml의 script 지시문에서 정의된 명령에서 받습니다.

지원되는 셸은 다음과 같습니다:

셸	상태	설명
`bash`	완전 지원됨	Bash (Bourne Again Shell). 모든 명령이 Bash 컨텍스트에서 실행됨 (모든 Unix 시스템의 기본값)
`sh`	완전 지원됨	Sh (Bourne shell). 모든 명령이 Sh 컨텍스트에서 실행됨 (모든 Unix 시스템의 `bash`에 대한 대체)
`powershell`	완전 지원됨	PowerShell 스크립트. 모든 명령이 PowerShell Desktop 컨텍스트에서 실행됨
`pwsh`	완전 지원됨	PowerShell 스크립트. 모든 명령이 PowerShell Core 컨텍스트에서 실행됨. GitLab Runner 14.0 이상에서는 Windows에 새로운 runner를 등록할 때 기본값입니다.

기본값 이외의 특정 셸을 선택하려면 config.toml 파일에서 셸을 지정해야 합니다.

Sh/Bash 셸

모든 Unix 기반 시스템에서 사용되는 기본 셸입니다. .gitlab-ci.yml에서 사용되는 bash 스크립트는 다음과 같은 명령을 사용하여 실행됩니다:

# 이 명령은 빌드가 다른 사용자의 컨텍스트(셸 실행자)에서 실행되어야 하는 경우 사용됩니다
cat generated-bash-script | su --shell /bin/bash --login user

# 이 명령은 현재 사용자를 사용하지만 login 환경에서 실행되어야 하는 경우 사용됩니다
cat generated-bash-script | /bin/bash --login

# 이 명령은 Docker 환경에서 실행되어야 하는 경우 사용됩니다
cat generated-bash-script | /bin/bash

셸 프로필 로딩

특정 실행자에 대해 runner는 --login 플래그를 전달하여 셸 프로필을 로드합니다. .bashrc, .bash_logout, 또는 다른 도트 파일에 있는 내용이 작업에서 실행됩니다.

‘Prepare environment’ 스테이지에서 작업이 실패하면, 셸 프로필에서 실패를 유발하는 경우가 있습니다. 일반적인 실패 사례는 .bash_logout에서 콘솔을 지우려고 하는 경우입니다.

이 오류를 해결하려면 /home/gitlab-runner/.bash_logout을 확인하세요. 예를 들어, .bash_logout 파일에 다음과 같은 스크립트 섹션이 있는 경우 주석 처리하고 파이프라인을 다시 시작하세요:

if [ "$SHLVL" = 1 ]; then
    [ -x /usr/bin/clear_console ] && /usr/bin/clear_console -q
fi

셸 프로필을 로드하는 실행자:

shell
parallels (대상 가상 머신의 셸 프로필이 로드됨)
virtualbox (대상 가상 머신의 셸 프로필이 로드됨)
ssh (대상 머신의 셸 프로필이 로드됨)

PowerShell

Windows에 새로운 runner가 GitLab Runner 12.0-13.12에서 등록될 때 기본 셸은 PowerShell Desktop Edition입니다. 14.0 이상에서는 기본값은 PowerShell Core Edition입니다.

PowerShell은 다른 사용자의 컨텍스트에서 빌드를 실행할 수 없습니다.

생성된 PowerShell 스크립트는 해당 내용을 파일에 저장하고 다음 명령에 파일명을 전달하여 실행됩니다:

PowerShell Desktop Edition의 경우:

powershell -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command generated-windows-powershell.ps1

PowerShell Core Edition의 경우:

pwsh -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command generated-windows-powershell.ps1

다음은 PowerShell 스크립트의 예시입니다:

$ErrorActionPreference = "Continue" # PowerShell Core를 타겟팅할 때 'Stop'으로 설정됨

echo "Running on $([Environment]::MachineName)..."

& {
  $CI="true"
  $env:CI=$CI
  $CI_COMMIT_SHA="db45ad9af9d7af5e61b829442fd893d96e31250c"
  $env:CI_COMMIT_SHA=$CI_COMMIT_SHA
  $CI_COMMIT_BEFORE_SHA="d63117656af6ff57d99e50cc270f854691f335ad"
  $env:CI_COMMIT_BEFORE_SHA=$CI_COMMIT_BEFORE_SHA
  $CI_COMMIT_REF_NAME="main"
  $env:CI_COMMIT_REF_NAME=$CI_COMMIT_REF_NAME
  $CI_JOB_ID="1"
  $env:CI_JOB_ID=$CI_JOB_ID
  $CI_REPOSITORY_URL="Z:\Gitlab\tests\test"
  $env:CI_REPOSITORY_URL=$CI_REPOSITORY_URL
  $CI_PROJECT_ID="1"
  $env:CI_PROJECT_ID=$CI_PROJECT_ID
  $CI_PROJECT_DIR="Z:\Gitlab\tests\test\builds\0\project-1"
  $env:CI_PROJECT_DIR=$CI_PROJECT_DIR
  $CI_SERVER="yes"
  $env:CI_SERVER=$CI_SERVER
  $CI_SERVER_NAME="GitLab CI"
  $env:CI_SERVER_NAME=$CI_SERVER_NAME
  $CI_SERVER_VERSION=""
  $env:CI_SERVER_VERSION=$CI_SERVER_VERSION
  $CI_SERVER_REVISION=""
  $env:CI_SERVER_REVISION=$CI_SERVER_REVISION
  $GITLAB_CI="true"
  $env:GITLAB_CI=$GITLAB_CI
  $GIT_SSL_CAINFO=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $GIT_SSL_CAINFO | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $GIT_SSL_CAINFO="C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $env:GIT_SSL_CAINFO=$GIT_SSL_CAINFO
  $CI_SERVER_TLS_CA_FILE=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $CI_SERVER_TLS_CA_FILE | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $CI_SERVER_TLS_CA_FILE="C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $env:CI_SERVER_TLS_CA_FILE=$CI_SERVER_TLS_CA_FILE
  echo "Cloning repository..."
  if( (Get-Command -Name Remove-Item2 -Module NTFSSecurity -ErrorAction SilentlyContinue) -and (Test-Path "C:\GitLab-Runner\builds\0\project-1" -PathType Container) ) {
    Remove-Item2 -Force -Recurse "C:\GitLab-Runner\builds\0\project-1"
  } elseif(Test-Path "C:\GitLab-Runner\builds\0\project-1") {
    Remove-Item -Force -Recurse "C:\GitLab-Runner\builds\0\project-1"
  }

  & "git" "clone" "https://gitlab.com/group/project.git" "Z:\Gitlab\tests\test\builds\0\project-1"
  if(!$?) { Exit $LASTEXITCODE }

  cd "C:\GitLab-Runner\builds\0\project-1"
  if(!$?) { Exit $LASTEXITCODE }

  echo "Checking out db45ad9a as main..."
  & "git" "checkout" "db45ad9af9d7af5e61b829442fd893d96e31250c"
  if(!$?) { Exit $LASTEXITCODE }

  if(Test-Path "..\..\..\cache\project-1\pages\main\cache.tgz" -PathType Leaf) {
    echo "Restoring cache..."
    & "gitlab-runner-windows-amd64.exe" "extract" "--file" "..\..\..\cache\project-1\pages\main\cache.tgz"
    if(!$?) { Exit $LASTEXITCODE }

  } else {
    if(Test-Path "..\..\..\cache\project-1\pages\main\cache.tgz" -PathType Leaf) {
      echo "Restoring cache..."
      & "gitlab-runner-windows-amd64.exe" "extract" "--file" "..\..\..\cache\project-1\pages\main\cache.tgz"
      if(!$?) { Exit $LASTEXITCODE }

    }
  }
}
if(!$?) { Exit $LASTEXITCODE }

& {
  $CI="true"
  $env:CI=$CI
  $CI_COMMIT_SHA="db45ad9af9d7af5e61b829442fd893d96e31250c"
  $env:CI_COMMIT_SHA=$CI_COMMIT_SHA
  $CI_COMMIT_BEFORE_SHA="d63117656af6ff57d99e50cc270f854691f335ad"
  $env:CI_COMMIT_BEFORE_SHA=$CI_COMMIT_BEFORE_SHA
  $CI_COMMIT_REF_NAME="main"
  $env:CI_COMMIT_REF_NAME=$CI_COMMIT_REF_NAME
  $CI_JOB_ID="1"
  $env:CI_JOB_ID=$CI_JOB_ID
  $CI_REPOSITORY_URL="Z:\Gitlab\tests\test"
  $env:CI_REPOSITORY_URL=$CI_REPOSITORY_URL
  $CI_PROJECT_ID="1"
  $env:CI_PROJECT_ID=$CI_PROJECT_ID
  $CI_PROJECT_DIR="Z:\Gitlab\tests\test\builds\0\project-1"
  $env:CI_PROJECT_DIR=$CI_PROJECT_DIR
  $CI_SERVER="yes"
  $env:CI_SERVER=$CI_SERVER
  $CI_SERVER_NAME="GitLab CI"
  $env:CI_SERVER_NAME=$CI_SERVER_NAME
  $CI_SERVER_VERSION=""
  $env:CI_SERVER_VERSION=$CI_SERVER_VERSION
  $CI_SERVER_REVISION=""
  $env:CI_SERVER_REVISION=$CI_SERVER_REVISION
  $GITLAB_CI="true"
  $env:GITLAB_CI=$GITLAB_CI
  $GIT_SSL_CAINFO=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $GIT_SSL_CAINFO | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $GIT_SSL_CAINFO="C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $env:GIT_SSL_CAINFO=$GIT_SSL_CAINFO
  $CI_SERVER_TLS_CA_FILE=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $CI_SERVER_TLS_CA_FILE | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $CI_SERVER_TLS_CA_FILE="C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $env:CI_SERVER_TLS_CA_FILE=$CI_SERVER_TLS_CA_FILE
  cd "C:\GitLab-Runner\builds\0\project-1"
  if(!$?) { Exit $LASTEXITCODE }

  echo "`$ echo true"
  echo true
}
if(!$?) { Exit $LASTEXITCODE }

& {
  $CI="true"
  $env:CI=$CI
  $CI_COMMIT_SHA="db45ad9af9d7af5e61b829442fd893d96e31250c"
  $env:CI_COMMIT_SHA=$CI_COMMIT_SHA
  $CI_COMMIT_BEFORE_SHA="d63117656af6ff57d99e50cc270f854691f335ad"
  $env:CI_COMMIT_BEFORE_SHA=$CI_COMMIT_BEFORE_SHA
  $CI_COMMIT_REF_NAME="main"
  $env:CI_COMMIT_REF_NAME=$CI_COMMIT_REF_NAME
  $CI_JOB_ID="1"
  $env:CI_JOB_ID=$CI_JOB_ID
  $CI_REPOSITORY_URL="Z:\Gitlab\tests\test"
  $env:CI_REPOSITORY_URL=$CI_REPOSITORY_URL
  $CI_PROJECT_ID="1"
  $env:CI_PROJECT_ID=$CI_PROJECT_ID
  $CI_PROJECT_DIR="Z:\Gitlab\tests\test\builds\0\project-1"
  $env:CI_PROJECT_DIR=$CI_PROJECT_DIR
  $CI_SERVER="yes"
  $env:CI_SERVER=$CI_SERVER
  $CI_SERVER_NAME="GitLab CI"
  $env:CI_SERVER_NAME=$CI_SERVER_NAME
  $CI_SERVER_VERSION=""
  $env:CI_SERVER_VERSION=$CI_SERVER_VERSION
  $CI_SERVER_REVISION=""
  $env:CI_SERVER_REVISION=$CI_SERVER_REVISION
  $GITLAB_CI="true"
  $env:GITLAB_CI=$GITLAB_CI
  $GIT_SSL_CAINFO=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $GIT_SSL_CAINFO | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $GIT_SSL_CAINFO="C:\GitLab-Runner\builds\0\project-1.tmp\GIT_SSL_CAINFO"
  $env:GIT_SSL_CAINFO=$GIT_SSL_CAINFO
  $CI_SERVER_TLS_CA_FILE=""
  New-Item -ItemType directory -Force -Path "C:\GitLab-Runner\builds\0\project-1.tmp" | out-null
  $CI_SERVER_TLS_CA_FILE | Out-File "C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $CI_SERVER_TLS_CA_FILE="C:\GitLab-Runner\builds\0\project-1.tmp\CI_SERVER_TLS_CA_FILE"
  $env:CI_SERVER_TLS_CA_FILE=$CI_SERVER_TLS_CA_FILE
  cd "C:\GitLab-Runner\builds\0\project-1"
  if(!$?) { Exit $LASTEXITCODE }

  echo "Archiving cache..."
  & "gitlab-runner-windows-amd64.exe" "archive" "--file" "..\..\..\cache\project-1\pages\main\cache.tgz" "--path" "vendor"
  if(!$?) { Exit $LASTEXITCODE }

}
if(!$?) { Exit $LASTEXITCODE }

Windows 배치 실행

이전에 PowerShell로 이식되지 않은 이전 배치 스크립트를 PowerShell에서 Start-Process "cmd.exe" "/c C:\Path\file.bat"를 사용하여 실행할 수 있습니다.

기본으로 PowerShell이 있는 경우 CMD 쉘에 액세스

프로젝트: GitLab CI에서 기본 PowerShell에서 CMD 호출는 실행 중인 러너에서 기본 셸이 PowerShell일 때 CMD 쉘에 액세스하는 방법을 보여줍니다.

작동 중인 PowerShell 예제 비디오 안내

GitLab CI에서 PowerShell로 썰고 자르기 비디오는 GitLab CI의 PowerShell 파이프라인 Guided Exploration 프로젝트의 안내입니다. 다음에서 테스트되었습니다.

GitLab.com의 Windows 호스팅 러너에서 Windows PowerShell 및 PowerShell Core 7.
Docker-Machine 러너의 Linux 컨테이너에서 PowerShell Core 7.

이 예제는 귀하의 그룹이나 인스턴스로 복사하여 테스트할 수 있습니다. 프로젝트 페이지에서 보다 자세한 GitLab CI 패턴 예제에 대한 세부 정보를 확인할 수 있습니다.

Windows 배치 (제거됨)

이 기능은 GitLab 15.7에서 사용 중단되었으며 17.0에서 제거되었습니다.

GitLab Runner에서 지원하는 쉘 유형

Sh/Bash 셸

셸 프로필 로딩

PowerShell

Windows 배치 실행

기본으로 PowerShell이 있는 경우 CMD 쉘에 액세스

작동 중인 PowerShell 예제 비디오 안내

Windows 배치 (제거됨)

도움말

기능 사용 가능성과 제품 평가판

도움받기