Building Quantotto Image

NOTE:

Building Raspberry Pi image is done by running qtoserver agent buildrpi:

$ qtoserver agent buildrpi --help
Usage: qtoserver agent buildrpi [OPTIONS]

  Builds Raspberry Pi image with Quantotto Agent and all the pre-requisites

Options:
  --base-image-file TEXT      Path to base Raspberry OS image file  [required]
  --hostname TEXT             Raspberry Pi hostname  [default:
                              qto20201211T212557; required]

  --site-name TEXT            Agent's site name  [default: main; required]
  --out-dir TEXT              Image output folder  [default:
                              /opt/quantotto/.venv/lib/python3.8/site-
                              packages/quantotto/cli_server/rpi/out; required]

  --configure-network         Embed network settings into image
  --configure-wifi            Embed WiFi settings into image (not required if
                              Ethernet will be used)

  --keep-tmp                  Do not delete temporary directory (for script
                              debugging)

  --help                      Show this message and exit.

SSH into Quantotto Server
Run (from your user HOME folder):
```
qtoserver agent buildrpi \
  --base-image-file rpi/quantotto.img \
  --hostname piqto \
  --site-name main \
  --out-dir agentrpi/ \
  --configure-network \
  --configure-wifi
```
Feel free to modify hostname / site-name arguments.
- Before build process begins, network and WiFi configuration files will be open in editor for you to modify.
- These configurations are required for “headless” Raspberry Pi setup that removes the need for monitor and keyboard and
  allows it to start and connect to network autonomously.
- Specifying --configure-network will open dhcpcd.conf for editing
- Specifying --configure-wifi will open wpa_supplicant.conf for editing
- dhcpcd.conf: set static IP configuration required for Agent. See this article for details
- wpa_supplicant.conf: optionally set WiFi configuration (SSID and PSK); See this article for instructions
- if WiFi not set, Raspberry Pi is assumed to be connected with Ethernet cable to wired network.
- To save your configuration, press CTRL-O then <Enter>; to exit CTRL-X.
Once you are done with both files, build process will begin.
When done, assuming no errors, resulting image should be saved as <out-dir>/quantotto.zip; this file will be used to image SD card in the next step