SlapOS Home SlapOS

    Prepare For The Deployment of Software on Theia

    Document showing how to prepare for deploying software on the SlapOS Theia
    • Last Update:2020-11-26
    • Version:001
    • Language:en

    Prepare For The Deployment of Software on Theia

    This presentation aims to demonstrate how to be prepared for deploying 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.

    Table of Content

    • Before You Start
    • Prepare For The Deployment of helloworld:
      • (1/3) Connect To Your Theia
      • (2/3) Clone Repository
      • (3/3) Locate Software Directory

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

    We will clarify the prerequisite in order to start the presentation. Then, we progress to show the steps to be prepared for the deployment on SlapOS Theia.

    Before You Start

     

    A SlapOS Theia:

    How to request a SlapOS Theia service from SlapOS 

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

    You can follow the preview tutorial: How to request a SlapOS Theia service from SlapOS to have your SlapOS Theia IDE. Once you have it with a validated URL, a login and a password, you shall start this tutorial without problems.

    Prepare For The Deployment of helloworld

    • (1/3) Connect To Your Theia
    • (2/3) Clone Repository
    • (3/3) Locate Software Directory

    This section will show how to access a SlapOS Theia and be prepared for the deployment of the helloworld software release in 10 minutes. It will also offer some helpful tips.

    (1/3) Connect To Your Theia

    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)

    (1/3) Connect To Your Theia

    Tips:

    Avoid closing Slapos Theia with ctrl + w

     

    (1/3) Connect To Your Theia

    Tips:

    you can open in its own window. So that Ctrl+w does not close the browser tab.
    All commands are available from command palette which comes with can be opened with F1.

    (2/3) Clone Repository

    View->Find Command or Ctrl+shift+P

    Open the command palette (View->Find Command or Ctrl+shift+P) and start typing “git” to find command (git clone) to clone repository.

    (2/3) Clone Repository

    SlapOS Git Repository

    Next, enter the git repository location:

    https://lab.nexedi.com/nexedi/slapos.git

    (2/3) Clone Repository

    Theia’s workspace

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

    (2/3) Clone Repository

    Tips:

    You can always use the Terminal to run your commands.

    git clone https://lab.nexedi.com/nexedi/slapos.git

    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.

    (3/3) Locate Software Directory

    After the repository cloned, you are supposed to locate the Software directory which contains a list of all software releases available in Theia. The list is based on the official SlapOS software repository. From there you can open a file. You can also use Ctrl+P and start typing a filename. As we are going to deploy helloworld, let’s open the software configuration (software.cfg) of helloworld.

    (3/3) Locate Software Directory

    Tips:

    • ~/srv/projet is the default workspace root (the folders we can see in left pane when opening Theia for first time are this)

    • ~/srv/slapos for embedded SlapOS, with ~/srv/slapos/inst/ for instances and ~/srv/slapos/soft/ for software

    • The computer is named “local”
    • Terminal uses bash by default

    Now you are ready to deploy it!

     

     

     

    Please read the following tutorials to accomplish your achievement.  

     

    Thank You

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