{"meta":{"title":"GitHub 호스팅 실행기 사용자 지정","intro":"워크플로의 일부로 GitHub 호스팅된 실행기에서 추가 소프트웨어를 설치할 수 있습니다.","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/github-hosted-runners","title":"GitHub 호스팅 실행기"},{"href":"/ko/actions/how-tos/manage-runners/github-hosted-runners/customize-runners","title":"실행기 사용자 지정"}],"documentType":"article"},"body":"# GitHub 호스팅 실행기 사용자 지정\n\n워크플로의 일부로 GitHub 호스팅된 실행기에서 추가 소프트웨어를 설치할 수 있습니다.\n\nGitHub호스팅된 러너에서 추가 소프트웨어 패키지가 필요한 경우, 워크플로의 일부로 해당 패키지를 설치하는 작업을 만들 수 있습니다.\n\n기본적으로 이미 설치된 패키지를 보려면 [GitHub 호스팅 실행기](/ko/actions/concepts/runners/github-hosted-runners#preinstalled-software-for-github-owned-images)을(를) 참조하세요.\n\n이 가이드에서는 GitHub호스팅 실행기에 추가 소프트웨어를 설치하는 작업을 만드는 방법을 설명합니다.\n\n## Ubuntu 실행기에서 소프트웨어 설치\n\n다음 예제에서는 작업의 일부로 `apt` 패키지를 설치하는 방법을 보여 줍니다.\n\n```yaml\nname: Build on Ubuntu\non: push\n\njobs:\n  build:\n    runs-on: ubuntu-latest\n    steps:\n      - name: Check out repository code\n        uses: actions/checkout@v6\n      - name: Install jq tool\n        run: |\n          sudo apt-get update\n          sudo apt-get install jq\n```\n\n> \\[!NOTE]\n> 패키지를 설치하기 전에 항상 `sudo apt-get update`를 실행합니다.\n> `apt` 인덱스가 부실한 경우 이 명령은 사용 가능한 패키지를 가져오고 다시 인덱싱하여 패키지 설치 오류를 방지하는 데 도움이 됩니다.\n\n## macOS 실행기에서 소프트웨어 설치\n\n다음 예제에서는 작업의 일부로 Brew 패키지 및 캐스크를 설치하는 방법을 보여 줍니다.\n\n```yaml\nname: Build on macOS\non: push\n\njobs:\n  build:\n    runs-on: macos-latest\n    steps:\n      - name: Check out repository code\n        uses: actions/checkout@v6\n      - name: Install GitHub CLI\n        run: |\n          brew update\n          brew install gh\n      - name: Install Microsoft Edge\n        run: |\n          brew update\n          brew install --cask microsoft-edge\n```\n\n## Windows 러너에서 소프트웨어 설치\n\n다음 예제에서는 [Chocolatey](https://community.chocolatey.org/packages) 를 사용하여 작업의 일부로 CLI를 설치하는 GitHub 방법을 보여 줍니다.\n\n```yaml\nname: Build on Windows\non: push\njobs:\n  build:\n    runs-on: windows-latest\n    steps:\n      - run: choco install gh\n      - run: gh version\n```"}