Add the Open OnDemand URL as an output and tweak usage

Author: Matt Pryor

slurm-infra.yml

@@ -96,6 +96,7 @@
       vars:
         outputs:
           cluster_access_ip: "{{ hostvars[groups['openstack'][0]].cluster_floating_ip_address }}"
-          # We have to use the ansible_local fact directly as Ansible has a bit of a fit
-          # when there are two 'hostvars' resolutions in a chain
+          # Ansible has a fit when there are two 'hostvars' evaluations in a resolution chain,
+          # so we have to repeat logic here unfortunately
+          openondemand_url: "https://{{ hostvars[groups['openstack'][0]].cluster_floating_ip_address | replace('.', '-') ~ '.sslip.io' }}"
           azimuth_user_password: "{{ hostvars[groups['control'][0]].ansible_local.openhpc_secrets.vault_azimuth_user_password }}"

ui-meta/slurm-infra.yml

@@ -59,17 +59,33 @@ parameters:
       checkboxLabel: Run post-configuration validation?
 
 usage_template: |-
-  Access to the cluster is via the external IP using SSH as the `rocky` user:
+  # Accessing the cluster using Open OnDemand
+
+  [Open OnDemand](https://openondemand.org/) is a web portal for managing HPC jobs, including graphical
+  environments such as [Jupyter Notebooks](https://jupyter.org/).
+
+  {% if cluster.outputs.openondemand_url %}
+  The Open OnDemand portal for this cluster as available at
+  [{{ cluster.outputs.openondemand_url[8:] }}]({{ cluster.outputs.openondemand_url }}).
+
+  Enter the username `azimuth` and password `{{ cluster.outputs.azimuth_user_password }}` when prompted.
+  {% else %}
+  The Open OnDemand portal for this cluster can be accessed from the services list.
+  {% endif %}
+
+  # Accessing the cluster using SSH
+
+  The cluster can be accessed over SSH via the external IP. The SSH public key of the user that
+  deployed the cluster is injected into the `azimuth` user:
 
   ```
-  $ ssh rocky@{{ cluster.outputs.cluster_access_ip | default('[cluster ip]') }}
+  $ ssh azimuth@{{ cluster.outputs.cluster_access_ip | default('[cluster ip]') }}
   [rocky@{{ cluster.name }}-login-0 ~]$ sinfo
   PARTITION AVAIL  TIMELIMIT  NODES  STATE NODELIST
   compute*     up 60-00:00:0    {{ "%3s" | format(cluster.parameter_values.compute_count) }}   idle {{ cluster.name }}-compute-[0-{{ cluster.parameter_values.compute_count - 1 }}]
   ```
 
-  The SSH public key of the user that deployed the cluster is injected. Access can be granted
-  to additional users by placing their SSH public key in `~rocky/.ssh/authorized_keys`.
+  SSH access can be granted to additional users by placing their SSH public key in `~azimuth/.ssh/authorized_keys`.
 
 services:
   - name: ood