From e8d557b77a3f343228c9ce8b55a228cd66703ba9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Micha=C5=82=20Pasternak?= Date: Sat, 25 Jul 2026 01:05:27 +0200 Subject: [PATCH] docs(env): udokumentuj DJANGO_BPP_ROLLBAR_IGNORE_SMTP_AUTH_ERRORS MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Nowa zmienna w BPP (iplweb/bpp#678) wycisza w Rollbarze smtplib.SMTPAuthenticationError na konkretnej instalacji. Powod: na bpp.umlub.pl serwer SMTP uczelni odrzuca poswiadczenia (535 5.7.3), co jest awaria po stronie administratorow poczty klienta - nie naprawimy tego kodem, a kazda nieudana wysylka powiadomienia zasila ten sam item w Rollbarze. Zmiana jest wylacznie dokumentacyjna. Zmienna nalezy do konfiguracji aplikacji, czyli ${BPP_CONFIGS_DIR}/.env, a nie do tego repo - wpisanie jej tutaj wlaczyloby wyciszenie WSZEDZIE. Wzorzec komentarza w .env.sample opisujacego zmienna z drugiego pliku jest juz w repo uzywany dla DJANGO_BPP_HTML2DOCX_URL. Nie trzeba ruszac compose'ow: appserver (docker-compose.application.yml) i workerserver (docker-compose.workers.yml) ladują ${BPP_CONFIGS_DIR}/.env przez `env_file`, wiec zmienna dociera do obu automatycznie. Worker jest tu istotny - wyjatek leci z djcelery_email, nie z requestu. Co-Authored-By: Claude Opus 5 (1M context) Claude-Session: https://claude.ai/code/session_01NcAqeqyqBzNEkkVnhpHDaH --- .env.sample | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/.env.sample b/.env.sample index 464d78b..738bafb 100644 --- a/.env.sample +++ b/.env.sample @@ -33,3 +33,36 @@ BPP_CONFIGS_DIR= # Opcjonalny pin wersji obrazu: HTML2DOCX_VERSION= (domyslnie latest). # # COMPOSE_PROFILES= + +# ── Wyciszenie bledow uwierzytelniania SMTP w Rollbarze ────────────────── +# +# Ustawiane PER INSTALACJA i domyslnie WYLACZONE. Wlaczaj tylko tam, gdzie +# administratorzy poczty po stronie klienta maja ZNANA i ZGLOSZONA awarie +# (serwer SMTP odrzuca poswiadczenia, `535 5.7.3 Authentication +# unsuccessful`), ktorej nie da sie naprawic po naszej stronie. Bez tego +# kazda nieudana wysylka powiadomienia zasila w Rollbarze ten sam item +# w nieskonczonosc. +# +# Zmienna nalezy do konfiguracji APLIKACJI, wiec wpisz ja w +# ${BPP_CONFIGS_DIR}/.env (NIE w tym pliku): +# +# DJANGO_BPP_ROLLBAR_IGNORE_SMTP_AUTH_ERRORS=1 +# +# Trafi wtedy automatycznie do appservera I workera Celery - oba serwisy +# ladują ten plik przez `env_file`. Worker jest tu istotny: wyjatek leci +# z `djcelery_email`, a nie z requestu, wiec ustawienie samego appservera +# NIC by nie dalo. +# +# UWAGA - zakres jest waski i celowo taki zostal: +# - wycisza WYLACZNIE smtplib.SMTPAuthenticationError, +# - NIE wycisza SMTPRecipientsRefused (zly adres w NASZEJ bazie) ani +# SMTPSenderRefused (nasza konfiguracja DEFAULT_FROM_EMAIL) - jedno +# i drugie jest do naprawienia po naszej stronie. +# +# UWAGA - to NIE naprawia poczty. Dopoki klient nie odblokuje SMTP-a, +# powiadomienia o zgloszeniach publikacji nie docieraja do redakcji, +# a zgloszenia leza w bazie niezauwazone. Po naprawie po stronie klienta +# USUN te zmienna, zeby odzyskac sygnal o awariach poczty. +# +# Przy konfiguracji wielotenantowej (DJANGO_BPP_HOSTNAMES) ustawienie +# dziala na WSZYSTKIE uczelnie obslugiwane przez dany proces.