How to develop addons in --devmode
¶
Developing and testing addons using the Anbox Management Service (AMS) may be time-consuming. Instead, an instance with --devmode
enabled can provide a safe environment to develop and test addons and their hooks without having to upload the addon to the AMS.
This guide explains how to use an instance in development mode to develop and test an addon using Anbox runtime. See Development mode to learn more about development mode enabled instances.
Launch an instance in development mode¶
Start a raw instance with --devmode
enabled:
amc launch --devmode --raw
or
amc launch --vm --devmode --raw
The command prints out the ID of the instance. Note down the instance ID for next steps.
Use the amc shell <instance_id>
command to open a shell inside the instance. instance_id
is the instance ID from the previous step.
Alternatively, you can use amc exec <instance_id> <command_options>
to directly execute commands inside the instance.
Create an addon within the instance¶
Use the instance as a remote environment to develop your addon. To make your addon source available within the instance, either copy the addon manifest and hooks using the lxc file push
command or clone a git repository using SSH.
You can test your addon hooks by running it inside the instance shell. For example, ADDON_DIR=$PWD ./hooks/install
can help test if the install hook of the addon works. See Environment variables for a list of available variables.
To troubleshoot issues within the instance, try either of the following options:
Run
amc logs <instance_id>
on the host to see the Anbox runtime logs.Run
journalctl --no-pager
within the instance to view instance logs.Restart the instance using
amc stop <instance_id>
and thenamc start <instance_id>
.
Example: Launch an SSH-enabled container for remote development¶
This example uses a container for demonstration, you can create an SSH-enabled VM using the same procedure by using the --vm
option when launching the instance.
# Launch and obtain the container id
id="$(amc launch --devmode -s ssh --raw)"
# Install the ssh-import-id package
amc exec $id -- apt install -y ssh-import-id
# Import SSH keys from GitHub; Use lp:<username> for Launchpad
amc exec $id -- ssh-import-id gh:<username>
# Get the container's public IP address
# Run `sudo apt install jq` if `jq` is not already installed
container_address="$(amc show $id --format=json | jq -r '.network.public_address')"
# Get the SSH port
node_port="$(amc show $id --format=json | jq -r '.network.services[0].node_port')"
# Connect to the container using SSH
ssh -p "$node_port" root@"$container_address"
Once you are logged in to the instance, you can remotely develop and test your addon within the instance. For example, see how to set up VS Code for remote development using SSH.