InfoGrab Docs

step runner 수동 설치

요약

step runner는 GitLab Runner가 네이티브 functions 지원이 없는 executor에서 GitLab Functions를 실행할 수 있도록 하는 바이너리입니다. step runner를 수동으로 설치해야 하는지 여부는 executor에 따라 다릅니다.

step runner는 GitLab Runner가 네이티브 functions 지원이 없는 executor에서 GitLab Functions를 실행할 수 있도록 하는 바이너리입니다. 이러한 executor의 경우 파이프라인에서 functions를 사용하기 전에 잡이 실행되는 호스트 또는 컨테이너에 step runner 바이너리를 설치해야 합니다.

수동 step runner 설치가 필요한 Executor#

step runner를 수동으로 설치해야 하는지 여부는 executor에 따라 다릅니다. 다음 표는 어떤 executor에서 step runner를 수동으로 설치해야 하는지 보여줍니다:

Executor 수동 설치 필요
Shell 예
SSH 예
Kubernetes 예
VirtualBox 예
Parallels 예
Custom 예
Instance 예
Docker Windows에서만
Docker Autoscaler Windows에서만
Docker Machine Windows에서만

수동 설치가 필요하지 않은 executor의 경우 gitlab-runner-helper가 step runner 역할을 합니다. step-runner 바이너리는 이러한 executor에 없으며 필요하지도 않습니다.

변수 액세스 제한#

step runner를 수동으로 설치하는 executor에서 step runner는 잡 변수 및 환경 변수에 대한 제한적인 액세스 권한을 가집니다:

구문 사용 가능한 값
${{ vars.<name> }} 접두사가 CI_, DOCKER_, 또는 GITLAB_인 잡 변수만 사용 가능합니다.
${{ env.<name> }} HTTPS_PROXY, HTTP_PROXY, NO_PROXY, http_proxy, https_proxy, no_proxy, all_proxy, LANG, LC_ALL, LC_CTYPE, LOGNAME, USER, PATH, SHELL, TERM, TMPDIR, TZ

step runner 수동 설치#

여러 플랫폼을 위한 사전 컴파일된 바이너리는 step runner 릴리스 페이지에서 다운로드할 수 있습니다. 지원되는 플랫폼에는 여러 아키텍처(amd64, arm64, 386, arm, s390x, ppc64le)에서 Windows, Linux, macOS, FreeBSD가 포함됩니다.

바이너리 진위 확인#

설치하기 전에 바이너리가 변조되지 않았으며 공식 GitLab 팀에서 제공한 것인지 확인하세요.

  1. GPG 공개 키를 다운로드하고 가져옵니다:

    # All platforms (requires gpg installed: https://gnupg.org/download/)
curl -o step-runner.pub.gpg "https://gitlab.com/gitlab-org/step-runner/-/package_files/257922684/download"
gpg --import step-runner.pub.gpg
gpg --fingerprint

    가져온 키가 다음과 일치하는지 확인합니다:

    키 속성 값
    Name GitLab, Inc.
    Email support@gitlab.com
    Fingerprint 0FCD 59B1 6F4A 62D0 3839 27A5 42FF CA71 62A5 35F5
    Expiry 2029-01-05

  2. 릴리스 페이지에서 다음 파일을 다운로드합니다:

    • 플랫폼에 맞는 바이너리(예: step-runner-linux-amd64 또는 step-runner-darwin-arm64)
    • step-runner-release.sha256
    • step-runner-release.sha256.asc

  3. GPG 서명을 확인합니다:

    # All platforms (requires gpg)
gpg --verify step-runner-release.sha256.asc step-runner-release.sha256

    출력에 Good signature 메시지가 포함되어야 합니다.

  4. 바이너리 체크섬을 확인합니다:

    # Linux
sha256sum -c step-runner-release.sha256

    # macOS
shasum -a 256 -c step-runner-release.sha256

    # Windows (PowerShell) — replace 'step-runner-windows-amd64.exe' with your binary name
$binary = "step-runner-windows-amd64.exe"
$expected = (Select-String -Path "step-runner-release.sha256" -Pattern $binary).Line.Split(" ")[0]
$actual = (Get-FileHash -Algorithm SHA256 $binary).Hash.ToLower()
if ($actual -eq $expected) { "OK" } else { "FAILED: checksum mismatch" }

    출력에서 해당 바이너리에 대해 OK가 표시되어야 합니다.

PATH에 step-runner 추가#

바이너리를 다운로드하고 확인한 후 잡이 실행되는 인스턴스의 PATH에서 사용할 수 있도록 만드세요. 이 인스턴스는 executor에 따라 호스트 머신 또는 컨테이너일 수 있습니다.

  1. 바이너리 이름을 step-runner(또는 Windows에서는 step-runner.exe)로 변경합니다:

    mv step-runner-<os>-<arch> step-runner

  2. Unix 계열 시스템에서는 바이너리를 실행 가능하게 만듭니다:

    chmod +x step-runner

  3. 바이너리를 PATH에 있는 디렉터리로 이동합니다:

    mv step-runner /usr/local/bin/

