docs: annotate Foundry source and deployment lifecycle in Chinese [skip ci]
This commit is contained in:
@@ -1,3 +1,4 @@
|
||||
// 邮件发送采用数据库 outbox:登录请求写队列,Run 后台轮询租约并通过 SMTP 投递。
|
||||
package auth
|
||||
|
||||
import (
|
||||
@@ -15,10 +16,12 @@ import (
|
||||
"time"
|
||||
)
|
||||
|
||||
// EmailConfig 是可选 SMTP 能力配置;Password 仅用于内存中的 SMTP 认证。
|
||||
type EmailConfig struct {
|
||||
Host, Port, Username, Password, From string
|
||||
}
|
||||
|
||||
// EmailConfigFromEnv 允许整组缺省以关闭邮件登录;部分配置或非 465 TLS 配置会启动失败。
|
||||
func EmailConfigFromEnv() (*EmailConfig, error) {
|
||||
c := &EmailConfig{Host: os.Getenv("SMTP_HOST"), Port: os.Getenv("SMTP_PORT"), Username: os.Getenv("SMTP_USERNAME"), Password: os.Getenv("SMTP_PASSWORD"), From: os.Getenv("SMTP_FROM")}
|
||||
if c.Host == "" && c.Port == "" && c.Username == "" && c.Password == "" && c.From == "" {
|
||||
@@ -31,6 +34,8 @@ func EmailConfigFromEnv() (*EmailConfig, error) {
|
||||
return c, nil
|
||||
}
|
||||
|
||||
// send 同步发送一封纯文本邮件;拒绝头部换行,并用 TLS 主机名验证和连接期限约束网络操作。
|
||||
// SMTP 调用不接收 context,Run 的取消要等当前发送结束或网络期限到达。
|
||||
func (c *EmailConfig) send(recipient, subject, body string) error {
|
||||
if strings.ContainsAny(recipient+subject, "\r\n") {
|
||||
return errors.New("invalid mail headers")
|
||||
@@ -69,6 +74,7 @@ func (c *EmailConfig) send(recipient, subject, body string) error {
|
||||
return client.Quit()
|
||||
}
|
||||
|
||||
// Run 由进程入口启动;每三秒最多认领一封,nil 配置直接返回,取消上下文停止后续轮询。
|
||||
func (c *EmailConfig) Run(ctx context.Context, db *sql.DB) {
|
||||
if c == nil {
|
||||
return
|
||||
@@ -86,6 +92,9 @@ func (c *EmailConfig) Run(ctx context.Context, db *sql.DB) {
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// deliver 用 SKIP LOCKED 避开其他 worker 正在认领的行,两分钟租约允许进程失败后重试。
|
||||
// SMTP 成功与数据库标记并非同一事务;标记失败时后续可能再次投递。
|
||||
func (c *EmailConfig) deliver(ctx context.Context, db *sql.DB) error {
|
||||
var id, lease, recipient, subject, body string
|
||||
var attempts int
|
||||
@@ -99,11 +108,14 @@ RETURNING id::text,lease_id::text,recipient,subject,body,attempts
|
||||
if err != nil {
|
||||
return err
|
||||
}
|
||||
// lease 是本轮所有权标记;回写时匹配它,避免旧 worker 覆盖租约到期后的新认领结果。
|
||||
sendErr := c.send(recipient, subject, body)
|
||||
if sendErr == nil {
|
||||
// 成功后清空邮件正文,减少验证码在队列中的保留;收件人和投递记录仍保留。
|
||||
_, err = db.ExecContext(ctx, "UPDATE email_outbox SET sent_at=now(),body='',lease_until=NULL,lease_id=NULL WHERE id=$1 AND lease_id=$2", id, lease)
|
||||
return err
|
||||
}
|
||||
// attempts 在认领时递增:第一次失败延迟 60 秒,指数退避最多 3840 秒,最多尝试十次。
|
||||
delay := 30 * (1 << min(attempts, 7))
|
||||
_, err = db.ExecContext(ctx, "UPDATE email_outbox SET available_at=now()+$3*interval '1 second',lease_until=NULL,lease_id=NULL WHERE id=$1 AND lease_id=$2", id, lease, delay)
|
||||
if err != nil {
|
||||
|
||||
Reference in New Issue
Block a user