공개 전환 Workflow는 성공으로 끝났지만 실제 도메인에서는 다른 서비스의 인증서가 보이고, health도 의도한 앱이 아닌 다른 서비스 응답을 반환했습니다. 자동화 성공 표시만 보고 끝냈다면 잘못된 상태가 운영에 남을 수 있었습니다.
진단 순서
먼저 Nginx server_name과 인증서 참조, 로컬 HTTP/HTTPS 응답, DNS, 실제 제시되는 인증서를 읽기 전용 진단으로 확인했습니다. 이 과정에서 runner의 sudo 권한 문제와 롤백 함수가 실패 코드를 삼키는 문제를 각각 분리했습니다.
수정 방법
기존 배포센터에서 사용하던 Docker privileged + host chroot 패턴을 재사용해 root 권한 작업을 수행했습니다. Nginx reload 직후에는 한 번만 확인하지 않고 재시도 검증을 넣고, 실패하면 롤백 뒤 실제 실패코드로 종료하도록 수정했습니다.
최종 검증
star45.net과 www.star45.net 모두 HTTPS 인증서, FAMOS health, 홈 콘텐츠를 확인했습니다. 공개 전환 완료 조건을 Workflow 상태가 아니라 실제 외부 응답으로 바꾼 것이 핵심입니다.
재사용 체크리스트
- Workflow 성공과 실제 공개 성공을 분리합니다.
- 인증서 SAN과 Nginx server_name을 모두 확인합니다.
- 로컬·공인·실제 도메인 응답을 비교합니다.
- 롤백 경로가 실패 상태를 숨기지 않는지 확인합니다.
실제 문제와 검증 로그를 기준으로 원인·수정·완료 기준을 분리했습니다.
추가 분석: 인증서와 공개 페이지의 검사를 구분하는 이유
도메인 전환에서 인증서가 정상이어도 웹 서버가 다른 앱을 보여주면 공개 전환이 끝난 것이 아닙니다. 반대로 앱이 직접 주소에서 열려도 공개 도메인의 연결이 잘못되면 독자는 사용할 수 없습니다. 저는 도메인, 인증서, 웹 서버 목적지, 실제 페이지 내용을 서로 다른 확인 항목으로 나눠 읽도록 정리했습니다.
이번 기록에 없는 장애 원인이나 성능 수치를 추가로 추정하지 않습니다. 같은 오류 코드가 보여도 인증서 문제, 경로 문제, 앱의 응답 실패는 다른 원인이 될 수 있습니다. 수정한 뒤에는 원래 사용자가 접근한 공개 주소에서 다시 확인해야 합니다. 보안 경고를 무시하거나 인증서 검사를 끄는 행동을 정상 복구 절차로 소개하지 않습니다.
직접 따라 해보기
누가 하나요?
실제 사이트 개선 과정을 읽고 자신의 작업에 적용할 작성자·운영자
찾아갈 곳
사례 게시판과 공개 검증 기록에서 현재 기록을 읽습니다.
그대로 복사할 것
문제와 발생 위치: 수정 전 상태: 바꾼 한 가지: 직접 확인한 화면 / 결과: 아직 확인하지 못한 부분: 다음 행동:
실행자가 직접 할 행동
- 문제의 실제 화면과 입력 조건을 기록합니다.
- 수정할 범위를 한 가지로 정하고 이전 상태를 보존합니다.
- 수정 후 원래 문제가 발생한 경로에서 결과를 읽습니다.
- 확인한 결과와 미검증 기능을 구분해 저장합니다.
끝났는지 확인하는 방법
원래 경로에서 문제가 해결되고 기존 데이터와 권한이 유지됐는지 확인한 범위만 완료로 기록합니다. 다른 서비스 연동은 별도 검증이 필요합니다.
추가 확인 자료와 한계
이 보강은 기존 사례의 원문을 보존하고 선택 이유·실패 분기를 추가한 AI 보조 편집입니다. 인간 작성 비율이나 업무 효율을 측정한 기록이 아닙니다. 추가 검증 기록에서 실제 함수 검사와 설명용 예시를 구분해 읽을 수 있습니다. 문제가 다시 발생하면 원문과 실제 화면을 대조하고 문의에 공개 가능한 최소 정보를 남겨주세요.
HTTPS 실패와 화면 오류를 구분하는 확인표
| 관찰 위치 | 보이는 결과 | 다음에 대조할 것 |
|---|---|---|
| 브라우저가 페이지를 열기 전 | 인증서 보안 경고 | 요청한 도메인, 인증서 대상 이름과 유효기간 |
| HTTPS 연결 뒤 | 500 또는 502 응답 | 같은 시각의 웹 서버 로그와 앱 응답 |
| 홈은 열리지만 예상 화면과 다름 | 이전 화면 또는 다른 앱 | 요청 호스트와 Nginx 목적지, 공개 앱 버전 |
| health는 정상인데 글이 안 열림 | health 200, 개별 글 오류 | health와 실제 글 주소를 별도 검사 |
이 글의 문제는 배포 단계의 성공 표시만으로 공개 주소까지 정상이라고 판단한 데 있습니다. HTTPS 연결, 웹 서버 응답, 앱 내용은 다른 층의 관찰입니다. 응답 코드 하나로 인증서 문제가 해결됐다고 쓰지 않고, 보안 경고 없이 공개 주소가 열리는지와 예상한 FAMOS 화면이 나오는지를 나눠 기록합니다.
위 표는 오류를 분류하는 방법입니다. 특정 응답이 보였다는 이유만으로 원인을 확정하거나 DNS·인증서를 교체하라는 지시는 아닙니다. 운영 설정을 바꾸기 전 현재 목적지와 복구 지점을 보존하고 로그의 관찰 시각을 맞춥니다. 비밀번호·환경 파일과 서버 내부 경로는 공개 기록에서 제외합니다.
2026년 10월 8일 편집: 공통 운영 문단을 HTTPS·응답·앱 내용의 진단표로 바꾸었습니다. 표에 적힌 오류를 모두 재현했다는 뜻은 아닙니다.
공유된 첨부파일이 없습니다.