워크플로에서 Actions Runner Controller 실행기 사용

워크플로 파일에서 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를 사용하여 실행기 확장 집합 배포"을 참조하세요.

ARC에서 만든 실행기를 타겟팅하기 위해 데 추가 레이블을 사용할 수 없습니다. 설치 중에 지정한 실행기 확장 집합의 설치 이름을 사용하거나 values.yaml 파일의 runnerScaleSetName 필드 값을 정의하여 사용할 수 있습니다. 이러한 실행기는 runs-on 대상으로 사용할 '단일 레이블'로 사용됩니다. 자세한 내용은 "Actions Runner Controller를 사용하여 실행기 확장 집합 배포"을 참조하세요.

다음은 Apache-2.0 라이선스에서 https://github.com/actions/actions-runner-controller/로부터 일부 조정되었습니다.

Copyright 2019 Moto Ishizawa

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.