설정 파일이 폴더에 있다고 프로그램이 그 값을 읽는 것은 아니었다. K-POP PULSE의 9월 운영 기록은 앱이 설정 파일을 직접 읽지 않고 실행기가 먼저 읽어 넘기는 구조를 명시했다. 나는 파일을 확인한 것과 실제 실행 환경을 확인한 것을 나누려 한다.
이 글은 설정이 빠져 실제 장애가 났다는 사건을 새로 만드는 이야기가 아니다. 제공된 코드 읽기와 문서 수정에서 확인한 실행 구조를 풀어 보는 글이다. 같은 프로그램을 다른 컴퓨터나 예약 실행에서 이어 돌릴 때 무엇을 먼저 확인할지 남긴다.
설정 파일과 실행 환경은 서로 다른 대상이다
값을 보관하는 파일과 프로그램이 받는 환경은 같지 않다. 어떤 코드가 파일을 읽고 어떤 방식으로 새 프로세스에 넘기는지 있어야 연결된다. 이 프로젝트의 안내는 그 일을 실행 스크립트의 책임으로 두었다. 모든 프레임워크가 같은 방식이라는 뜻은 아니다.
다른 사이트를 이어 작업할 때도 파일 이름만 보고 준비됐다고 판단하지 않는다. 해당 앱이 직접 읽는지, 실행기가 읽는지, 배포 플랫폼의 설정으로 전달하는지 정본 코드를 확인한다. 지금 프로그램을 시작한 경로가 그 설정 전달 단계를 지나가는지도 함께 읽는다.
프로젝트 위치와 인터프리터를 실행기에 남겼다
실제 공용 실행기 읽기 결과는 프로젝트 위치로 이동하고 프로젝트의 가상환경 Python을 선택하는 구조를 보여 준다. 웹과 관리용 실행 스크립트는 그 공용 설정 읽기를 거친 뒤 프로그램을 시작했다. 현재 이 PC에서 원본 실행기를 돌렸다는 결과와는 구별한다.
실행 위치가 달라지면 상대 경로나 라이브러리가 달라질 수 있다. 같은 이름의 Python을 불렀다는 사실만으로 같은 환경이 되지 않는다. 나는 실행기의 프로젝트 경로와 인터프리터 선택, 호출 순서를 함께 남겨 다음 작업자가 필요한 파일을 찾을 수 있게 하려 한다.
읽을 수 없는 파일의 처리를 코드에서 확인했다
공용 실행기는 설정 파일을 읽을 수 없으면 오류로 끝내는 조건을 가지고 있었다. 이는 누락 상태를 조용히 넘기지 않으려는 코드의 계약이다. 그 조건이 있다는 사실과 당시 실제로 그 오류가 발생했다는 사실은 다르다. 이번 근거는 조건을 읽은 결과다.
반대로 파일을 읽었다고 필요한 키가 모두 유효하거나 외부 연결 권한이 있다는 뜻은 아니다. 필수 이름과 값의 공급 여부, 실제 호출이 가능한 범위를 나누어 확인한다. 비어 있는 설정과 틀린 자격정보, 잘못된 대상 연결은 같은 상태로 보고할 수 없다.
확인할 것은 남기되 값을 출력하지 않는다
나는 확인용 로그에서 비밀값을 그대로 보여 주는 방식을 피하려 한다. 필요한 이름이 공급됐는지, 어떤 실행 경로를 사용했는지처럼 다음 작업에 필요한 상태를 남긴다. 이름의 존재가 자격정보의 진실성을 증명하는 것은 아니므로 연결 확인도 별도로 수행한다.
아래는 다른 홈페이지에 적용할 새 책임 지도다. 실제 설정 파일과 키, 원본 실행 명령을 공개한 것이 아니다. 어떤 단계가 어느 정보를 공급해야 하는지 정하는 출발점이다. 파일 경로나 필드 이름 자체도 민감할 수 있으므로 실제 결과를 공유할 때 공개 범위를 확인한다.
코드와 구현 살펴보기
새 설명용 환경 전달 지도. 실제 설정값이나 실행기가 아니다.
{
"configuration": "an explicitly selected trusted local file",
"launcher": "loads and exports the needed settings before execution",
"working_directory": "the intended project root",
"runtime": "the inspected project interpreter",
"report": "required-name presence only, without values"
}
// New responsibility map. Presence does not authenticate a key or prove a connection.새 실행 방식에서도 같은 조건을 다시 확인한다
터미널에서 작업하던 프로그램을 다른 실행 서비스로 옮기면 내가 익숙하게 가진 설정을 새 실행도 받는지 확인해야 한다. 이 프로젝트의 공용 실행기 주석도 서비스 실행의 환경 차이를 고려한 이유를 남겼다. 주석을 모든 운영체제의 환경에 대한 보편적 진단으로 확대하지 않는다.
나는 어떤 실행기로 시작하고 무엇을 읽으며 어떤 작업 위치와 환경을 사용하는지를 운영 설명서에 같이 둔다. 홈페이지가 계속 바뀌어도 그 경로를 찾을 수 있어야 한다. 설정 파일이 있다는 보고보다 프로그램이 필요한 정보를 받은 범위를 읽을 수 있는 설명이 다음 작업에 도움이 된다.
파일을 고친 것과 실행 중인 값의 확인을 나눈다
설정 파일을 수정했다는 결과와 이미 시작한 프로그램이 새 설정을 사용하는지 확인한 결과도 다르다. 이 프로젝트처럼 실행기가 시작 전에 값을 넘기는 구조에서는 현재 실행이 언제 어떤 경로에서 시작됐는지 다시 읽을 필요가 있다. 파일의 최신 상태만 보아서는 전달 단계를 확인할 수 없다.
나는 반영이 필요할 때도 먼저 담당 프로세스와 그 사이트의 실행 절차를 확인하려 한다. 다른 작업자가 쓰는 프로그램을 임의로 다시 띄우는 것을 설정 검수와 같은 행동으로 두지 않는다. 이번 글은 원본 프로세스의 현재 환경을 읽거나 재시작한 결과가 아니라, 그 확인 책임을 코드 구조에서 찾아 설명한 기록이다.