1. DevUser role

1.1. Becoming DevUser

Once registered in the portal, you are a EndUser. To be granted DevUser rights, just email to Portal Admins (actually Victor or Javi).

A DevUser can:

1.2. Register an HiFiMagnet application

There is actually two routes to register an app:

  • for all user

  • using the MarketPlace

The recommended way is to use the MarketPlace. However to speed up the tests, the DevUser may register more easily his/her app for all users. Note that this app will be available to every user of the platform.

An app can only be registered once. It means that once you have gone througth the registration process your only choice is to RemoveApp.

As a consequence, to upgrade your app package you have first to remove the app and go back to re-register your app.

1.2.1. For all users

*Experiments* menu for *DevUser*

To register an application for every user of the platform:

  • Go to Experiments,

  • Select Applications

  • Enter a new Application Name

  • Choose a package file to load.

Register App in MSOPortal

The package file is an gzipped archive holding the formal description of the app. It’s actually a directory which contains :

  • a blueprint.yml TOSCA file that describes the workflow

  • a scripts sub-directory holding the scripts required to deploy and undeploy the app

In this git repository you will find the actual application corresponding to the HiFiMagnet basic demonstrator.

To actually build the app, use: ./deploy pkg

To debug an app, it may be convenient to use the Portal orchestrator CLI. see this file for details

1.2.2. In the Marketplace

To register an application you need to be DevUSer The process is split into several part:

  • add the app and create an offer in the Marketplace:

    • go to My stock/Catalogue

    • go to My stock/Product

    • go to My stock/Offering

Then you need to perform the following steps in Experiments,:

  • go to Applications

    • select your Offering in the sliding menu New Products

    • give the app a meaningful name

    • Choose a package file to load.

1.2.3. Remove an app

  • Go to Experiments,

  • Select Applications

  • In the top sliding menu, select the app to be removed

  • Click on Remove

1.3. Validate an HiFiMagnet application purchase order

Once the app has been registered in the Marketplace (actually it means that an offering has been defined) you will be owner of this app. Any EndUser may purchase your app. To check if you have any order:

  • go to My Inventory

  • go to My Inventory/Product Orders

  • check Recibibas menu

  • if any new message, you need to:

    • click to validate the order

    • click again to finalize the order

The EndUser may now proceed to perform Experiments with you product

Do not forget to notify the user that he/she has to connect once to:

and eventually to :

This steps are mandatory for smooth operation of the app since the user has to be included into HiFiMagnet user group. Fortunately this need to be done only once for any HiFiMagnet app.

Unfortunately the management of user has to be carried out manually by the DevUser in charge of the app and cannot be performed from the portal.

1.4. Adding an EndUser to Sregistry team

For app like HiFiMagnet apps that require an private singularity image, you must grant EndUser access to the Sregistry HiFiMagnet team. To do so follow these instructions:

  • Click on Container main menu,

  • Logged in to your sregistry.srv.cesga.es/ using FiWare,

  • Click on Teams menu then select your team

ex: HiFiMagnet Sregistry team
  • As in the image above, click on Invite Users

  • Copy the link (display in blue) and send it to your new EndUser

Once the EndUser will validate the invitation, his/her name will be display in the list of members. You can also make him/her owner of the team by clicking on the Make Owner button.

To grant the EndUser access to the images in the HiFiMagnet collection, you need to proceed as follows:

  • click on the Collections menu on the top left

  • click on the link to the HiFiMagnet collections in the collections list

  • once the list of images contained in the HiFiMagnet collection is display, you have to click settings button

A list of owners and contributors appears in the top right part of the page. Bellow are lists of user that are nor part of owners nor contributors.

  • To grant owner or contributor role to a given user select his/her name

  • finaly simply click on the red save button

The previously selected user shall not be shown in the appropriate list according to your choice.

1.5. Adding an new image into Sregistry HiFiMagnet collection

To upload salome-8.4.0.simg newest image on Sregistry HiFiMagnet collection from your local machine you can type the following commands:

export SREGISTRY_CLIENT=registry
export SREGISTRY_CLIENT_SECRETS=~/.sregistry
[export SREGISTRY_STORAGE=...]

sregistry push --name hifimagnet/salome --tag 8.4.0 salome-8.4.0.simg

The .sregistry holds the Sregistry TOKEN (to get the TOKEN see this).

You need to install {https://singularityhub.github.io/sregistry-cli}[sregistry-cli] to get this working.