Tools for creating SmartOS images.

Seed images are the absolute baseline of a SmartOS image. They are created from files produced by a smartos-live build, containing the original /etc, /var and SMF manifest database.

First, you need to perform a smartos-live build, as described in the wiki page:

http://wiki.smartos.org/display/DOC/Building+SmartOS+on+SmartOS

For this example we are building the release-20141030 tag, in order to produce a seed-20141030 image off that baseline.

Then from the global zone:

$ ./create-seed /path/to/smartos-live seed-20141030 

This will create a zones/seed-20141030 file system containing the seed files.

Once you have a seed file system ready, use create-image to turn it into a provisionable image and manifest.

$ ./create-image seed-20141030 seed-20141030 

This will use /zones/seed-20141030, snapshot it, and create a file system image along with a manifest file ready for importing with imgadm.

Once complete it will output an imgadm command you can use, e.g.

Done. Now run this to install the image: imgadm install -m ./output/seed-20141030.json -f ./output/seed-20141030.zfs.gz 

If that's successful you can cleanup the temporary dataset:

$ zfs destroy zones/seed-20141030 

You can then use the UUID as input for the next phase.

Base images are comprised of a baseline seed image, plus an applied overlay appropriate for the target image. You use the install-image tool to copy the overlay files into a specified zone and then execute the customize script.

Start by creating a basic zone based on the seed image created above (replacing image_uuid with the uuid of the seed image):

$ vmadm create <<EOF { "brand": "joyent", "image_uuid": "1e9e46ec-e4e5-11e4-9bdb-1788911817ce", "max_physical_memory": 512, "alias": "seed-zone", "nics": [ { "nic_tag": "admin", "ip": "dhcp" } ] } EOF Successfully created VM c374c4bc-2395-4848-b28d-0c18937e7775 

Then we can apply the 2014Q4-i386 configuration to the VM with:

$ ./install-base -c 2014Q4-i386 -n base-32-lts -r 14.4.0 -z c374c4bc-2395-4848-b28d-0c18937e7775 

This uses the 2014Q4-i386 configuration, sets the version number to 14.4.0 and installs to the specified zone.

The final part of this script runs sm-prepare-image which does some final image cleanup and shutdown, after which you can simply generate the finished image, again with create-image:

$ ./create-image base-32-lts-14.4.0 c374c4bc-2395-4848-b28d-0c18937e7775 

This final image and manifest should now be suitable for production use.