public inbox for pve-devel@lists.proxmox.com
 help / color / mirror / Atom feed
From: Lukas Wagner <l.wagner@proxmox.com>
To: pve-devel@lists.proxmox.com
Subject: [pve-devel] [PATCH manager/docs/proxmox{, -perl-rs, -widget-toolkit} 0/8] notifications: add SMTP endpoint
Date: Mon,  7 Aug 2023 15:06:11 +0200	[thread overview]
Message-ID: <20230807130619.428423-1-l.wagner@proxmox.com> (raw)

This patch series adds support for a new notification endpoint type,
smtp. As the name suggests, this new endpoint allows PVE to talk
to SMTP server directly, without using the system's MTA (postfix).

On the Rust side, these patches add a new dependency to the `lettre`
crate for SMTP communication. This crate was chosen as it is:
  - by far the most popular mailing crate for Rust
  - well maintained
  - has reasonable dependencies
  - has async support, enabling us to asyncify the proxmox-notify
    crate at some point, if needed

The proxmox-widget-toolkit, pve-manager and pve-docs patches require
v6 of the original notification patches [1] series to be applied
first. The patches for proxmox and proxmox-perl-rs are based of the
latest master branch.

[1] https://lists.proxmox.com/pipermail/pve-devel/2023-August/058618.html



proxmox:

Lukas Wagner (4):
  notify: add 'smtp' endpoint
  notify: add api for smtp endpoints
  notify: fix typo in doc comments
  notify: update d/control

 Cargo.toml                                  |   1 +
 proxmox-notify/Cargo.toml                   |   4 +-
 proxmox-notify/debian/control               |  22 +-
 proxmox-notify/src/api/mod.rs               |  48 +++
 proxmox-notify/src/api/smtp.rs              | 373 ++++++++++++++++++++
 proxmox-notify/src/config.rs                |  23 ++
 proxmox-notify/src/endpoints/common/mail.rs |  24 ++
 proxmox-notify/src/endpoints/common/mod.rs  |   2 +
 proxmox-notify/src/endpoints/mod.rs         |   4 +
 proxmox-notify/src/endpoints/sendmail.rs    |  22 +-
 proxmox-notify/src/endpoints/smtp.rs        | 240 +++++++++++++
 proxmox-notify/src/lib.rs                   |  30 +-
 12 files changed, 772 insertions(+), 21 deletions(-)
 create mode 100644 proxmox-notify/src/api/smtp.rs
 create mode 100644 proxmox-notify/src/endpoints/common/mail.rs
 create mode 100644 proxmox-notify/src/endpoints/common/mod.rs
 create mode 100644 proxmox-notify/src/endpoints/smtp.rs


proxmox-perl-rs:

Lukas Wagner (1):
  notify: add bindings for smtp API calls

 common/src/notify.rs | 110 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 110 insertions(+)


pve-manager:

Lukas Wagner (1):
  notify: add API routes for smtp endpoints

 PVE/API2/Cluster/Notifications.pm | 337 ++++++++++++++++++++++++++++++
 1 file changed, 337 insertions(+)


proxmox-widget-toolkit:

Lukas Wagner (1):
  panel: notification: add gui for SMTP endpoints

 src/Makefile                     |   2 +
 src/Schema.js                    |   5 +
 src/panel/EmailRecipientPanel.js |  93 +++++++++++++++
 src/panel/SendmailEditPanel.js   |  69 ++---------
 src/panel/SmtpEditPanel.js       | 192 +++++++++++++++++++++++++++++++
 5 files changed, 300 insertions(+), 61 deletions(-)
 create mode 100644 src/panel/EmailRecipientPanel.js
 create mode 100644 src/panel/SmtpEditPanel.js


pve-docs:

Lukas Wagner (1):
  notifications: document SMTP endpoints

 notifications.adoc | 35 ++++++++++++++++++++++++++++-------
 1 file changed, 28 insertions(+), 7 deletions(-)


Summary over all repositories:
  20 files changed, 1547 insertions(+), 89 deletions(-)

-- 
murpp v0.4.0





             reply	other threads:[~2023-08-07 13:07 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-08-07 13:06 Lukas Wagner [this message]
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox 1/8] notify: add 'smtp' endpoint Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox 2/8] notify: add api for smtp endpoints Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox 3/8] notify: fix typo in doc comments Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox 4/8] notify: update d/control Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox-perl-rs 5/8] notify: add bindings for smtp API calls Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH pve-manager 6/8] notify: add API routes for smtp endpoints Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH proxmox-widget-toolkit 7/8] panel: notification: add gui for SMTP endpoints Lukas Wagner
2023-08-07 13:06 ` [pve-devel] [PATCH pve-docs 8/8] notifications: document " Lukas Wagner
2023-08-24 12:31 ` [pve-devel] [PATCH manager/docs/proxmox{, -perl-rs, -widget-toolkit} 0/8] notifications: add SMTP endpoint Lukas Wagner

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230807130619.428423-1-l.wagner@proxmox.com \
    --to=l.wagner@proxmox.com \
    --cc=pve-devel@lists.proxmox.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox
Service provided by Proxmox Server Solutions GmbH | Privacy | Legal