Instantiate Frontend Slave

How To Instantiate Frontend Slave

This document explains how to instantiate a Frontend Slave which can provide a user-friendly URL for another service running on a SlapOS network.

It will explain the different instantiation parameters. Please refer to other documents on add a software to the SlapOS Master catalog or supplying/installing a software

Table of Content

  • Frontend Slave Instance Configuration

Frontend (Caddy) Slave Configuration

The process of installing (supplying) a software and providing it as a service (instantiation) are the same for all software. However during instantiation each instance can be configured differently.

This section will cover the specific configuration parameters used for a Frontend Slave used for example during installation of COMP-0 as it will provide a frontend-url such as

master.slaptest.erp5.net

for the Dashboard on

https://54.37.31.10/erp5/web_site_module/hostingjs/

Note that a Frontend slave is an instance of a previously instantiated Frontend!

Frontend Slave Configuration Parameters

SlapOS Interface - Frontend Slave Configuration Parameters

After selecting Services, Adding a new service, selecting Frontend and the latest release, you should reach the Frontend configuration menu.

Select Custom Personal (Slave) and give your Frontend a recognizable name. Then add the Backend Url you want this Frontend to connect to. In the screenshot pictured, it is the url to a SlapOS Master Dashboard. The backend url

https://54.37.31.10/erp5/web_site_module/hostingjs/

points to this Dashboard. Set Custom Domain and Server Alias to the domain you want to use

master.slaptest.erp5.net

then scroll down to the bottom of the page and (don't forget) to select the computer to provide the Frontend slave.

Click Proceed to continue and request instantiation.

Frontend Slave Instantiation

SlapOS Interface - Frontend Slave Instantiation

You will be forwarded back to the list of deployed services. Note that you might have to refresh the page for your new instance to appear. Once you can see it, click on entry to open the connection parameters.

You can follow the compilation by looking at the slapos-node-software.log using:

# tail opt/slapos/log/slapos-node-software.log -f

 

Frontend Slave Connection Parameters

SlapOS Interface - Frontend Slave Connection Parameters

Note, it might take a few minutes for the instance to become available. Refresh the page from time to time until the connection parameter table displays parameteres. Once the Secure Access entry shows the requested URL, the Frontend Slave is setup and working.

Frontend Slave Running

SlapOS Interface - Frontend Slave Running

If you go to your requested URL (master.slaptest.erp5.net) you can see that it points to the selected backend URL.

Thank You

Image Nexedi Office
  • Nexedi SA
  • 147 Rue du Ballon
  • 59110 La Madeleine
  • France