Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
bare minimum image server for SmartOS
JavaScript Shell
branch: master

Merge pull request #9 from johnko/patch-2

add section about project-fifo
latest commit a9f34c9f15
@nshalman authored
Failed to load latest commit information.
Makefile SMF method_credential now uses :default for group and supp_groups
README.md add section about project-fifo
config.json * Updated README (and changed to Markdown)
import-image
mkimg * Updated README (and changed to Markdown)
package.json Removed smf script from package.json, didn't belong there
server.js Add headers to allow use with project-fifo

README.md

smartos-image-server

bare minimum image server for SmartOS

Installing in a SmartOS zone

pkgin in nodejs scmgit
git clone https://github.com/nshalman/smartos-image-server
cd smartos-image-server
make

Configuration

After installation is complete, you should update config.json for your environment. At the very least you should set an image-creator name for your organization, if you intend to use the supplied import-image script to publish images.

Running behind ngnix

config.json:

{
    "listen_port": "/var/tmp/image-server.sock",
    "prefix": "http://",
    "suffix": "",
    "loglevel": "info",
  "image-creator": "internal",
  "image-creator-uuid": "...",
  "image-vendor-uuid": "..."
}

nginx config snippet:

    server {
        listen       80;
        server_name  datasets.shalman.org;
        location / {
            proxy_set_header Host $host;
            proxy_pass http://unix:/var/tmp/image-server.sock:;
        }
    }

Enabling the image server

After installation is complete, you can import the SMF manifest and enable the service.

svccfg import image-server.smf.xml
svcadm enable image-server

Serving images

To serve images, the "serve_dir" (configured in config.json, defaults to smartos-image-server directory) needs to be populated with manifests and zfs send streams in the proper hierarchy (see structure below).

Once populated, add http:///datasets to /var/db/imgadm/sources.list

Then:

imgadm update
imgadm avail

Loading images into project-fifo's web-ui "Remote Datasets"

Caution: This removes loading remote images from the mirror 'datasets.at'

Replace XXX.XXX.XXX.XXX with the IP or domain name of your smartos-image-server

On your fifo machine, run:

imageserver_ip="XXX.XXX.XXX.XXX"
sed -i 's/datasets.at/${imageserver_ip}/' /opt/local/fifo-jingles/app/scripts/config.js

To undo:

imageserver_ip="XXX.XXX.XXX.XXX"
sed -i 's/${imageserver_ip}/datasets.at/' /opt/local/fifo-jingles/app/scripts/config.js

Publishing images

There's a few options for publishing images to the image server:

Using import-image

The long way, from the global zone:

zlogin a48b615e-76fb-11e2-9502-6b130bf7f4ff 
sm-prepare-image
# exit / wait for zone to stop
zfs snapshot zones/a48b615e-76fb-11e2-9502-6b130bf7f4ff@image
zfs send zones/a48b615e-76fb-11e2-9502-6b130bf7f4ff@image | gzip | ssh datasets.yourdomain.local '/path/to/import-image orgbase 1.0.0 "Base image for our organization"'
imgadm update
imgadm avail

Alternatively, there's a mkimg script included that can be copied to the global zone (/opt/local/bin), and used to make the above process simpler. To do so, first edit the mkimg script and set IMGSERVER, IMPORTPATH, and LOGIN to proper values for your environment. Once configured you can now publish images from the global zone by doing:

mkimg <uuid> <name> <version> <description>

Example:

mkimg a48b615e-76fb-11e2-9502-6b130bf7f4ff orgbase 1.0.0 "Base image for our organization"

Structure

By default, images are stored under smartos-image-server. This can be changed in config.json.

smartos-image-server/
    server.js
    config.json
  import-image
    <uuid>/
        manifest.json
        <zfs-stream-file>.<extension>

Requirements

  • nodejs>=0.8
  • node-restify

Final thoughts

There is some basic error checking, but it could probably be improved.

Patches Welcome!!

Something went wrong with that request. Please try again.