E-posta teslimi

Kubernetes dağıtımından etkinleştirme, davet ve parola sıfırlama e-postaları gönderin.

web hizmeti tüm e-postaları (etkinleştirme, proje davetleri, parola sıfırlama) her Ayakaleaf Pro pod’undan gönderir. Ayarlar Toolkit ile aynıdır; bkz. E-posta teslimi.

Hizmet	web, her Ayakaleaf Pro pod’unda; web başlarken okunur
Pod → dış dünya	SMTP sunucunuz (OVERLEAF_EMAIL_SMTP_HOST) veya OVERLEAF_EMAIL_AWS_SES_REGION bölgesinin Amazon SES API’si
Durum	Redis’teki gönderim hız sınırı
Periyodik işler	yok

​

Yapılandırma

1. ConfigMap

   30-config.yaml (additions)

     OVERLEAF_EMAIL_FROM_ADDRESS: [e-mail]
     OVERLEAF_EMAIL_SMTP_HOST: smtp.example.com
     OVERLEAF_EMAIL_SMTP_PORT: "587"
     OVERLEAF_EMAIL_SMTP_SECURE: "false"
     OVERLEAF_EMAIL_SMTP_USER: [e-mail]
     # optional
     # OVERLEAF_EMAIL_REPLY_TO: [e-mail]
     # OVERLEAF_EMAIL_SMTP_IGNORE_TLS: "false"
     # OVERLEAF_EMAIL_SMTP_TLS_REJECT_UNAUTH: "true"
   

   OVERLEAF_EMAIL_FROM_ADDRESS gönderimi açar. Bunu yalnızca SMTP sunucusuyla (veya SES ile) birlikte ayarlayın: yalnızca gönderici ayarlandığında Ayakaleaf Pro pod içindeki bir SMTP sunucusunu dener ve her e-posta başarısız olur. Bu ayar olmadan e-postalar gönderilmez, yalnızca web.log dosyasına yazılır.

   OVERLEAF_EMAIL_SMTP_SECURE, OVERLEAF_EMAIL_SMTP_IGNORE_TLS ve OVERLEAF_EMAIL_SMTP_TLS_REJECT_UNAUTH JSON olarak okunur; bu nedenle "true" veya "false" kullanın: yes gibi bir değer, başlangıçta pod’un tüm hizmetlerini durdurur.

2. Secret

   kubectl -n overleaf patch secret overleaf-secrets --type merge \
     -p '{"stringData":{"OVERLEAF_EMAIL_SMTP_PASS":"<SMTP password>"}}'
   

   Amazon SES API’si için bunun yerine buraya OVERLEAF_EMAIL_AWS_SES_ACCESS_KEY_ID ve OVERLEAF_EMAIL_AWS_SES_SECRET_KEY değerlerini, ConfigMap’e ise OVERLEAF_EMAIL_DRIVER: ses ve OVERLEAF_EMAIL_AWS_SES_REGION değerlerini koyun.

3. Uygulayın, yeniden başlatın ve test edin

   kubectl apply -f 30-config.yaml
   kubectl -n overleaf rollout restart deployment/overleaf     # or statefulset/overleaf
   

   Oturum açma sayfasından kendinize bir parola sıfırlama e-postası gönderin. Gelmezse SMTP sunucusuna pod’lardan erişilebildiğini kontrol edin ve web günlüğüne bakın:

   kubectl -n overleaf exec deploy/overleaf -- bash -c 'echo > /dev/tcp/smtp.example.com/587 && echo reachable'
   kubectl -n overleaf exec deploy/overleaf -- grep -iE "email|smtp" /var/log/overleaf/web.log | tail
   

​

Birden fazla replika

Ek bir şey gerekmez. Her replika aynı ayarlarla gönderir ve gönderim hız sınırı tüm replikalar genelinde Redis’te sayılır. SMTP sunucunuz yalnızca bilinen göndericileri kabul ediyorsa, pod’ların kümeden çıktığı adreslere (genellikle düğümlerinkine) izin verin.

​

Kubernetes üzerinde test edildi

SMTP sunucusu olarak Mailpit ile, tek replikalı Kubernetes 1.37 üzerinde e-posta gönderen uçtan uca testlerimiz başarılı oldu: bir yöneticinin oluşturduğu hesabın etkinleştirme e-postası, alan adlarıyla sınırlandırılmış kendi kendine kaydın etkinleştirme e-postası, parola sıfırlama e-postası, bir kullanıcıya hesabının silindiğini bildiren e-posta ve SMTP sunucusu bir etkinleştirme veya silme e-postasını reddettiğinde ne olduğu: hesap yine de oluşturulur veya silinir ve etkinleştirme e-postası daha sonra yeniden gönderilebilir. OVERLEAF_EMAIL_FROM_ADDRESS ayarlı ve SMTP sunucusu yokken, bir parola sıfırlama isteği hatayla başarısız oldu ve yukarıda açıklandığı gibi web.log “error sending message” gösterdi.