ironic/doc/source/install/deploy-ramdisk.rst
Ruby Loo 8aadc1a229 Correct URLs in install docs
This corrects the URLs in the install documentation. The changes include:
- changing http to https
- changing absolute links to relative links (where applicable)
- updating links (due to doc migrations)
- removing old links

Change-Id: Iecca07e0da5e6b326baa0142f366449a4c5cfd89
2017-08-22 16:47:46 -04:00

2.9 KiB

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.