{"meta":{"title":"워크플로에서 액션즈 러너 컨트롤러 실행기 사용","intro":"워크플로 파일에서 Actions Runner Controller 러너를 사용합니다.","product":"GitHub Actions","breadcrumbs":[{"href":"/ko/actions","title":"GitHub Actions"},{"href":"/ko/actions/how-tos","title":"사용법"},{"href":"/ko/actions/how-tos/manage-runners","title":"실행기 관리"},{"href":"/ko/actions/how-tos/manage-runners/use-actions-runner-controller","title":"Actions Runner 컨트롤러"},{"href":"/ko/actions/how-tos/manage-runners/use-actions-runner-controller/use-arc-in-a-workflow","title":"워크플로에서 ARC 사용"}],"documentType":"article"},"body":"# 워크플로에서 액션즈 러너 컨트롤러 실행기 사용\n\n워크플로 파일에서 Actions Runner Controller 러너를 사용합니다.\n\n## 워크플로 파일에서 ARC 실행기 사용하기\n\n러너 스케일 세트에서 실행할 작업을 할당하려면 워크플로 파일의 `runs-on` 키에 대해 GitHub Actions 값으로 스케일 세트의 이름을 지정할 수 있습니다.\n\n예를 들어, 러너 스케일 세트에 대한 다음 구성에서는 `INSTALLATION_NAME` 값이 `arc-runner-set`로 설정됩니다.\n\n```bash\n# Using a Personal Access Token (PAT)\nINSTALLATION_NAME=\"arc-runner-set\"\nNAMESPACE=\"arc-runners\"\nGITHUB_CONFIG_URL=\"https://github.com/<your_enterprise/org/repo>\"\nGITHUB_PAT=\"<PAT>\"\nhelm install \"${INSTALLATION_NAME}\" \\\n    --namespace \"${NAMESPACE}\" \\\n    --create-namespace \\\n    --set githubConfigUrl=\"${GITHUB_CONFIG_URL}\" \\\n    --set githubConfigSecret.github_token=\"${GITHUB_PAT}\" \\\n    oci://ghcr.io/actions/actions-runner-controller-charts/gha-runner-scale-set\n```\n\n워크플로에서 이 구성을 사용하려면 워크플로의 `runs-on` 키 값을 다음 예제와 비슷하게 `arc-runner-set`로 설정합니다.\n\n```yaml\njobs:\n  job_name:\n    runs-on: arc-runner-set\n```\n\n## 실행기 스케일 세트 이름 사용\n\n실행기 스케일 세트 이름은 해당 실행기 그룹 내에서 고유합니다. 동일한 이름의 여러 실행기 확장 집합을 배포하려면 다른 실행기 그룹에 속해야 합니다. 실행기 확장 집합의 이름을 지정하는 구체적인 방법은 [Actions Runner Controller 사용 실행기 Scale Set 배포](/ko/actions/how-tos/manage-runners/use-actions-runner-controller/deploy-runner-scale-sets)를 참고하시기 바랍니다.\n\n실행기 스케일 세트의 설치 이름을 사용하거나, [`values.yaml`](https://github.com/actions/actions-runner-controller/blob/master/charts/gha-runner-scale-set/values.yaml) 파일에서 `runnerScaleSetName` 필드의 값을 정의하여 `runs-on` 대상으로 지정할 수 있습니다. 스케일 세트에 여러 레이블을 할당하여 보다 유연한 작업 배정을 가능하게 할 수도 있습니다. 실행기 스케일 세트의 레이블을 구성하려면, `values.yaml` 파일에서 `runnerScaleSetLabels` 값을 설정합니다. 자세한 내용은 [Actions Runner Controller 사용 실행기 Scale Set 배포](/ko/actions/how-tos/manage-runners/use-actions-runner-controller/deploy-runner-scale-sets)을 참조하세요.\n\n## 레이블을 사용하여 실행기 확장 집합을 대상으로 하기\n\n실행기 스케일 세트에 여러 레이블을 할당하고, 이를 워크플로에서 실행기를 대상으로 지정하는 데 사용할 수 있습니다. 실행기 확장 세트의 레이블을 구성하려면, `runnerScaleSetLabels` 파일에서 `values.yaml` 값을 설정합니다.\n\n```yaml\nrunnerScaleSetLabels:\n  - linux\n  - gpu\n  - private-network\n```\n\n특정 레이블이 있는 러너 스케일 세트를 대상으로 지정하려면 워크플로의 `runs-on` 키에 레이블을 배열 형태로 명시하세요.\n\n```yaml\njobs:\n  job_name:\n    runs-on: [linux, gpu, private-network]\n```\n\n## 법적 고지\n\n다음은 Apache-2.0 라이선스에서 <https://github.com/actions/actions-runner-controller/로부터> 일부 조정되었습니다.\n\n```text\nCopyright 2019 Moto Ishizawa\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```"}