Soracom Orbit
Soralets & Modules
Creating a Soralet
To upload a WASM module, you must first create a Soralet. A Soralet is a WASM runtime container on Soracom which will run your WASM modules, and which can contain multiple versions of of your modules.
-
Login to the User Console. From the Menu, open the Soralet Management screen.
-
Click the New button.
-
Enter a unique Soralet ID for your Soralet.
The name of a Soralet can only consist of numbers, letters, underscores, and hyphens, and must be 100 characters or less.
Then click Create Soralet.
Your Soralet will appear in the list of Soralets.
Uploading a Module
Now, upload your WASM module to your Soralet:
-
Click the ID of the Soralet you want to configure.
-
From the Versions tab, click the Upload new WASM button.
-
Select the compiled WASM module file, then click Upload.
Once uploaded, your module will appear in the list of versions.
You can then follow the Device Testing documentation to test your module in on Soracom, and the Configuration documentation to enable your module for a device group.
If you upload additional modules to the same Soralet, they will be saved separately rather than overwriting existing modules. Each time you upload another WASM module, the Soracom Resource Name (SRN) version number will automatically increment. This allows you to easily update your group configuration and roll back to a previous version without re-uploading an older WASM module.
Deleting a Module
If you no longer need a particular module version, or if you have reached the limit of modules that can be uploaded to a Soralet, you can delete individual modules.
-
Click the ID of the Soralet you want to configure.
-
From the Versions tab, click the button for the module version you want to delete.
You can only delete a module if it is not used in a group configuration.
Deleting a module is a permanent action. Once deleted, a module cannot be restored. You will need to upload the module again.
Deleting a Soralet
Once you have deleted all modules from a Soralet, you can also delete the Soralet itself:
-
Click the ID of the Soralet you want to configure.
-
Click the Delete button.
Programmatic Usage
You can also create and manage Soralets using the Soracom API and Soracom CLI. In many cases, you may prefer configuring Soralets programmatically as part of your Orbit module development process, in order to avoid using the User Console interface. For more information on deploying Orbit modules programmatically, refer to the Deployment documentation.