Files
slp-modular-cms/aidlc-docs/features/identity-email-notifications/operations/plans/operations-questions.md
T

4.2 KiB

Operations questions - identity-email-notifications

Nothing here is executed until the questions are answered (through the "CMS & API" session). Context: mail is built and tested; it is live (switched on) on ASF test only once its sender address and TLS mode are settled, and off on SlpSoftware test until its host gets the settings. Production for both sites is not part of the current approval.

Question 1: Rolling the mail settings out

How do the mail settings reach each host?

  • A) By hand by Pi-Main in the host's shared/env (mode 600), using the variable list in the infrastructure design (secrets stay out of Gitea); nothing in CI changes
  • B) The non-secret settings (App__PublicBaseUrl, Email__FromName, ...) come from Gitea variables written by the deploy workflow; only the SMTP credentials are set by hand
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 2: Order of the roll-out

  • A) ASF test (done) then SlpSoftware test, each with its own SMTP host, then production of each site later, one at a time, each needing its own approval
  • B) ASF test, then straight to both productions together after the real test mails succeed
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 3: The sender account for ASF

  • A) A dedicated mailbox/account on mail.andreaslop.nl (for example no-reply@andreaslop.nl) created by Bryan for this purpose; its address goes into Email__FromAddress and Email__AllowedFromAddresses__0
  • B) An existing mailbox of the site (for example info@andreaslop.nl), accepting that replies reach that mailbox
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 4: Which mail problems should raise an alert

Today a failed mail is logged at Warning level (journal only; Sentry sees Error events and uses Warnings only as breadcrumbs), and a bad mail configuration at start-up is an Error (Sentry sees it). What do you want?

  • A) Nothing more: failed mails are looked at in the journal when somebody reports a problem
  • B) Raise the log level to Error (so Sentry sends an alert to Bryan) for mail failures that point to a configuration problem: auth_failed, rejected_sender, tls_failed, not_configured; keep timeouts and recipient problems at Warning
  • C) B, plus an alert when the same host fails at least three mails in fifteen minutes whatever the reason (a Sentry rule on the events)
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 5: Start-up check after a release

  • A) The deploy's existing /health check stays as it is; after changing mail settings the person doing it reads the journal for mail_status enabled=true or mail_configuration_invalid (written in the runbook)
  • B) A) plus the CMS reports emailEnabled on /health details so a pinger can see that mail is off on a host that should have it
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 6: Deliverability (SPF, DKIM, DMARC) before production

Facts today: both slpsoftware.nl and andreaslop.nl have SPF (a mx include:smtp.spf.ziggo.nl), a dkim record and DMARC p=none.

  • A) Before production: send test mails to a Gmail and an Outlook mailbox, check in "show original" that SPF, DKIM and DMARC pass and are aligned with the From domain; leave DMARC at p=none for now and revisit it later
  • B) A), and tighten DMARC to p=quarantine for the site's domain before production
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 7: Rollback

Rolling a release back keeps the three additive database changes (older code simply ignores the new columns and table).

  • A) To switch mail off quickly: remove Email__Smtp__Host from shared/env and restart the unit (the copy-link flow keeps working); for a bad release use the existing previous-release switch of the deploy
  • B) A), and additionally a documented way to drop the new columns/table (only if a restore is ever needed)
  • X) Other (please describe after [Answer]: tag below)

[Answer]:

Question 8: Who approves production readiness for this feature

  • A) Bryan, after the real test mails on ASF test and SlpSoftware test and the answers above are carried out
  • X) Other (please describe after [Answer]: tag below)

[Answer]: