docs: 운영 배포 · 파일럿에서 겪은 것 — 인증서 이름 · mailcow 나가는 IP · 가비아 TXT 조각 #8

Merged
ttipo merged 1 commits from docs/pilot-deploy-notes into main 2026-10-31 11:07:46 +09:00
Owner

2026-10-31 운영 서버 첫 배포와 파일럿 공존을 켜며 실제로 막힌 것을 mail/README 에 적었다.

  • 도메인 자동 인증서의 Additional Hostnames 를 비우면 기본 이름 묶음을 한 주문으로 요청해, 옛 서버를 가리키는
    autoconfig 등 때문에 mx1 까지 못 받고 자체 서명 인증서를 냈다 — mx1 만 넣고 AcmeRenewal 한 번.
  • mailcow 는 받는 IP 와 나가는 IP 가 달랐다 — Transport Map Test 가 550 5.7.1 이면 새 서버 로그의 remoteIp 로 찾아 목록에 더한다.
  • 가비아는 TXT 조각마다 250자 미만이라 RSA DKIM 을 다시 나눠 넣는다(명령 포함).
  • 첫 전달의 mailcow 451 지연, Gmail 의 ed25519 neutral, Spamhaus 시험 일시 SERVFAIL, 새 셸의 MAIL_ADMIN_URL 은 문제 해결 줄로.

Co-Authored-By: Claude Opus 5.5 noreply@anthropic.com

무엇을 · 왜

확인 방법

영향 범위

  • backend
  • frontend
  • flutter
  • docker / 인프라
  • 규칙 문서(.claude/)

공유 계약(에러 코드 · 응답 포맷 · 페이지네이션 · API 규약)을 바꿨다면
세 스택에 미치는 영향을 아래에 구체적으로 적어 주세요.

체크리스트

  • 린트/분석 통과 (Warning 0) · 변경 영역 테스트 통과
  • 주석 한국어, 매직 넘버·하드코딩 문자열 없음
  • 사용자 노출 실패는 모두 에러 코드와 함께 처리 (BusinessException / error.code 분기)
  • 에러 코드를 바꿨다면 npm run sync:error-codes 실행 후 생성 파일까지 커밋
  • 민감정보 미커밋 (*.example 값은 placeholder)
  • 로그에 비밀번호·토큰·요청 본문 전체가 남지 않음
2026-10-31 운영 서버 첫 배포와 파일럿 공존을 켜며 실제로 막힌 것을 mail/README 에 적었다. - 도메인 자동 인증서의 Additional Hostnames 를 비우면 기본 이름 묶음을 한 주문으로 요청해, 옛 서버를 가리키는 autoconfig 등 때문에 mx1 까지 못 받고 자체 서명 인증서를 냈다 — mx1 만 넣고 AcmeRenewal 한 번. - mailcow 는 받는 IP 와 나가는 IP 가 달랐다 — Transport Map Test 가 550 5.7.1 이면 새 서버 로그의 remoteIp 로 찾아 목록에 더한다. - 가비아는 TXT 조각마다 250자 미만이라 RSA DKIM 을 다시 나눠 넣는다(명령 포함). - 첫 전달의 mailcow 451 지연, Gmail 의 ed25519 neutral, Spamhaus 시험 일시 SERVFAIL, 새 셸의 MAIL_ADMIN_URL 은 문제 해결 줄로. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> ## 무엇을 · 왜 <!-- 무엇을 바꿨고 왜 필요한지 적습니다. "무엇을"은 diff 가 말해주므로 "왜"에 비중을 둡니다. --> ## 확인 방법 <!-- 리뷰어가 동작을 확인할 수 있는 절차나 명령을 적습니다. --> ## 영향 범위 - [ ] backend - [ ] frontend - [ ] flutter - [ ] docker / 인프라 - [ ] 규칙 문서(.claude/) > **공유 계약(에러 코드 · 응답 포맷 · 페이지네이션 · API 규약)을 바꿨다면** > 세 스택에 미치는 영향을 아래에 구체적으로 적어 주세요. ## 체크리스트 <!-- 자세한 항목은 .claude/rules/checklist.md 참조 --> - [ ] 린트/분석 통과 (Warning 0) · 변경 영역 테스트 통과 - [ ] 주석 한국어, 매직 넘버·하드코딩 문자열 없음 - [ ] 사용자 노출 실패는 모두 에러 코드와 함께 처리 (`BusinessException` / `error.code` 분기) - [ ] 에러 코드를 바꿨다면 `npm run sync:error-codes` 실행 후 생성 파일까지 커밋 - [ ] 민감정보 미커밋 (`*.example` 값은 placeholder) - [ ] 로그에 비밀번호·토큰·요청 본문 전체가 남지 않음
ttipo added 1 commit 2026-10-31 04:36:07 +09:00
docs: 운영 배포 · 파일럿에서 겪은 것 — 인증서 이름 · mailcow 나가는 IP · 가비아 TXT 조각
CI / Backend (lint · type-check · test · e2e · build) (pull_request) Failing after 7m54s
CI / Frontend (lint · type-check · test · build) (pull_request) Successful in 11m47s
CI / Infra (compose · Dockerfile · nginx) (pull_request) Successful in 1m3s
CI / 에러 코드 SSOT 동기화 검사 (pull_request) Successful in 11m30s
CI / Backend (lint · type-check · test · e2e · build) (push) Successful in 18m44s
CI / Frontend (lint · type-check · test · build) (push) Successful in 15m7s
CI / Infra (compose · Dockerfile · nginx) (push) Successful in 1m22s
CI / 에러 코드 SSOT 동기화 검사 (push) Successful in 12m21s
a8ea204e47
2026-10-31 운영 서버 첫 배포와 파일럿 공존을 켜며 실제로 막힌 것을 mail/README 에 적었다.
- 도메인 자동 인증서의 Additional Hostnames 를 비우면 기본 이름 묶음을 한 주문으로 요청해, 옛 서버를 가리키는
  autoconfig 등 때문에 mx1 까지 못 받고 자체 서명 인증서를 냈다 — mx1 만 넣고 AcmeRenewal 한 번.
- mailcow 는 받는 IP 와 나가는 IP 가 달랐다 — Transport Map Test 가 550 5.7.1 이면 새 서버 로그의 remoteIp 로 찾아 목록에 더한다.
- 가비아는 TXT 조각마다 250자 미만이라 RSA DKIM 을 다시 나눠 넣는다(명령 포함).
- 첫 전달의 mailcow 451 지연, Gmail 의 ed25519 neutral, Spamhaus 시험 일시 SERVFAIL, 새 셸의 MAIL_ADMIN_URL 은 문제 해결 줄로.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
ttipo merged commit a8ea204e47 into main 2026-10-31 11:07:46 +09:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ttipo/arasystem#8