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