devtest_undercloud

1. Create your undercloud image. This is the image that the seed nova will deploy to become the baremetal undercloud. $UNDERCLOUD_DIB_EXTRA_ARGS is meant to be used to pass additional arguments to disk-image-create.

   NODE_ARCH=$(os-apply-config -m $TE_DATAFILE --key arch --type raw)
       $TRIPLEO_ROOT/diskimage-builder/bin/disk-image-create $NODE_DIST \
           -a $NODE_ARCH -o $TRIPLEO_ROOT/undercloud \
           boot-stack nova-baremetal os-collect-config dhcp-all-interfaces \
           neutron-dhcp-agent $DIB_COMMON_ELEMENTS $UNDERCLOUD_DIB_EXTRA_ARGS 2>&1 | \
           tee $TRIPLEO_ROOT/dib-undercloud.log

2. Load the undercloud image into Glance:

   UNDERCLOUD_ID=$(load-image $TRIPLEO_ROOT/undercloud.qcow2)

3. Create secrets for the cloud. The secrets will be written to a file (tripleo-undercloud-passwords by default) that you need to source into your shell environment. Note that you can also make or change these later and update the heat stack definition to inject them - as long as you also update the keystone recorded password. Note that there will be a window between updating keystone and instances where they will disagree and service will be down. Instead consider adding a new service account and changing everything across to it, then deleting the old account after the cluster is updated.

   setup-undercloud-passwords
   source tripleo-undercloud-passwords

4. Pull out needed variables from the test environment definition.

   POWER_MANAGER=$(os-apply-config -m $TE_DATAFILE --key power_manager --type raw)
   POWER_KEY=$(os-apply-config -m $TE_DATAFILE --key ssh-key --type raw)
   POWER_HOST=$(os-apply-config -m $TE_DATAFILE --key host-ip --type raw)
   POWER_USER=$(os-apply-config -m $TE_DATAFILE --key ssh-user --type raw)

5. Deploy an undercloud.

   make -C $TRIPLEO_ROOT/tripleo-heat-templates undercloud-vm.yaml
   heat stack-create -f $TRIPLEO_ROOT/tripleo-heat-templates/undercloud-vm.yaml \
       -P "PowerUserName=${POWER_USER}" \
       -P "AdminToken=${UNDERCLOUD_ADMIN_TOKEN}" \
       -P "AdminPassword=${UNDERCLOUD_ADMIN_PASSWORD}" \
       -P "GlancePassword=${UNDERCLOUD_GLANCE_PASSWORD}" \
       -P "HeatPassword=${UNDERCLOUD_HEAT_PASSWORD}" \
       -P "NeutronPassword=${UNDERCLOUD_NEUTRON_PASSWORD}" \
       -P "NovaPassword=${UNDERCLOUD_NOVA_PASSWORD}" \
       -P "BaremetalArch=${NODE_ARCH}" \
       -P "PowerManager=${POWER_MANAGER}" \
       -P "undercloudImage=${UNDERCLOUD_ID}" \
       -P "PowerSSHPrivateKey=${POWER_KEY}" \
       -P "PowerSSHHost=${POWER_HOST}" \
       undercloud

   You can watch the console via virsh/virt-manager to observe the PXE boot/deploy process. After the deploy is complete, it will reboot into the image.

6. Get the undercloud IP from ‘nova list’

   wait_for 220 10 stack-ready undercloud
   export UNDERCLOUD_IP=$(nova list | grep ctlplane | sed  -e "s/.*=\\([0-9.]*\\).*/\1/")

7. We don’t (yet) preserve ssh keys on rebuilds.

   ssh-keygen -R $UNDERCLOUD_IP

8. Exclude the undercloud from proxies:

   export no_proxy=$no_proxy,$UNDERCLOUD_IP

9. Export the undercloud endpoint and credentials to your test environment.

   UNDERCLOUD_ENDPOINT="http://$UNDERCLOUD_IP:5000/v2.0"
   NEW_JSON=$(jq '.undercloud.password="'${UNDERCLOUD_ADMIN_PASSWORD}'" | .undercloud.endpoint="'${UNDERCLOUD_ENDPOINT}'" | .undercloud.endpointhost="'${UNDERCLOUD_IP}'"' $TE_DATAFILE)
   echo $NEW_JSON > $TE_DATAFILE

10. Source the undercloud configuration:

    source $TRIPLEO_ROOT/tripleo-incubator/undercloudrc

11. Perform setup of your undercloud.

    init-keystone -p $UNDERCLOUD_ADMIN_PASSWORD $UNDERCLOUD_ADMIN_TOKEN \
        $UNDERCLOUD_IP admin@example.com heat-admin@$UNDERCLOUD_IP
    setup-endpoints $UNDERCLOUD_IP --glance-password $UNDERCLOUD_GLANCE_PASSWORD \
        --heat-password $UNDERCLOUD_HEAT_PASSWORD \
        --neutron-password $UNDERCLOUD_NEUTRON_PASSWORD \
        --nova-password $UNDERCLOUD_NOVA_PASSWORD
    keystone role-create --name heat_stack_user
    
    user-config
    
    setup-neutron 192.0.2.5 192.0.2.24 192.0.2.0/24 192.0.2.1 $UNDERCLOUD_IP ctlplane

12. Register two baremetal nodes with your undercloud.

    MAC_RANGE="2-$(( $OVERCLOUD_COMPUTESCALE + 2 ))"
    UNDERCLOUD_MACS=$(OS_CONFIG_FILES=$TE_DATAFILE os-apply-config --key node-macs --type raw | cut -d' ' -f $MAC_RANGE )
    UNDERCLOUD_PM_IPS=$(OS_CONFIG_FILES=$TE_DATAFILE os-apply-config --key node-pm-ips --type raw --key-default '' | cut -d' ' -f $MAC_RANGE )
    UNDERCLOUD_PM_USERS=$(OS_CONFIG_FILES=$TE_DATAFILE os-apply-config --key node-pm-users --type raw --key-default '' | cut -d' ' -f $MAC_RANGE )
    UNDERCLOUD_PM_PASSWORDS=$(OS_CONFIG_FILES=$TE_DATAFILE os-apply-config --key node-pm-passwords --type raw --key-default '' | cut -d' ' -f $MAC_RANGE )
    setup-baremetal $NODE_CPU $NODE_MEM $NODE_DISK $NODE_ARCH "$UNDERCLOUD_MACS" undercloud "$UNDERCLOUD_PM_IPS" "$UNDERCLOUD_PM_USERS" "$UNDERCLOUD_PM_PASSWORDS"