nua-orchestrator 0.5.11

Nua orchestrator - local implementation

Nua orchestrator

Role of the orchestrator

The orchestrator is in charge of configuring application and resources and deploying them on the host.

Requirements

The host must be a linux server installed with the distribution:

Ubuntu 22.04.1 LTS (jammy)

Note: this is temporary, the orchestrator will be able to manage other distributions later.

In the current version, the orchestrator manages locally a single host.

Note: this is temporary, the orchestrator will be able to manage multiple hosts later.

The Nua Orchestrator will need a 'nua' administrator account with root privileges (sudoer and docker groups).

The Nua Orchestrator will interfere with local resources such as Docker services and locally installed databases. The recommended configuration is therefore to use a dedicated server.

The following Python packages (provided by Ubuntu) are required:

• python3.10
• python3.10-venv
• python3.10-dev
• python3-pip

i.e. you should run apt-get install python3.10 python3.10-venv python3.10-dev python3-pip before installing Nua.

Note: this is temporary, the installation script will take care of this kind of details later.

Installation

The bootstrap command

To install, you will need to use the bootstrapping script: nua-bootstrap.

At the moment, this implies a first temporary installation of Nua (which can be done in a temporary directory), from a sudo-able account:

git clone https://github.com/abilian/nua
cd nua/nua-orchestrator
./install.py
sudo ./env/bin/nua-bootstrap

That command will do many things:

• create the nua account
• install the required packages (Docker, postgres, Nginx, ...)
• apply default configuration to the host
• ...

Remarks

• nua-bootstrap can be safely launched on an existing configuration,
• nua-bootstrap must be launched as root, if not, a warning is displayed:

$ nua-bootstrap
Installing Nua bootstrap on local host.
Warning: Nua was already installed.
Nua bootstrap script requires root privileges.
Please try again, this time using 'sudo'.
- When sudo, use absolute script path.
- Possible command:
    sudo /home/nua/env/bin/nua-bootstrap

Installation phases

Installation can take several minutes, here an excerpt of main messages displayed during installation:

sudo /home/nua/env/bin/nua-bootstrap
Installing Nua bootstrap on local host.
Warning: Nua was already installed.
Ign:1 http://downloads.mariadb.com/Tools/ubuntu jammy InRelease
Hit:2 http://nova.clouds.archive.ubuntu.com/ubuntu jammy InRelease                                                                        [...]
Installation of base packages:
apt-get install --no-install-recommends -y ca-certificates curl docker.io lsb-release git nginx-light software-properties-common python3-certbot-nginx
[...]
Modifying /etc/sudoers for user 'nua' (full access with no passwd)
-> Prior changes found: do nothing
Creation of Python virtual environment for 'nua'
-> Prior /home/nua/env found: do nothing
Install pip
[...]
Installation of postgres version 14
apt-get install --no-install-recommends -y postgresql-14 libpq-dev
[...]
Setting Postgres password
Installation of Nua nginx configuration
systemctl restart nginx
Installation of local Nua orchestrator (via git)
Cloning into 'nua'...
[...]

Nua installation done for user 'nua' on this host.
Command 'nua --help':

At the end of the installation, the available commands are displayed.