Create script to install The Combine on a standalone system

.gitignore

@@ -81,6 +81,11 @@ src/resources/dictionaries/*.txt
 deploy/scripts/semantic_domains/json/*.json
 database/semantic_domains/*
 
+# Combine installer
+installer/combine-installer.run
+installer/makeself-*
+installer/README.pdf
+
 # Kubernetes Configuration files
 **/site_files/
 **/charts/*.tgz

README.md

@@ -127,6 +127,16 @@ A rapid word collection tool. See the [User Guide](https://sillsdev.github.io/Th
     `dotnet tool update --global dotnet-reportgenerator-globaltool --version 5.0.4`
 11. [dotnet-project-licenses](https://github.com/tomchavakis/nuget-license)
     `dotnet tool update --global dotnet-project-licenses`
+12. Tools for generating the self installer [Linux Only]:
+
+    - [makeself](https://makeself.io/) - a tool to make self-extracting archives in Unix
+    - [pandoc](https://pandoc.org/installing.html#linux) - a tool to convert Markdown documents to PDF. In addition to
+      `pandoc`, the `weasyprint` PDF engine is required. These may be installed on Debian-based distributions by
+      running:
+
+      ```console
+      sudo apt install -y pandoc weasyprint
+      ```
 
 ### Prepare the Environment
 
@@ -505,6 +515,23 @@ of development setup errors. Run from within a Python virtual environment.
 python scripts/cleanup_local_repo.py
 ```
 
+### Generate Installer Script for The Combine (_Linux Only_)
+
+To generate the installer script, run the following commands starting in the project top level directory:
+
+```console
+cd installer
+./make-combine-installer.sh combine-release-number
+```
+
+where `combine-release-number` is the Combine release to be installed, e.g. `v1.2.0`.
+
+To update the PDF copy of the installer README.md file, run the following from the `installer` directory:
+
+```console
+pandoc --pdf-engine=weasyprint README.md -o README.pdf
+```
+
 ## Setup Local Kubernetes Cluster
 
 This section describes how to create a local Kubernetes cluster using either _Rancher Desktop_ or _Docker Desktop_.

deploy/ansible/group_vars/nuc/main.yml

@@ -19,7 +19,17 @@ image_pull_secret: aws-login-credentials
 app_namespace: thecombine
 
 k8s_user: sillsdev
-k8s_group: sillsdev
+
+################################################
+# Helm Installation
+################################################
+install_helm: no
+
+################################################
+# Support Tool Settings
+################################################
+install_ip_viewer: yes
+install_combinectl: yes
 
 #######################################
 # Ingress configuration
@@ -30,7 +40,7 @@ ingress_namespace: ingress-nginx
 # The server name will direct traffic to the production
 # server since it is used to get the certificates for the
 # NUC.
-public_dns_name: "{{ ansible_hostname }}"
+k8s_dns_name: "{{ ansible_hostname }}"
 
 ################################################
 # Ethernet settings

deploy/ansible/group_vars/server/main.yml

@@ -19,6 +19,17 @@ create_namespaces: []
 # k8s namespaces
 app_namespace: thecombine
 
+################################################
+# Helm Installation
+################################################
+install_helm: no
+
+################################################
+# Support Tool Settings
+################################################
+install_ip_viewer: no
+install_combinectl: no
+
 #######################################
 # Ingress configuration
 ingress_namespace: ingress-nginx

deploy/ansible/host_vars/localhost/main.yml

@@ -0,0 +1,62 @@
+---
+#################################################
+# Host specific configuration items for localhost
+################################################
+
+################################################
+# Configure Kubernetes cluster
+################################################
+
+# Specify which Kubernetes engine to install -
+# one of k3s or none.
+k8s_engine: k3s
+
+image_pull_secret: aws-login-credentials
+
+# k8s namespaces
+app_namespace: thecombine
+
+k8s_user: "{{ ansible_user_id }}"
+
+################################################
+# Helm Installation
+################################################
+install_helm: yes
+
+################################################
+# Support Tool Settings
+################################################
+install_ip_viewer: yes
+install_combinectl: yes
+
+#######################################
+# Ingress configuration
+ingress_namespace: ingress-nginx
+
+# For the NUCs we want to use the ansible host name
+# since that is how we can connect on the local network
+# The server name will direct traffic to the production
+# server since it is used to get the certificates for the
+# NUC.
+k8s_dns_name: "local"
+
+################################################
+# Ethernet settings
+################################################
+eth_optional: yes
+
+################################################
+# WiFi access point settings
+################################################
+has_wifi: yes
+ap_domain: thecombine.app
+ap_ssid: "thecombine_ap"
+ap_passphrase: "Combine2020"
+ap_gateway: "10.10.10.1"
+ap_hostname: "local"
+
+################################################
+# hardware monitoring settings
+################################################
+include_hw_monitoring: no
+history_days: 60

deploy/ansible/hosts.yml

@@ -1,6 +1,11 @@
 ---
 all:
   hosts:
+    localhost:
+      ansible_connection: local
+      kubecfgdir: local
+      combine_server_name: local.thecombine.app
+      link_kubeconfig: true
   children:
     nuc:
       hosts:

deploy/ansible/playbook_desktop_setup.yaml

@@ -0,0 +1,55 @@
+---
+##############################################################
+# Playbook: playbook_kube_install.yml
+#
+# playbook_kube_install.yml installs the packages and
+# configuration files that are required to run TheCombine
+# as Docker containers managed by a Kubernetes cluster.
+#
+##############################################################
+
+- name: Configure hardware for The Combine
+  hosts: localhost
+  gather_facts: yes
+  become: yes
+
+  vars_files:
+    - "vars/config_common.yml"
+    - "vars/packages.yml"
+
+  tasks:
+    - name: Update packages
+      apt:
+        update_cache: yes
+        upgrade: "yes"
+
+    - name: Setup WiFi Access Point
+      import_role:
+        name: wifi_ap
+      when: has_wifi
+
+    - name: Enable hardware monitoring
+      import_role:
+        name: monitor_hardware
+      when: include_hw_monitoring
+
+    - name: Configure Network Interfaces
+      import_role:
+        name: network_config
+
+    - name: Install Container Engine
+      import_role:
+        name: container_engine
+
+    - name: Install Kubernetes
+      import_role:
+        name: k8s_install
+
+    - name: Install Helm
+      import_role:
+        name: helm_install
+      when: install_helm
+
+    - name: Setup Support Tool
+      import_role:
+        name: support_tools

deploy/ansible/playbook_kube_install.yaml → deploy/ansible/playbook_nuc_setup.yaml

@@ -9,7 +9,7 @@
 ##############################################################
 
 - name: Configure hardware for The Combine
-  hosts: all
+  hosts: nuc
   gather_facts: yes
   become: yes
 
@@ -37,16 +37,14 @@
       import_role:
         name: network_config
 
-    - name: Install Docker Subsystem
+    - name: Install Container Engine
       import_role:
-        name: docker_install
+        name: container_engine
 
     - name: Install Kubernetes Tools
       import_role:
         name: k8s_install
 
-    - name: Get Kubernetes Configuration
+    - name: Setup Support Tool
       import_role:
-        name: k8s_config
-      tags:
-        - kubeconfig
+        name: support_tools

deploy/ansible/roles/container_engine/defaults/main.yml

@@ -0,0 +1,3 @@
+---
+container_packages:
+  - containerd.io

deploy/ansible/roles/docker_install/tasks/main.yml → deploy/ansible/roles/container_engine/tasks/main.yml

@@ -27,7 +27,6 @@
       - gnupg
       - lsb-release
     state: present
-  notify: reboot target
 
 - name: Create keyring directory
   file:
@@ -50,6 +49,16 @@
 
 - name: Install Docker Packages
   apt:
-    name: "{{ docker_packages }}"
+    name: "{{ container_packages }}"
     update_cache: yes
-  notify: reboot target
+
+- name: Check if reboot is required
+  stat:
+    path: /var/run/reboot-required
+  register: reboot_required
+
+- name: Reboot
+  reboot:
+  when:
+    - reboot_required.stat.exists
+    - ansible_connection != "local"

deploy/ansible/roles/helm_install/defaults/main.yml

@@ -0,0 +1,5 @@
+---
+helm_version: v3.13.2
+helm_arch: linux-amd64
+
+helm_download_dir: /opt/helm-{{ helm_version }}-{{ helm_arch }}

deploy/ansible/roles/helm_install/tasks/main.yml

@@ -0,0 +1,32 @@
+---
+- name: Create working directory
+  file:
+    path: "{{ helm_download_dir }}"
+    state: directory
+    owner: root
+    group: root
+    mode: 0755
+
+- name: Get Latest Release
+  get_url:
+    # https://get.helm.sh/helm-v3.13.2-linux-amd64.tar.gz
+    url: "https://get.helm.sh/helm-{{ helm_version }}-{{ helm_arch }}.tar.gz"
+    dest: "{{ helm_download_dir }}/helm.tar.gz"
+    owner: root
+    group: root
+    mode: 0755
+
+- name: Unpack helm tarball
+  command:
+    cmd: "tar -zxvf {{ helm_download_dir }}/helm.tar.gz"
+    chdir: "{{ helm_download_dir }}"
+    creates: "{{ helm_download_dir }}/{{ helm_arch }}/helm"
+
+- name: Link to extracted helm file
+  file:
+    src: "{{ helm_download_dir }}/{{ helm_arch }}/helm"
+    path: /usr/local/bin/helm
+    state: link
+    owner: root
+    group: root
+    mode: 0755