step runner 수동 설치

Tier: Free, Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기
요약

step runner는 GitLab Runner가 네이티브 functions 지원이 없는 executor에서 GitLab Functions를 실행할 수 있도록 하는 바이너리입니다. step runner를 수동으로 설치해야 하는지 여부는 executor에 따라 다릅니다.

step runner는 GitLab Runner가 네이티브 functions 지원이 없는 executor에서 GitLab Functions를 실행할 수 있도록 하는 바이너리입니다. 이러한 executor의 경우 파이프라인에서 functions를 사용하기 전에 잡이 실행되는 호스트 또는 컨테이너에 step runner 바이너리를 설치해야 합니다.

수동 step runner 설치가 필요한 Executor#

step runner를 수동으로 설치해야 하는지 여부는 executor에 따라 다릅니다. 다음 표는 어떤 executor에서 step runner를 수동으로 설치해야 하는지 보여줍니다:

Executor 수동 설치 필요
Shell 예
SSH 예
Kubernetes 예
VirtualBox 예
Parallels 예
Custom 예
Instance 예
Docker Windows에서만
Docker Autoscaler Windows에서만
Docker Machine Windows에서만

수동 설치가 필요하지 않은 executor의 경우 gitlab-runner-helper가 step runner 역할을 합니다. step-runner 바이너리는 이러한 executor에 없으며 필요하지도 않습니다.

변수 액세스 제한#

step runner를 수동으로 설치하는 executor에서 step runner는 잡 변수 및 환경 변수에 대한 제한적인 액세스 권한을 가집니다:

구문 사용 가능한 값
${{ vars.<name> }} 접두사가 CI_, DOCKER_, 또는 GITLAB_인 잡 변수만 사용 가능합니다.
${{ env.<name> }} HTTPS_PROXY, HTTP_PROXY, NO_PROXY, http_proxy, https_proxy, no_proxy, all_proxy, LANG, LC_ALL, LC_CTYPE, LOGNAME, USER, PATH, SHELL, TERM, TMPDIR, TZ

step runner 수동 설치#

여러 플랫폼을 위한 사전 컴파일된 바이너리는 step runner 릴리스 페이지에서 다운로드할 수 있습니다. 지원되는 플랫폼에는 여러 아키텍처(amd64, arm64, 386, arm, s390x, ppc64le)에서 Windows, Linux, macOS, FreeBSD가 포함됩니다.

바이너리 진위 확인#

설치하기 전에 바이너리가 변조되지 않았으며 공식 GitLab 팀에서 제공한 것인지 확인하세요.

  1. GPG 공개 키를 다운로드하고 가져옵니다:

    # All platforms (requires gpg installed: https://gnupg.org/download/)
curl -o step-runner.pub.gpg "https://gitlab.com/gitlab-org/step-runner/-/package_files/257922684/download"
gpg --import step-runner.pub.gpg
gpg --fingerprint

    가져온 키가 다음과 일치하는지 확인합니다:

    키 속성 값
    Name GitLab, Inc.
    Email support@gitlab.com
    Fingerprint 0FCD 59B1 6F4A 62D0 3839 27A5 42FF CA71 62A5 35F5
    Expiry 2029-01-05

  2. 릴리스 페이지에서 다음 파일을 다운로드합니다:

    • 플랫폼에 맞는 바이너리(예: step-runner-linux-amd64 또는 step-runner-darwin-arm64)
    • step-runner-release.sha256
    • step-runner-release.sha256.asc

  3. GPG 서명을 확인합니다:

    # All platforms (requires gpg)
gpg --verify step-runner-release.sha256.asc step-runner-release.sha256

    출력에 Good signature 메시지가 포함되어야 합니다.

  4. 바이너리 체크섬을 확인합니다:

    # Linux
sha256sum -c step-runner-release.sha256

    # macOS
shasum -a 256 -c step-runner-release.sha256

    # Windows (PowerShell) — replace 'step-runner-windows-amd64.exe' with your binary name
$binary = "step-runner-windows-amd64.exe"
$expected = (Select-String -Path "step-runner-release.sha256" -Pattern $binary).Line.Split(" ")[0]
$actual = (Get-FileHash -Algorithm SHA256 $binary).Hash.ToLower()
if ($actual -eq $expected) { "OK" } else { "FAILED: checksum mismatch" }

    출력에서 해당 바이너리에 대해 OK가 표시되어야 합니다.

PATH에 step-runner 추가#

바이너리를 다운로드하고 확인한 후 잡이 실행되는 인스턴스의 PATH에서 사용할 수 있도록 만드세요. 이 인스턴스는 executor에 따라 호스트 머신 또는 컨테이너일 수 있습니다.

  1. 바이너리 이름을 step-runner(또는 Windows에서는 step-runner.exe)로 변경합니다:

    mv step-runner-<os>-<arch> step-runner

  2. Unix 계열 시스템에서는 바이너리를 실행 가능하게 만듭니다:

    chmod +x step-runner

  3. 바이너리를 PATH에 있는 디렉터리로 이동합니다:

    mv step-runner /usr/local/bin/