[taler-deployment] branch master updated: regional setup: rename to address any currency

[gnunet]

This is an automated email from the git hooks/post-receive script.

ms pushed a commit to branch master
in repository deployment.

The following commit(s) were added to refs/heads/master by this push:
     new 579d935  regional setup: rename to address any currency
579d935 is described below

commit 579d93541d44ef63ef036c565d7626c76cd80d8b
Author: MS <ms@taler.net>
AuthorDate: Mon Dec 11 19:57:47 2023 +0100

    regional setup: rename to address any currency
---
 netzbon/README                                     | 144 ---------------------
 {netzbon => regional-currency}/.gitignore          |   0
 {netzbon => regional-currency}/.shellcheckrc       |   0
 regional-currency/README                           |   2 +
 {netzbon => regional-currency}/config_libeufin.sh  |   0
 .../config_libeufin_bank.sh                        |   0
 .../config_libeufin_nexus.sh                       |   0
 {netzbon => regional-currency}/config_nginx.sh     |   0
 {netzbon => regional-currency}/functions.sh        |   0
 .../incoming_template.xml                          |   0
 {netzbon => regional-currency}/install_packages.sh |   0
 {netzbon => regional-currency}/main.sh             |   0
 .../nginx-conf/backend.taler-nginx.conf            |   0
 .../nginx-conf/bank.taler-nginx.conf               |   0
 .../nginx-conf/exchange.taler-nginx.conf           |   0
 {netzbon => regional-currency}/setup-exchange.sh   |   0
 {netzbon => regional-currency}/setup-merchant.sh   |   0
 {netzbon => regional-currency}/transfer.sh         |   0
 {netzbon => regional-currency}/vagrant/.gitignore  |   0
 {netzbon => regional-currency}/vagrant/README      |   0
 {netzbon => regional-currency}/vagrant/Vagrantfile |   0
 {netzbon => regional-currency}/withdraw.sh         |   0
 22 files changed, 2 insertions(+), 144 deletions(-)

