Building or downloading a deploy ramdisk image

Building or downloading a deploy ramdisk image

Ironic depends on having an image with the ironic-python-agent (IPA) service running on it for controlling and deploying bare metal nodes.

You can download a pre-built version of the deploy ramdisk built with the CoreOS tools at:

Building from source

There are two known methods for creating the deployment image with the IPA service:

CoreOS tools

  1. Clone the ironic-python-agent project:

    git clone https://git.openstack.org/openstack/ironic-python-agent
    
  2. Install the requirements:

    Fedora 21/RHEL7/CentOS7:
        sudo yum install docker gzip util-linux cpio findutils grep gpg
    
    Fedora 22 or higher:
        sudo dnf install docker gzip util-linux cpio findutils grep gpg
    
    Ubuntu 14.04 (trusty) or higher:
        sudo apt-get install docker.io gzip uuid-runtime cpio findutils grep gnupg
    
    SUSE:
        sudo zypper install docker gzip util-linux cpio findutils grep gpg2
    
  3. Change directory to imagebuild/coreos:

    cd ironic-python-agent/imagebuild/coreos
    
  4. Start the docker daemon:

    Fedora/RHEL7/CentOS7/SUSE:
        sudo systemctl start docker
    
    Ubuntu:
        sudo service docker start
    
  5. Create the image:

    sudo make
    
  6. Or, create an ISO image to boot with virtual media:

    sudo make iso
    

Note

Once built the deploy ramdisk and kernel will appear inside of a directory called UPLOAD.

disk-image-builder

  1. Follow diskimage-builder installation documentation to install diskimage-builder.

  2. Create the image:

    disk-image-create ironic-agent fedora -o ironic-deploy
    

    The above command creates the deploy ramdisk and kernel named ironic-deploy.vmlinuz and ironic-deploy.initramfs in your current directory.

  3. Or, create an ISO image to boot with virtual media:

    disk-image-create ironic-agent fedora iso -o ironic-deploy
    

    The above command creates the deploy ISO named ironic-deploy.iso in your current directory.

Note

Fedora was used as an example for the base operational system. Please check the diskimage-builder documentation for other supported operational systems.

Creative Commons Attribution 3.0 License

Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.