instack-undercloud/README-build-images.md

Overcloud image building

Using tripleo packages

1. Enable copr.

    sudo curl -o /etc/yum.repos.d/slagle-openstack-m.repo https://copr.fedoraproject.org/coprs/slagle/openstack-m/repo/fedora-20/slagle-openstack-m-fedora-20.repo
   

2. Install instack-undercloud

    sudo yum -y install instack-undercloud diskimage-builder openstack-tripleo-image-elements
   

3. Build images. Enable the use of the needed extra elements for now.

    export DIB_COMMON_ELEMENTS="tripleo-image-elements copr-openstack-m rdo-juno-stage"
    instack-build-images
    # Note that you can build just a single image type by passing the image name as the first
    # argument to instack-build-images like so:
    # instack-build-images overcloud-control
   

Using tripleo source

1. Create initial directory for instack, and clone the needed repositories.

     mkdir instack
     cd instack
     git clone https://github.com/rdo-management/instack-undercloud
   

2. Setup needed checkouts. If you don't want to use Delorean packages, or the last known good commits (use latest from trunk), then set those environment variables to 0. Exporting RUN_INSTACK=0 will create the initial checkouts. Note however that some pip dependencies will still be installed on the machine.

    # If you don't want to use Delorean...
    # export DELOREAN=0
    # If you don't want to use the last known good commits...
    # export LKG=0
   
    source instack-undercloud/instack-sourcerc
    export RUN_INSTACK=0
    instack-install-undercloud-source
   

3. Run script to build images. This will create any Overcloud images and deployment images that don't already exist in the current directory. If you only need to rebuild a single image, make sure the other images already exist in the current directory.

    instack-build-images