diff --git a/netzbon/README b/netzbon/README
deleted file mode 100644
index d2fb5c7..0000000
--- a/netzbon/README
+++ /dev/null
@@ -1,144 +0,0 @@
-=====================================
-Taler @ NetzBon deployment automation
-=====================================
-
-This directory contains a set of scripts for deploying Taler by asking
-questions to the user and providing the values to the various Taler subsystems
-(LibEufin, Exchange, Merchant, ..) and other components (nginx, systemd).
-
-main.sh is the entry point script for the Taler setup. It asks the questions
-and puts the answers in environment variables and/or replaces them into Nginx
-configuration file(s).
-
-The main.sh script can be re-run whenever the setup process was interrupted,
-for example due to problems (domain name setup, etc.) that the admin needs to
-fix first.
-
-Getting Started
-===============
-
-The setup scripts are currently only tested on Ubuntu Kinetic Kudu.
-
-Start by cloning the deployment.sh repository:
-
-$ git clone git://taler.net/deployment.git
-
-Proceed with the setup by executing the main.sh script:
-
-$ cd deployment/netzbon
-$ ./main.sh
-
-After the setup is complete, you can:
-- go to https://bank.$domain/, log in as admin
-  and create the first (merchant) bank account(s)
-- fund one of the accounts (see section "Funding of bank accounts"),
-  so that withdrawal can be tested
-- log into the bank with the funded (non-admin) account, withdraw electronic
-  cash via the bank UI into the Taler wallet (either browser extension wallet
-  or Android wallet)
-- go to the merchant backoffice (https://backend.$domain/),
-  log in, configure the instance (do not forget to set an access token),
-  create the first order and pay for it with the wallet.
-
-
-Domain names
-============
-
-Assuming a main domain at netzbon.ch (i.e. "netzbon.ch" will be given as the
-value for the domain during configuration), this setup expects the following
-subdomains to be reachable:
-
-- exchange.netzbon.ch
-- bank.netzbon.ch
-- backend.netzbon.ch (merchants frontends need this)
-
-
-Setup guide
-===========
-
-The following recommendations apply for questions from the "main.sh" script:
-
-- "Run taler-exchange-offline?"
-  => Answer with "yes", otherwise manual offline key management
-  has to be done by the sysadmin.
-- TLS: yes, as long as the domain is externally reachable for letsencrypt
-
-When packages are installed, the package manager will ask questions about the
-database configuration:
-- "Configure database for XZY with dbconfig-common?"
-  => Should be answered with "yes"
-- "Please select the remote hostname to use"
-  => Select "localhost"
-- "PostgreSQL application password"
-  => Should be left blank, so that installer will use secure random password.
-
-
-Funding of bank accounts
-========================
-
-After a successful installation, all the services are running
-and the administrator can create bank accounts and wire funds
-to them.  The script "transfer.sh" in this directory serves this
-purpose; running it without arguments shows the usage instructions.
-
-Note: The wiring of funds causes the amount to be subtracted from the "admin"
-bank account.  Following is one example of wiring funds from the administrator
-to the "shop" bank account. 
-
-  $ ./transfer.sh shop NETZBON:10 "welcome amount"
-
-If the command succeeded, the 'shop' bank account has received
-one payment of 10 NETZBONs from 'admin' with the subject "welcome
-amount".
-
-Concept
-=======
-
-The different stages of the installation have their own shell
-scripts, driven by the 'main.sh' master script. Splitting up the
-process into the main stages should make it easy to resume if any
-particular step fails for any reason.
-
-The different stages communicate via environment variables which
-they may consume or export for future stages.  The 'main.sh' script
-prompts the user for the following inputs:
-
-* the main domain name (subdomains may be created automatically)
-* the name of the currency
-* the master password to set for the administrative Web interface
-
-The setup is fundamentally based on the Debian packages.  The scripts
-should do the minimal amount necessary to get GNU Taler to work on top
-of what the Debian packages provide.  If we can move logic into a Debian
-package, we should.  However, the Debian packages MUST install 
non-interactively
-[NOTE: they do for the DB config], so site-specific inputs MUST be
-done by the shell scripts.
-
-The shell scripts should be kept simple, and for example use default
-configuration(s) from the Debian packages and replace values with 'sed'
-instead of generating complete configurations themselves (where possible,
-so in particular for the reverse HTTPS proxy configuration).
-
-
-Components
-==========
-
-The goal is not to only setup the Debian packages, but to also configure
-all of the components:
-
-* libeufin-bank with an account for the administrator and the exchange
-* libeufin-nexus with access to the exchange account and Taler facade
-* exchange with denominations, fees (all zero) and credentials for the 
libeufin-nexus
-* merchant backend with the master key of the exchange for the target currency
-
-
-Future
-======
-
-For now, it is assumed that the taler-exchange-offline functionality is run
-locally (in a system that is online).  Future deployments should aim at moving
-the offline keys in a offline system.
-
-For now, we do not integrate the currency conversion / cash out logic and
-only have libeufin-nexus between libeufin-sandbox and exchange. In the future,
-nexus will also communicate with an external bank. 
diff --git a/netzbon/.gitignore b/regional-currency/.gitignore
similarity index 100%
rename from netzbon/.gitignore
rename to regional-currency/.gitignore
diff --git a/netzbon/.shellcheckrc b/regional-currency/.shellcheckrc
similarity index 100%
rename from netzbon/.shellcheckrc
rename to regional-currency/.shellcheckrc
diff --git a/regional-currency/README b/regional-currency/README
new file mode 100644
index 0000000..599336a
--- /dev/null
+++ b/regional-currency/README
@@ -0,0 +1,2 @@
+Refer to the following document:
+https://docs.taler.net/libeufin/regional-manual.html#guided-basic-setup
diff --git a/netzbon/config_libeufin.sh b/regional-currency/config_libeufin.sh
similarity index 100%
rename from netzbon/config_libeufin.sh
rename to regional-currency/config_libeufin.sh
diff --git a/netzbon/config_libeufin_bank.sh 
b/regional-currency/config_libeufin_bank.sh
similarity index 100%
rename from netzbon/config_libeufin_bank.sh
rename to regional-currency/config_libeufin_bank.sh
diff --git a/netzbon/config_libeufin_nexus.sh 
b/regional-currency/config_libeufin_nexus.sh
similarity index 100%
rename from netzbon/config_libeufin_nexus.sh
rename to regional-currency/config_libeufin_nexus.sh
diff --git a/netzbon/config_nginx.sh b/regional-currency/config_nginx.sh
similarity index 100%
rename from netzbon/config_nginx.sh
rename to regional-currency/config_nginx.sh
diff --git a/netzbon/functions.sh b/regional-currency/functions.sh
similarity index 100%
rename from netzbon/functions.sh
rename to regional-currency/functions.sh
diff --git a/netzbon/incoming_template.xml 
b/regional-currency/incoming_template.xml
similarity index 100%
rename from netzbon/incoming_template.xml
rename to regional-currency/incoming_template.xml
diff --git a/netzbon/install_packages.sh b/regional-currency/install_packages.sh
similarity index 100%
rename from netzbon/install_packages.sh
rename to regional-currency/install_packages.sh
diff --git a/netzbon/main.sh b/regional-currency/main.sh
similarity index 100%
rename from netzbon/main.sh
rename to regional-currency/main.sh
diff --git a/netzbon/nginx-conf/backend.taler-nginx.conf 
b/regional-currency/nginx-conf/backend.taler-nginx.conf
similarity index 100%
rename from netzbon/nginx-conf/backend.taler-nginx.conf
rename to regional-currency/nginx-conf/backend.taler-nginx.conf
diff --git a/netzbon/nginx-conf/bank.taler-nginx.conf 
b/regional-currency/nginx-conf/bank.taler-nginx.conf
similarity index 100%
rename from netzbon/nginx-conf/bank.taler-nginx.conf
rename to regional-currency/nginx-conf/bank.taler-nginx.conf
diff --git a/netzbon/nginx-conf/exchange.taler-nginx.conf 
b/regional-currency/nginx-conf/exchange.taler-nginx.conf
similarity index 100%
rename from netzbon/nginx-conf/exchange.taler-nginx.conf
rename to regional-currency/nginx-conf/exchange.taler-nginx.conf
diff --git a/netzbon/setup-exchange.sh b/regional-currency/setup-exchange.sh
similarity index 100%
rename from netzbon/setup-exchange.sh
rename to regional-currency/setup-exchange.sh
diff --git a/netzbon/setup-merchant.sh b/regional-currency/setup-merchant.sh
similarity index 100%
rename from netzbon/setup-merchant.sh
rename to regional-currency/setup-merchant.sh
diff --git a/netzbon/transfer.sh b/regional-currency/transfer.sh
similarity index 100%
rename from netzbon/transfer.sh
rename to regional-currency/transfer.sh
diff --git a/netzbon/vagrant/.gitignore b/regional-currency/vagrant/.gitignore
similarity index 100%
rename from netzbon/vagrant/.gitignore
rename to regional-currency/vagrant/.gitignore
diff --git a/netzbon/vagrant/README b/regional-currency/vagrant/README
similarity index 100%
rename from netzbon/vagrant/README
rename to regional-currency/vagrant/README
diff --git a/netzbon/vagrant/Vagrantfile b/regional-currency/vagrant/Vagrantfile
similarity index 100%
rename from netzbon/vagrant/Vagrantfile
rename to regional-currency/vagrant/Vagrantfile
diff --git a/netzbon/withdraw.sh b/regional-currency/withdraw.sh
similarity index 100%
rename from netzbon/withdraw.sh
rename to regional-currency/withdraw.sh

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.