Skip to main content

워크플로에서 액션즈 러너 컨트롤러 실행기 사용

워크플로 파일에서 데이터 변수 variables.product.prodname_actions_runner_controller %} 실행기를 사용합니다.

워크플로 파일에서 ARC 실행기 사용하기

실행기 확장 집합에서 실행할 작업을 할당하려면 확장 집합의 이름을 GitHub Actions 워크플로 파일의 runs-on 키 값으로 지정할 수 있습니다.

예를 들어, 러너 스케일 세트에 대한 다음 구성에서는 INSTALLATION_NAME 값이 arc-runner-set로 설정됩니다.

# Using a Personal Access Token (PAT)
INSTALLATION_NAME="arc-runner-set"
NAMESPACE="arc-runners"
GITHUB_CONFIG_URL="https://github.com/<your_enterprise/org/repo>"
GITHUB_PAT="<PAT>"
helm install "${INSTALLATION_NAME}" \
    --namespace "${NAMESPACE}" \
    --create-namespace \
    --set githubConfigUrl="${GITHUB_CONFIG_URL}" \
    --set githubConfigSecret.github_token="${GITHUB_PAT}" \
    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set

워크플로에서 이 구성을 사용하려면 워크플로의 runs-on 키 값을 다음 예제와 비슷하게 arc-runner-set로 설정합니다.

jobs:
  job_name:
    runs-on: arc-runner-set

실행기 스케일 세트 이름 사용

실행기 스케일 세트 이름은 해당 실행기 그룹 내에서 고유합니다. 동일한 이름의 여러 실행기 확장 집합을 배포하려면 다른 실행기 그룹에 속해야 합니다. 실행기 확장 집합 이름을 지정하는 방법에 대한 자세한 내용은 Actions Runner Controller 사용 실행기 Scale Set 배포을(를) 참조하세요.

실행기 확장 집합의 설치 이름을 사용하거나 파일의 runnerScaleSetName 필드 값을 runs-on 대상으로 정의할 수 있습니다 values.yaml. 스케일 세트에 여러 레이블을 할당하여 보다 유연한 작업 배정을 가능하게 할 수도 있습니다. 실행기 스케일 집합의 레이블을 구성하려면, runnerScaleSetLabels``values.yaml 파일에 값을 설정하십시오. 자세한 내용은 Actions Runner Controller 사용 실행기 Scale Set 배포을(를) 참조하세요.

레이블을 사용하여 실행기 확장 집합을 대상으로 하기

실행기 스케일 세트에 여러 레이블을 할당하고, 이를 워크플로에서 실행기를 대상으로 지정하는 데 사용할 수 있습니다. 실행기 스케일 세트에 대한 레이블을 구성하려면 runnerScaleSetLabels``values.yaml 파일의 값을 설정합니다.

runnerScaleSetLabels:
  - linux
  - gpu
  - private-network

특정 레이블이 있는 러너 스케일 세트를 대상으로 지정하려면 워크플로의 runs-on 키에 레이블을 배열 형태로 명시하세요.

jobs:
  job_name:
    runs-on: [linux, gpu, private-network]

행동 실행자 컨트롤러 법적 고지