Files
Gnuboard7/tests/Unit/Services/CoreUpdateRuntimeOwnershipTest.php
T
HeuJung 0253c1aa68 fix(core): sudo 업데이트의 root 캐시 산출물 소유권 정상화 + 캐시 쓰기 fail-soft
클린 7.0.9→7.0.10 실서버 업그레이드에서 전면 500 재발. 치명점을 캐시 파일
내용 역산으로 확정 — sha1('g7:_idx:g7:core') = 모든 remember 가 갱신하는
G7 캐시 키 인덱스 파일이 업데이트 마지막 root 쓰기(cache:clear 직후 버전
bump·상태/훅 캐시 재생성)로 root 소유 생성되면, 웹 프로세스의 모든 캐시
쓰기가 인덱스 갱신에서 Permission denied 로 죽어 부팅 경로가 500 이 된다
(로거 도달 전이라 laravel.log 공백). 직전 커밋의 자식측 게시 게이트만으로
부족했던 이유: 마지막 root 쓰기의 주체가 구코드 부모라 그 이후에 신코드가
개입할 지점이 없다.

- 원인 수정: CoreUpdateService::normalizeRuntimeOwnershipAfterRootRun —
 root 실행 시 storage/framework/cache·bootstrap/cache·storage/app/ext-bundles
 를 디렉토리 소유자 기준 재귀 정상화 + 그룹 쓰기 동기(업그레이드 로그
 정상화 선례 확장). 부모·자식 커맨드의 모든 흐름 종료부에 짝으로 배선 —
 이후 업데이트는 root 산출물을 남기지 않고 과거 잔재도 재귀 자가 수복
- 안전망: AbstractCacheDriver 쓰기 fail-soft — put/forget/putMany 는 false,
 remember 는 콜백 1회 실행 보장 후 저장 실패를 삼키고 결과 반환(무캐시
 동작), 경고 로그는 조합당 프로세스 1회. 구코드가 남긴 오염처럼 신코드가
 선제 개입 못 하는 상황에서도 화면이 죽지 않는다 — 캐시는 최적화다
- red→green: CacheDriverWriteFailSoftTest 4케이스, CoreUpdateRuntimeOwnershipTest
 (비-root no-op + 종료부 짝 호출 소스 훑기)
2026-08-25 19:00:12 +09:00

56 lines
2.2 KiB
PHP

<?php
namespace Tests\Unit\Services;
use App\Services\CoreUpdateService;
use Tests\TestCase;
/**
* 업데이트 종료 시 root 산출물 소유권 정상화 (실사례: 7.0.9→7.0.10 전면 500).
*
* sudo 업데이트가 캐시 키 인덱스·상태 캐시·병합 번들을 root 소유로 남기면
* 웹 프로세스의 캐시 쓰기가 Permission denied 로 죽는다. 업데이트 흐름의
* 모든 쓰기가 끝난 종료 지점에서 런타임 디렉토리를 기준 소유자(디렉토리
* 자신의 소유자)로 재귀 정상화해 root 산출물이 남지 않게 한다.
*/
class CoreUpdateRuntimeOwnershipTest extends TestCase
{
/**
* 비-root 프로세스에서는 no-op 이다 (chown 자체가 불가능하고 불필요).
*/
public function test_non_root_process_is_noop(): void
{
$service = app(CoreUpdateService::class);
// 예외 없이 종료해야 한다 (Windows/비-root: posix 가드로 즉시 반환)
$service->normalizeRuntimeOwnershipAfterRootRun();
$this->assertTrue(true);
}
/**
* 부모(CoreUpdateCommand)·자식(ExecuteUpgradeStepsCommand) 흐름 종료부가
* 정상화를 호출한다 — 로그 소유권 정상화(restoreUpgradeLogOwnership)와
* 항상 짝으로 (#519 소스 훑기 선례).
*/
public function test_update_flows_invoke_runtime_ownership_normalization(): void
{
foreach ([
app_path('Console/Commands/Core/CoreUpdateCommand.php'),
app_path('Console/Commands/Core/ExecuteUpgradeStepsCommand.php'),
] as $file) {
$source = (string) file_get_contents($file);
$logCalls = substr_count($source, '$this->restoreUpgradeLogOwnership();');
$normalizeCalls = substr_count($source, 'normalizeRuntimeOwnershipAfterRootRun');
$this->assertGreaterThan(0, $logCalls, basename($file).': 로그 소유권 정상화 호출이 사라졌습니다');
$this->assertGreaterThanOrEqual(
$logCalls,
$normalizeCalls,
basename($file).': 흐름 종료부(restoreUpgradeLogOwnership 호출 지점)마다 런타임 소유권 정상화가 짝으로 호출되어야 합니다'
);
}
}
}