[vpsFree.cz: community-list] vpsAdmin v2.7.0: zpracování plateb, e-maily, 2 pgnd VPS a další (payments, e-mails, 2 pgnd VPSes and more)

[Jakub Skokan]

Ahoj,

(English version below)

v pátek jsem nasadil novou verzi vpsAdminu, v2.7.0 [1]. Mezi hlavní
novinky patří automatizované zpracování plateb členských příspěvků,
možnost nastavení více e-mailových adres, mazání snapshotů NASu z web UI
a volitelné pojmenování ručně vytvořených snapshotů.

Dále bylo změněno výchozí nastavení dovoleného počtu VPS, mezi které lze
rozdělit přidělené prostředky. V produkci na 5 VPS a v playgroundu na 2
VPS. V playgroundu jsou navíc k dispozici 2 IPv4 adresy.

Hodně změn se událo také pod kapotou. Do API byla přesunuta implementace
přihlášek a požadavků na změnu osobních údajů. K tomu spousta
refactoringu a veškerá funkcionalita už je nyní dostupná v API -- např.
přihlášku do vpsFree je možné zaslat přes vpsfreectl [2].

Platby
------
Do teď se příchozí platby přepisovaly z bankovního účtu do vpsAdminu
manuálně. vpsAdmin má nyní plugin [3], který obsahuje podporu pro
platící uživatele. Platby se z účtu stahují několikrát denně přes Fio
API [4]. O přijetí platby pak vpsAdmin informuje mailem.

Automaticky jsou zpracovány všechny platby, které mají správný VS (ID
člena) a částku (násobek členského příspěvku). Pokud někdo zapomene
vyplnit VS, platbu zpracujeme manuálně. Když se nám platbu nepodaří
spárovat ani podle jména, budete muset napsat na podporu. V tomto ohledu
se tedy nic nemění a bude to fungovat jako doposud.

Případné doplatky za další VPS, apod., se budou platit s jiným VS --
domluvíte se s Michalem na podpoře.

Nastavení vícero kontaktních e-mailových adres
----------------------------------------------
Někteří členové chtěli do vpsAdminu zapsat více e-mailových adres, týká
se to zejména firem, kde se o členství a VPS stará více lidí, apod.

vpsAdmin definuje dva typy kontaktů (role): správce VPS a správce účtu
(členství). Jednotlivé zprávy, které vpsAdmin rozesílá, jsou rozděleny
do těchto rolí a můžete si nastavit, kdo je bude dostávat.

Například, správce účtu (členství) dostává maily o upozornění k platbě
členského příspěvku a pozastavení/obnovení členství. Správce VPS pak
maily o změně stavu VPS, změně konfigurace VPS, stahování záloh a
migrace VPS.

Ke každé roli lze nastavit více e-mailů. Komu by ani toto rozdělení
nestačilo, existuje ještě detailnější nastavení, kde si můžete u každého
typu zprávy vybrat, zda ji chcete dostávat a na které adresy.

Více info v KB: https://kb.vpsfree.cz/navody/vps/uzivatele

Pokud vám stávající nastavení jedné adresy vyhovuje, nemusíte nic měnit.

Snapshoty
---------
Ve web UI se konečně objevila možnost smazat snapshoty NASu, které tam
šly jen vytvořit, ale mazat se musely přímo přes API.

Při vytváření snapshotu VPS nebo NASu si můžete snapshot pro pozdější
identifikaci libovolně pojmenovat.

Systém pluginů
--------------
Ve snaze ponechat jádro vpsAdminu co nejjednodušší jsem se rozhodl
přidávat funkcionalitu nesouvisející s primárním zaměřením ve formě
pluginů [5]. Jádro vpsAdminu by mělo umět spravovat VPS, storage a síť.
Ostatní věci, jako platby nebo uživatelské požadavky, jsou tedy
implenentovány jako pluginy.

Další změny
-----------
Až v této verzi byl úplně dokončen přesun funkcionality z původního
webového rozhraní do API. Web UI bylo kompletně odpojeno od databáze,
všechno co vidíte se načítá z API.

Seznam všech změn je k dispozici v poznámkách o vydání [1].


ENGLISH VERSION
===============

on Friday, I've deployed a new version of vpsAdmin, v2.7.0 [1]. It
features mainly automated membership payment processing, the possibility
to set up multiple e-mail addresses, deletion of NAS snapshots from the
web UI and optional snapshot labels.

Furthermore, we've changed the maximum number of VPSes that you can
split your resources into. In production, you can create up to 5 VPSes
and in playground up to 2 VPSes. In playground, you also have two IPv4
addresses.

A lot of changes occurred under the hood. The registration form and user
requests were moved to the API. Along with a lot of refactoring, all
functions are now available in the API. For example, the registration
form to vpsFree can be sent via vpsfreectl [2].

Payments
--------
Until now, incoming payments were processed manually. Since Friday,
vpsAdmin has a plugin [3] that adds support for paying users. Incoming
payments are downloaded several times per day using the Fio API [4].
vpsAdmin will notify you by mail when it accepts a new payment.

The payment is accepted only when the variable symbol matches and the
received amount is a multiple of the membership fee. Should you forget
to send the variable symbol, we will try to match the payment manually
at a later time. If we're unable to find matching vpsAdmin account using
a name, you will have to contact our support. So there are no changes in
operation.

As to supplementary payments for another VPS etc., you will use a
different variable symbol, you'll learn it from our support when needed.

Configuration of multiple e-mail addresses
------------------------------------------
Some of our members wanted to set multiple e-mail adresses to send
notifications to more people. This concerns mainly companies with people
fullfilling different roles, such as an accountant and system administrator.

vpsAdmin defines two contact roles: system administrator and account
manager. All mails that vpsAdmin sends are sent to appropriate roles, if
set.

For example, account manager receives e-mails about payments and
suspension/activation of the account. System administrator receives
e-mails about changing of VPS state or configuration, backup downloads
or VPS migrations.

You can set multiple addresses for each role. If you still need more,
there's advanced settings form, where you can assign different e-mail
addresses to specific mails that vpsAdmin sends. Or you can choose to
not receive some mail whatsoever.

See KB for mroe info: https://kb.vpsfree.org/manuals/vps/users

If you're happy with one e-mail address, as it was before, you don't
need to change anything.

Snapshots
---------
The web UI finally has a button to delete NAS snapshots, in addition to
creating them. You don't have to use the API directly anymore.

When creating a snapshot, you can optionally set a label to recognize it
in the future.

Plugin system
-------------
In an attempt to keep the core of vpsAdmin as simple as possible, I've
decided to add functionality that is not closely related to its main
goals as plugins. The core will handle VPS, storage and related
networking, while other stuff, like user registrations and payments, are
implemented as independent plugins.

Other changes
-------------
This is the first version where truly all functionality has been moved
from the old web interface to the API. The web UI has been disconnected
from the database, so everything you see is loaded from the API.

You can see all changes in the release notes [1].

[1] https;//projects.vpsfree.cz/vpsadmin-doc/releases/v2.7.0/

[2] https://kb.vpsfree.cz/navody/vps/api#cli

[3] https://github.com/vpsfreecz/vpsadmin-plugin-payments

[4] https://www.fio.cz/bankovni-sluzby/api-bankovnictvi

[5] https://projects.vpsfree.cz/vpsadmin-doc/plugins/

Jakub