No description, website, or topics provided.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
debian bump version to 2.60.7 [skip ci] Jul 6, 2018
extra modify version number of deb build in travis Jan 12, 2017
oem update Jan 16, 2018
syslinux reorganize the micro-docker folder Jan 16, 2018
.travis.yml Build the micro docker image and include rancherOS kernel and initrd Sep 11, 2017
LICENSE upgrade RancherOS to v1.2.0 Feb 8, 2018
Vagrantfile Update Vagrantfile to get the newest version of ansible Mar 23, 2016

on-imagebuilder Build Status

Copyright 2015-2018, Dell EMC, Inc.

This repository contains a set of scripts that uses Docker to build docker images that run in RancherOS, primarily for use with the on-taskgraph workflow engine.


  • Docker


Bootstrap process

The images produced by these scripts are intended to be netbooted and run in RAM. The typical flow for how these images are used/booted is this:

  • Netboot RacherOS(kernel and initrd) via PXE/iPXE
  • The custom cloud-config file requests a rackhd/micro docker image from the boot server. It then starts a container with full container capabilities using the rackhd/micro docker image.

Getting started

Building default images and ipxe

To build images, define an imagebuilding script (see or for an example) or use the default one. For example, to build the default images:

$ cd on-imagebuilder/
$ sudo ./

The build artifacts will be located in these directories below (which are defined in the ./ file):

  • /tmp/on-imagebuilder/builds/ : it includes the artifacts:

    • discovery.docker.tar.xz
    • initrd-*-rancher
    • vmlinuz-*-rancher
  • /tmp/on-imagebuilder/ipxe/ : it includes the artifacts:

    • monorail-efi32-snponly.efi
    • monorail-efi64-snponly.efi
    • monorail.ipxe
    • monorail-undionly.kpxe
  • /tmp/on-imagebuilder/syslinux : it includes the artifacts:

    • undionly.kkpxe

OEM tools

  • OEM docker images raid and secure_erase require storcli_1.17.08_all.deb being copied into the folder oem/raid or oem/secure_erase. User can download it from If a package with different name is to be used, user should use the build parameter STORCLI(see the example below).

  • OEM docker images dell_raid and secure_erase require perccli_1.11.03-1_all.deb being copied into the folder oem/dell_raid or oem/secure_erase. There is no .deb version perccli tool. User can download .rpm perccli from:

    Unzip the package and then use alien to get a .deb version perccli tool as below:

    sudo apt-get install alien
    sudo alien -k perccli-1.11.03-1.noarch.rpm

    Again, user can use a different perccli package via the build parameter PERCCLI(see the example below).

  • OEM docker image intel-flash requires flashupdt and syscfg under the folder oem/intel-flash. Download the files from Intel Download Center.

  • OEM docker image quanta-flash requires directory ami and socflash under the folder oem/quanta-flash. The essential files used by RackHD are:


    Get SCELNX_64 from vendor, and afulnx_64/socflash_x64 from Quanta Download Center.

An example to use oem tools for secure-erase(see more examples in

cd secure-erase
sudo docker build -t rackhd/micro \
  --build-arg PERCCLI=perccli_1.11.03-1_all.deb \
  --build-arg STORCLI=storcli_1.17.08_all.deb .
sudo docker save rackhd/micro | xz -z > secure.erase.docker.tar.xz
copy secure.erase.docker.tar.xz to on-http/static/http/common


Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

RackHD is a Trademark of Dell EMC