Symptoms
다음 문제 중 하나 이상이 표시 될 수 있습니다. 다른 문제로 인해 동일한 문제가 발생할 수 있으므로 문제 확인 의 검사를 사용하여 중단된 알림 작업이 원인인지 확인합니다.
- 새 리포지토리와 같이 이전에 GitHub Actions을 사용한 적이 없는 리포지토리에서는 워크플로가 실행되지 않습니다. 리포지토리의 GitHub Actions 설정 페이지와 자체 호스팅 실행기를 추가하는 페이지는 500 오류를 반환합니다. 이미 사용 GitHub Actions 중인 리포지토리는 일반적으로 계속 작동합니다.
- 이전에 GitHub Actions을 사용한 적이 없는 조직에서 조직의 GitHub Actions 설정, 실행기 및 실행기 그룹 페이지는 500 오류를 반환합니다. 엔터프라이즈에서 이전에 사용하지 GitHub Actions 않은 경우 엔터프라이즈 실행기 및 실행기 그룹 페이지도 같은 방식으로 실패할 수 있습니다.
- 업그레이드 또는 핫패치, 또는 GitHub Actions를 업데이트하는 다른 구성 실행도 15분 이상 일시 중지된 다음 실패합니다.
/data/user/common/ghe-config.log구성 로그에Failed to update the following host process이 포함되어 있습니다. 이 오류의 원인은 특히 업그레이드 중에 다른 것일 수도 있습니다. - 시스템 로그는 거의 1초마다
is still running past its interval time작업SqlNotificationBackgroundWork라고 알리는 새 메시지를 가져옵니다. 작업 에이전트 프로세스에서 중단된 작업은 이 메시지를 기록하지 않습니다.
ghe-actions-check 는 이 문제가 발생하는 동안 모든 서비스가 정상 상태임을 보고할 수 있으므로 정상 결과는 이를 배제하지 않습니다.
원인
GitHub Actions 는 각 리포지토리, 사용자, 조직 및 엔터프라이즈에서 GitHub Actions가 처음 사용될 때 스토리지를 설정합니다. 이 스토리지는 실행기 등록 및 GitHub Actions에 필요한 다른 설정을 보유합니다.
GitHub Actions 서비스는 여러 프로세스로 실행됩니다. 각 프로세스는 1초에 한 번 정도 GitHub Actions 데이터베이스의 알림 큐를 확인하고 찾은 변경 사항을 수신 확인하는 백그라운드 작업을 실행합니다. 일부 작업은 다른 프로세스가 변경을 확인할 때까지 기다립니다.
- 처음으로 스토리지를 설정하면 주 GitHub Actions 서비스의
actions-api-server및actions-job-agent라는 두 프로세스를 대기합니다. - GitHub Actions를 업데이트하는 구성 실행은 이름이
-job-agent로 끝나는 작업 에이전트 프로세스를 기다립니다.
이러한 프로세스 중 하나의 백그라운드 작업이 중단되거나 실행이 중지되어 작동이 중지되는 경우 해당 프로세스는 변경 내용을 인식하지 않으므로 해당 프로세스를 기다리는 작업이 실패합니다. 대부분의 다른 GitHub Actions 활동은 큐에 의존하지 않으므로 문제가 며칠 동안 눈에 띄지 않을 수 있으며, 새 리포지토리에 GitHub Actions가 필요하거나 구성 실행이 이를 업데이트할 때까지 그 상태가 계속될 수 있습니다.
GitHub에서 조사한 경우에는 작업이 자체적으로 복구되지 않았습니다.
GitHub Actions 안에는 그것을 다시 시작하는 것이 없고, ghe-actions-check 문제를 감지하지 않습니다.
GitHub Actions 서비스를 다시 시작하면 새 백그라운드 작업으로 새 프로세스가 시작되며, 이로써 문제가 해결됩니다. 작업이 중단되는 이유를 알 수 없으므로 문제가 다시 발생할 수 있습니다.
문제 확인 중
각 GitHub Actions 프로세스는 알림 작업이 작동하는 동안 약 5분마다 하트비트를 기록합니다. 이름이 끝나는 -api-server프로세스에서 작업이 중단되면 해당 프로세스는 1초에 한 번 정도 중단된 작업 메시지를 기록합니다. 이름이 -job-agent로 끝나는 프로세스는 중단된 작업 메시지를 기록하지 않으므로 해당 프로세스의 경우 하트비트만 문제를 표시합니다.
-
관리 셸에 SSH로 접속합니다. 고가용성 구성에서 주 노드에 연결합니다. 클러스터에서 GitHub Actions를 실행하는 각 노드에서 이러한 명령을 실행합니다. 해당 노드를 나열하려면
ghe-cluster-nodes --role actions을 실행합니다. 자세한 내용은 관리 셸(SSH)에 액세스을(를) 참조하세요. -
각 GitHub Actions 프로세스에 대해 지난 15분 동안의 하트비트 및 중단된 작업 메시지를 계산합니다. 15분 이내에 GitHub Actions를 시작하거나 다시 시작한 경우 먼저 15분이 경과할 때까지 기다립니다.
for p in actions-api-server actions-job-agent mps-api-server mps-job-agent token-api-server token-job-agent artifactcache-api-server artifactcache-job-agent; do log=$(sudo journalctl -t "$p" --since '15 min ago' --no-pager) hb=$(grep -c 'Deployment Notification Heartbeat' <<< "$log") case "$p" in *-job-agent) st="n/a" ;; *) st=$(grep -c 'SqlNotificationBackgroundWork.*still running past its interval' <<< "$log") ;; esac echo "$p: $hb heartbeats, $st stalled-task messages" done출력은 다음과 같습니다. 이 예제에서는
actions-api-server에서 알림 작업이 중단되었습니다.actions-api-server: 0 heartbeats, 900 stalled-task messages actions-job-agent: 3 heartbeats, n/a stalled-task messages mps-api-server: 3 heartbeats, 0 stalled-task messages mps-job-agent: 3 heartbeats, n/a stalled-task messages token-api-server: 3 heartbeats, 0 stalled-task messages token-job-agent: 2 heartbeats, n/a stalled-task messages artifactcache-api-server: 3 heartbeats, 0 stalled-task messages artifactcache-job-agent: 3 heartbeats, n/a stalled-task messages -
이 표를 사용하여 각 프로세스의 결과를 읽습니다.
프로세스에 대한 결과 의미 2개 이상의 하트비트 및 몇 개 이하의 중단된 작업 메시지 프로세스가 작동 중입니다. 단일 느린 검사는 몇 가지 중단된 작업 메시지를 기록할 수 있습니다. 하트비트 0개, 반면 다른 프로세스에서 2개 이상 표시 이 프로세스의 알림 작업이 멈춰 있습니다. 약 900개 이상의 중단된 작업 메시지로, 초당 약 1개꼴입니다 이 프로세스의 알림 작업이 정지 상태입니다. 하트비트 1개 또는 몇 개 초과 약 900개 미만의 정지된 작업 메시지 아직 명확하지 않습니다. 15분 동안 기다린 다음 명령을 다시 실행하세요. 모든 프로세스에 대해 0개의 하트비트
GitHub Actions 이 노드에서 실행되고 있지 않습니다. 주 노드 또는 GitHub Actions를 실행하는 클러스터 노드에 연결되어 있는지 확인합니다. |
| 두 artifactcache 프로세스에 대해서만 하트비트 0개 |
GitHub Actions 캐시 서비스를 사용하지 않도록 설정한 경우 이는 예상되는 동작입니다. 자세한 내용은 명령줄 유틸리티을(를) 참조하세요. |
-
중단된 프로세스가 겪고 있는 문제 현상과 일치하는지 확인합니다.
actions-job-agent또는actions-api-server이 중단되면 500 오류가 발생합니다.- 이름이
-job-agent로 끝나는 프로세스가 중단되면 구성 실행이 실패합니다.
프로세스가 중단되지 않았거나 중단된 프로세스가 증상과 일치하지 않는 경우 중단된 알림 작업이 원인일 수 있습니다. GitHub 지원 문의하기를 참조하세요.
-
선택적으로, 이름이
-api-server로 끝나는 프로세스에서 작업이 언제 중단되었는지 확인하려면 가장 최근의 중단된 작업 메시지를 확인합니다. PROCESS-NAME을 프로세스의 이름으로 바꾸십시오.sudo journalctl -t PROCESS-NAME --since '15 min ago' --no-pager | grep 'SqlNotificationBackgroundWork.*still running past its interval' | tail -n 1출력은 다음과 같습니다. 각 메시지는 하나의 긴 줄이며 여기서는 줄여 표시했습니다.
Mar 10 09:15:42 github-example-com-primary actions-api-server[2817]: {"logType": "ProductTrace", "logData": {"PreciseTimeStamp":"2026-03-10 09:15:42.1234","Level":"2", ... "Message":"Background task adcceb44-740e-44e8-a2cf-95c1d38db76c:Microsoft.TeamFoundation.Framework.Server.NotificationProcessor+SqlNotificationBackgroundWork:9442d144-43fd-4fe3-bdca-e460fdee6c01 is still running past its interval time and thus is delaying its next execution.\nThe next execution was supposed to occur 2.10:34:37.0512746 ago at 03/07/2026 22:41:05.", ... }}
ago at 뒤의 날짜와 시간은 작업이 중단된 시점에 관한 것입니다. 표시 시간은 UTC이며, 날짜는 월/일/연도 순서입니다. 앞의 값은 그것이 얼마나 오래전인지를 DAYS.HOURS:MINUTES:SECONDS로 보여줍니다. 일 부분은 하루 이상 전인 경우에만 나타납니다.
문제 해결하기
서비스를 다시 GitHub Actions 시작하십시오. 고가용성 구성에서 모든 명령을 주 노드에서 실행합니다. 클러스터에서 주 MySQL 노드(일반적으로 클러스터 구성 파일에서와 같이 mysql-master 지정된 노드)에서 실행합니다. 자세한 내용은 클러스터 초기화을(를) 참조하세요.
구성 실행이 진행 중인 경우 시작하기 전에 완료되거나 실패할 때까지 기다리세요. 이 문제로 차단된 실행은 15분 이상 후에 실패합니다.
이 문제에 대해 GitHub 지원에 문의하려면 다시 시작하기 전에 GitHub 지원에 문의하기를 읽어봅니다.
경고
GitHub Actions 서비스를 중지하면 다시 시작할 때까지 GitHub Actions를 사용할 수 없습니다. 서비스를 중지할 때 실행되는 작업은 실패할 수 있습니다. 가능하면 실행 중인 워크플로가 거의 없을 때 서비스를 다시 시작하세요. 다시 시작한 후 실패한 작업을 다시 실행하세요. 자체 호스팅 러너는 스스로 다시 연결합니다.
-
관리 셸에 SSH로 접속합니다.
-
GitHub Actions 서비스 및 해당 스토리지가 그 외에는 정상 상태인지 확인합니다.
ghe-actions-check ghe-actions-check -s blob스토리지가 정상이면 두 번째 명령의 출력 마지막 줄은
Blob Storage is healthy!입니다. 명령 중 하나가 서비스가 정상 상태가 되지 않았다고 보고하거나Storage tests failed!를 보고하는 경우 계속하지 마세요. 대신 GitHub 지원에 연락하십시오.ghe-actions-start는 동일한 스토리지 검사를 실행하므로 실패합니다. -
GitHub Actions 서비스를 중지합니다.
ghe-actions-stop각 서비스에 대해 출력에는
Attempting to stop로 시작하는 줄이 포함됩니다. 출력에Failed to stop이 포함된 경우 다음 단계로 계속 진행하여 서비스를 다시 시작한 다음, GitHub 지원에 문의하세요. -
GitHub Actions 서비스를 시작합니다.
ghe-actions-start이 작업은 몇 분 정도 걸릴 수 있습니다. 중단하지 마세요. 완료되면 출력의 마지막 줄은
Actions was enabled!입니다. 즉, 서비스가 준비된 것이 아니라 시작 중이라는 뜻이므로 다음 단계에서 확인합니다. 대신 명령이 오류로 끝나는 경우 GitHub Actions는 사용할 수 없는 상태로 유지될 수 있습니다. GitHub 지원에 바로 연락하십시오. -
서비스가 정상 상태인지 확인합니다. 몇 분 정도 걸릴 수 있습니다.
ghe-actions-check모든 서비스가 정상이면 출력은 다음과 같습니다.
MSSQL is healthy! Mps database is healthy! Mps nomad job is healthy! Mps AT health api is healthy! Token database is healthy! Token nomad job is healthy! Token AT health api is healthy! Actions database is healthy! Actions nomad job is healthy! Actions AT health api is healthy! Artifactcache database is healthy! Artifactcache nomad job is healthy! Artifactcache AT health api is healthy!
GitHub Actions 캐시 서비스를 사용하지 않도록 설정한 경우 Artifactcache 줄이 표시되지 않습니다. 서비스가 시작되는 동안 출력에 다음과 같은 Mps nomad job is not yet healthy (attempt 1 of 20), trying again in 10 seconds...줄이 포함될 수도 있습니다.
ghe-actions-check가 중단된 작업을 감지할 수 없으므로 15분 동안 기다린 다음 문제 확인에서 확인을 다시 실행합니다. 모든 프로세스는 2개 이상의 하트비트를 표시해야 하며, 중단된 작업 메시지는 많아야 몇 개만 표시해야 합니다. GitHub Actions 캐시 서비스를 사용하지 않도록 설정한 경우 두artifactcache프로세스가0를 표시합니다.- 영향을 받은 리포지토리의 GitHub Actions 설정 페이지를 열고 페이지가 로드되는지 확인합니다. 예를 들어 업그레이드 중이기 때문일 수 있으므로 유지 관리 모드가 활성화된 경우 유지 관리 모드를 사용하지 않도록 설정한 후에 이 작업을 수행합니다. 첫 번째 로드는 여전히 실패할 수 있습니다. 이 경우 잠시 기다렸다가 페이지를 다시 로드하세요. 페이지에서 여전히 500 오류를 반환하는 경우 문의하세요 GitHub 지원. 자세한 내용은 리포지토리에 대한 GitHub Actions 설정 관리을(를) 참조하세요.
설정에 실패한 스토리지를 정리할 필요가 없습니다. 다음에 GitHub Actions이(가) 영향을 받는 리포지토리, 사용자, 조직 또는 엔터프라이즈에서 사용될 때 GitHub Actions 필요한 스토리지를 설정합니다. 문제가 발생하고 있던 동안 실행되어야 했던 워크플로는 자체적으로 실행되지 않을 수 있습니다. 필요한 경우 다시 트리거합니다.
실패한 구성 실행 재실행
구성 실행이 Failed to update the following host process로 실패했고 이름이 -job-agent로 끝나는 프로세스가 중단된 경우 GitHub Actions 서비스를 다시 시작한 후 구성 실행을 다시 실행합니다. 작업 에이전트 프로세스가 중단되지 않은 경우 다시 실행하지 마세요. 오류는 다른 원인으로 인해 발생했을 수 있으므로 대신 GitHub 지원에 문의하세요.
구성 실행이 업그레이드의 일부인 경우 유지 관리 모드를 아직 비활성화하지 마세요. 고가용성 구성에서는 모든 복제본을 업그레이드하고 복제가 최신 상태일 때까지 유지 관리 모드를 유지합니다. 자세한 내용은 업그레이드 패키지를 사용하여 업그레이드을(를) 참조하세요.
클러스터에서 다음 단계를 수행하지 마세요. 대신 GitHub 지원에 연락하십시오.
경고
ghe-config-apply을 실행하면 서비스가 중단됩니다.
-
유지 관리 모드를 아직 사용하도록 설정하지 않은 경우 사용하도록 설정합니다. 자세한 내용은 유지 관리 모드 사용 설정 및 예약을(를) 참조하세요.
-
구성을 적용하세요.
ghe-config-apply구성 실행이 다시 실패하면 유지 관리 모드를 사용하도록 설정한 상태로 두고 GitHub 지원에 문의하세요.
-
구성 실행이 성공하면 유지 관리 모드를 사용하지 않도록 설정합니다. 고가용성 구성을 업그레이드하는 경우 먼저 모든 복제본을 업그레이드하고 복제가 최신 상태가 될 때까지 기다립니다.
재발 방지
GitHub 는 작업이 중단되는 이유를 알지 못하므로 이를 방지하는 알려진 방법은 없습니다. 사용자에게 영향을 미치기 전에 찾을 수 있습니다.
- 업그레이드하거나 핫패치를 적용하기 전에 문제 확인에 설명된 대로 중단된 알림 작업을 확인합니다. 하나를 찾으면 먼저 GitHub Actions 서비스를 다시 시작합니다. 이렇게 하면 중단된 작업이 구성 실행을 실패하게 만드는 것을 막을 수 있습니다.
- 로그를 모니터링 시스템으로 전달하는 경우
Deployment Notification Heartbeat프로세스가 15분이 넘도록 GitHub Actions를 로그하지 않으면 경고합니다. 또한 메시지에SqlNotificationBackgroundWork와still running past its interval가 모두 포함되어 15분 이상 계속 도착하는 경우 경고합니다. 자세한 내용은 로그 전달을(를) 참조하세요.
연락하기 GitHub 지원
다른 문제로 인해 동일한 500 오류 및 구성 실패가 발생할 수 있습니다. 검사에서 중단된 알림 작업을 찾지 못하거나, 다시 시작한 후 작업이 다시 중단되거나, ghe-actions-stop에서 ghe-actions-start이(가) 출력되거나, ghe-actions-check 또는 GitHub 지원에서 오류를 보고하거나, 이러한 단계 중 어느 것이라도 확실하지 않은 경우에는 계속하지 말고 Failed to stop에 문의하세요. 자세한 내용은 지원 티켓 만들기을(를) 참조하세요.
이미 티켓을 연 경우 지원 번들을 첨부하면 GitHub 지원 문제를 더 빠르게 진단하는 데 도움이 됩니다. 서비스를 다시 시작하기 GitHub Actions 전에 문제를 알아차리는 즉시 확장 지원 번들을 생성합니다. 작업이 중단된 시점의 로그가 가장 유용하며 며칠이 지난 것일 수 있습니다. 확장 지원 번들에는 지난 8일간의 로그가 포함됩니다. 자세한 내용은 GitHub 지원에 데이터 제공을(를) 참조하세요.