Documentation
Documentation
Caution
You are not reading the latest stable version of this documentation. If you want up-to-date information, please have a look at master.
Embassy SDK, or Software Development Kit, is a CLI (Command Line Interface) tool that aids in building and packaging services you wish to deploy to the Embassy.
It mainly helps you validate that the necessary components of your package exist, and package all of those components into a special file type that is understood by EmbassyOS.
To install, checkout the SDK step in setting up your environment.
To see a list of all available commands provided, run the following from an terminal window:
embassy-sdk --help
Initialize the developer key for interacting with the SDK.
By default, this creates the developer key at /etc/embassy. You might need to change ownership of this folder depending on your system permissions.
chown <user> /etc/embassy
Alternatively, you can write a config file with your desired developer location, it simply needs the following format:
developer-key-path: /desired/path/to/key
And load it by running:
embassy-sdk -c /path/to/config init
This command takes the necessary package components and assembles them into the s9pk file format needed to install a service on EmbassyOS. It expects the following files to exist:
Manifest
Instructions
License
Icon
If this command fails, the error response will indicate which component is missing.
This command verifies aspects about the components assembled into the s9pk, such as:
Ensures that all mounts are real volumes in the manifest
Ensures all cert volumes point to real interfaces in the manifest
Ensures all actions refer to real images in the manifest
Ensures all images are tagged correctly in the manifest
Ensures the icon is less than 100KB
It should be run _after_ embassy-sdk pack in order to verify the validity of each component.
If this command fails, the error message will indicate the mismatched details.
This command outputs the git commit hash of the SDK version installed on your platform.
This command contains several utilities for reading components once packaged into the s9pk. In development, it can be helpful to determine if each component is successfully included in the s9pk package.
It contains the following subcommands, and requires the path to the <pacakge-id>.s9pk file as the last argument:
docker-images
hash
icon
instructions
license
manifest
For example:
embassy-sdk inspect instructions /path/to/<package-id>.s9pk