This repository is part of the Joyent Triton project. See the contribution guidelines and general documentation at the main Triton project page.
VMAPI is an HTTP API server for managing VMs on a Triton installation.
- Search for VMs by specific criteria such as ram, owner, tags, etc.
- Get information about a single VM
- Create VMs
- Perform actions on an existing VM such as start, stop, reboot, update, modify NICs, destroy, etc.
Typically VMAPI development is done by:
-
making edits to a clone of sdc-vmapi.git on a Mac (likely Linux too, but that's untested) or a SmartOS development zone,
git clone [email protected]:joyent/sdc-vmapi.git cd sdc-vmapi git submodule update --init # not necessary first time vi -
building:
make all make check -
syncing changes to a running SDC (typically a COAL running locally in VMWare) via: ./tools/rsync-to coal
-
then testing changes in that SDC (e.g. COAL). See "Testing" below for running the test suite.
-
Prerequisites:
- Set up fabrics on the Triton deployment.
- Ensure there are no existing NAT zones provisioned.
- Execute
sdcadm post-setup dev-headnode-prov.
-
To sync local changes to a running COAL and run the test suite there use:
make test-coal
-
To run tests while logged into a running VMAPI instance:
/opt/smartdc/vmapi/test/runtests