This presentation aims to demonstrate how to deploy a software release on a SlapOS Theia. The process can be used for any software available on the SlapOS repository. Note, that the SlapOS Theia is an extensible platform to develop multi-language Cloud & Desktop IDEs with state-of-the-art web technologies. Instantiating a SlapOS thus means, creating a smaller encapsulated system for then deploying another software inside. This is a useful approach for developing or hosting simple software releases.

We’ll show how to deploy a "helloworld" software release on a SlapOS Theia in this presentation. 

The agenda of the presentation includes an introduction on SlapOS, as a tool used to deploy a wide range of different services and an introduction of Theia, as an IDE running on web.

After a short introduction, we will clarify the prerequisite in order to start the presentation. Then, we progress to show the steps to deploy the software release: helloworld on SlapOS Theia.

To verify the deployment, we will inspect the services and relevant connection parameters.

Here comes a brief  introduction of SlapOS and Theia.

SlapOS is a general purpose operating system used on distributed POSIX infrastructures (Linux, xBSD) to provide and manage software services focussing on cloud orchestration and edge computing. It allows automating DevOps including deployment, monitoring and billing of software used on arbitrary cloud infrastructures.
SlapOS can be used to act as cloud provider selling software as a service (SaaS), to offer platform as a service (PaaS) solutions or also the basic infrastructure as a service (IaaS). SlapOS can be run on private hardware and data centers or any public/cloud infrastructure.
This document explains the concepts underlying the SlapOS architecture.

Theia is an extensible platform to develop full-fledged multi-language Cloud & Desktop IDE-like products with state-of-the-art web technologies.

To start deploying a software release, a SlapOS Theia is required.

This section will show how to access a SlapOS Theia and deploy a software. The screenshots show deployment of the helloworld software release, also used to explain how to extend a software release.

Locate the connection parameter on your Theia service. You can access the Theia using the url and logging in with username and password.
After logging in, you will see the platform of Theia, which is very similar to VS Code, if you want to become a power user, a large part of https://code.visualstudio.com/docs/ applies (for example that section on editing with multi cursor)

This cloned repository will be in Theia’s workspace and it’s visible in Explorer.

In this case, for example, you can open a Terminal by clicking New Terminal in Terminal and type the git clone command.

Then you will get a same workplace.

From terminal, we can use slapos command line. To deploy a software, we should basically follow 4 commands.

• Client commands(slapos supply, slapos request) talking to the master and setting configuration for a node
• Node commands(slapos node) talking to the master and asking for the configuration
• There is also an Understanding SlapOS Architecture you can refer to

You can run slapos node software in Terminal to install the software. Or there is a task configured with the same label (Terminal -> Run Task, if there is an error, hit Run task again).

slapos node software will install everything for the instance. Your instance will be deployed totally from the software installation.

Task starts the build in a new terminal. If you close that terminal process will be terminated.

Once saved the deployment of the software will begin. Deployment can take anywhere from a few minutes (simple software, already compiled) to several hours. The log will inform of any errors or warnings encountered during deployment.

Sometimes external errors such as network errors happen and in that case we can retry software.

By re-run the task, you can have your software successfully.

Once the software installed as the result of the last step, you can request instance with slapos request in your terminal. “instance_name” is up to you, and [software] depends on where the software configuration of the software are.

After have an instance requested, you can run slapos node instance in Terminal to instantiate your software. Or there is a task configured with the same label (Terminal -> Run Task, if there is a connection error, hit Run task again):

request is also the command to get parameters from a service and create the service even if it’s not yet created.

With the help of slapos proxy show, the services defined in the software.cfg file should be started and displayed:

 slappart0       local           busy    /srv/slapgrid/slappart49/srv/project/slapos/software/helloworld/software.cfg RootSoftwareInstance hello world instance      -           started     1603890566.29

The connection parameters defined in the instance.cfg.in will be displayed:

slappart0: hello world instance (type RootSoftwareInstance)
    name = Hello John Doe!
    url.go = http://[2001:67c:1254:45:a9d5::d847]:7779
    url.python = http://[2001:67c:1254:45:a9d5::d847]:7777
    url.ruby = http://[2001:67c:1254:45:a9d5::d847]:7778