Skip to main content

자체 호스트형 실행기 애플리케이션을 서비스로 구성

컴퓨터가 시작될 때 실행기 애플리케이션을 자동으로 시작하도록 자체 호스트형 실행기 애플리케이션을 서비스로 구성할 수 있습니다.

Platform navigation

참고: 자체 호스트형 실행기 애플리케이션을 서비스로 구성하려면 GitHub Enterprise Cloud에 실행기를 추가해야 합니다. 자세한 내용은 "자체 호스트형 실행기 추가"을 참조하세요.

systemd를 사용하는 Linux 시스템의 경우 실행기를 성공적으로 추가한 후 만든 svc.sh 스크립트를 사용하여 애플리케이션을 서비스로 사용하여 설치하고 관리할 수 있습니다.

실행기 컴퓨터에서 자체 호스트형 실행기 애플리케이션을 설치한 디렉터리에서 셸을 엽니다. 아래 명령을 사용하여 자체 호스트형 실행기 서비스 설치 및 관리

참고: 자체 호스트형 실행기 애플리케이션을 Windows의 서비스로 구성하는 것은 애플리케이션 구성 프로세스의 일부입니다. 자체 호스트형 실행기 애플리케이션을 이미 구성했지만 서비스로 구성하지 않은 경우 GitHub에서 실행기를 제거하고 애플리케이션을 다시 구성해야 합니다. 애플리케이션을 다시 구성할 때 애플리케이션을 서비스로 구성하는 옵션을 선택합니다.

자세한 내용은 "자체 호스트형 실행기 제거" 및 "자체 호스트형 실행기 추가"을 참조하세요.

Windows Services 애플리케이션에서 실행기 서비스를 관리하거나 PowerShell을 사용하여 아래 명령을 실행할 수 있습니다.

참고: 자체 호스트형 실행기 애플리케이션을 서비스로 구성하려면 GitHub Enterprise Cloud에 실행기를 추가해야 합니다. 자세한 내용은 "자체 호스트형 실행기 추가"을 참조하세요.

실행기 컴퓨터에서 자체 호스트형 실행기 애플리케이션을 설치한 디렉터리에서 셸을 엽니다. 아래 명령을 사용하여 자체 호스트형 실행기 서비스 설치 및 관리

서비스 설치

  1. 현재 실행 중인 경우 자체 호스트형 실행기 애플리케이션을 중지합니다.

  2. 다음 명령을 사용하여 서비스를 설치합니다.

    sudo ./svc.sh install
    
  3. 또는 이 명령은 선택적 user 인수를 사용하여 서비스를 다른 사용자로 설치합니다.

    ./svc.sh install USERNAME
    

서비스 설치

  1. 현재 실행 중인 경우 자체 호스트형 실행기 애플리케이션을 중지합니다.

  2. 다음 명령을 사용하여 서비스를 설치합니다.

    ./svc.sh install
    

서비스 시작

다음 명령을 사용하여 서비스를 시작합니다.

sudo ./svc.sh start
Start-Service "actions.runner.*"
./svc.sh start

서비스 상태를 확인합니다.

다음 명령을 사용하여 서비스의 상태를 확인합니다.

sudo ./svc.sh status
Get-Service "actions.runner.*"
./svc.sh status

자체 호스트형 실행기의 상태 확인에 대한 자세한 내용은 "자체 호스트형 실행기 모니터링 및 문제 해결"을 참조하세요.

서비스 중지

다음 명령을 사용하여 서비스를 중지합니다.

sudo ./svc.sh stop
Stop-Service "actions.runner.*"
./svc.sh stop

서비스 제거

  1. 현재 실행 중인 경우 서비스를 중지합니다.

  2. 다음 명령을 사용하여 서비스를 제거합니다.

    sudo ./svc.sh uninstall
    
```shell
Remove-Service "actions.runner.*"
```

</div>
```shell
./svc.sh uninstall
```

</div>

자체 호스트형 실행기 서비스 사용자 지정

위의 기본 systemd 서비스 구성을 사용하지 않으려면 사용자 지정된 서비스를 만들거나 원하는 서비스 메커니즘을 사용할 수 있습니다. actions-runner/bin/actions.runner.service.templateserviced 템플릿을 참조로 사용하는 것이 좋습니다. 사용자 지정된 서비스를 사용하는 경우 runsvc.sh 진입점을 사용하여 자체 호스트형 실행기 서비스를 항상 호출해야 합니다.

자체 호스트형 실행기 서비스 사용자 지정

위의 기본 launchd 서비스 구성을 사용하지 않으려면 사용자 지정된 서비스를 만들거나 원하는 서비스 메커니즘을 사용할 수 있습니다. actions-runner/bin/actions.runner.plist.templateplist 템플릿을 참조로 사용하는 것이 좋습니다. 사용자 지정된 서비스를 사용하는 경우 runsvc.sh 진입점을 사용하여 자체 호스트형 실행기 서비스를 항상 호출해야 합니다.