From 90d1ac43c20f80b18f4a6c3807f8842cfe5c4970 Mon Sep 17 00:00:00 2001 From: Hironori Shiina <shiina.hironori@jp.fujitsu.com> Date: Mon, 22 May 2017 11:25:15 +0900 Subject: [PATCH] Add a guide for Devstack configuration for boot-from-volume This patch adds a guide for Devstack configuration to build a environment to test boot-from-volume feature with VMs. Change-Id: If1a2f1a712af61618ec6e96ce3bad67295ddcff3 Partial-Bug: #1559691 --- doc/source/contributor/dev-quickstart.rst | 2 + doc/source/contributor/index.rst | 11 ++ .../contributor/ironic-boot-from-volume.rst | 120 ++++++++++++++++++ 3 files changed, 133 insertions(+) create mode 100644 doc/source/contributor/ironic-boot-from-volume.rst diff --git a/doc/source/contributor/dev-quickstart.rst b/doc/source/contributor/dev-quickstart.rst index 601569a5b4..b31a9a6e9a 100644 --- a/doc/source/contributor/dev-quickstart.rst +++ b/doc/source/contributor/dev-quickstart.rst @@ -397,6 +397,8 @@ help with that, but are not an exhaustive troubleshooting guide:: pip install -U -e . +.. _`deploy_devstack`: + Deploying Ironic with DevStack ============================== diff --git a/doc/source/contributor/index.rst b/doc/source/contributor/index.rst index 1779360d45..6390dc42a2 100644 --- a/doc/source/contributor/index.rst +++ b/doc/source/contributor/index.rst @@ -75,6 +75,17 @@ configuration for devstack to bring up this environment. Configuring Devstack for multitenant network testing <ironic-multitenant-networking> +Testing Boot-from-Volume +------------------------ + +Starting with the Pike release, it is also possible to use DevStack for testing +booting from Cinder volumes with VMs. + +.. toctree:: + :maxdepth: 1 + + Configuring Devstack for boot-from-volume testing <ironic-boot-from-volume> + Full Ironic Server Python API Reference --------------------------------------- diff --git a/doc/source/contributor/ironic-boot-from-volume.rst b/doc/source/contributor/ironic-boot-from-volume.rst new file mode 100644 index 0000000000..b7c3951101 --- /dev/null +++ b/doc/source/contributor/ironic-boot-from-volume.rst @@ -0,0 +1,120 @@ +===================================== +Ironic Boot-from-Volume with DevStack +===================================== + +This guide shows how to setup DevStack for enabling boot-from-volume feature, +which has been supported from the Pike release. + +This scenario shows how to setup DevStack to enable nodes to boot from volumes +managed by cinder with VMs as baremetal servers. + +DevStack Configuration +====================== + +The following is ``local.conf`` that will setup DevStack with 3 VMs that are +registered in ironic. A volume connector with IQN is created for each node. +These connectors can be used to connect volumes created by cinder. The detailed +description for DevStack is at :ref:`deploy_devstack`. + +:: + + [[local|localrc]] + + enable_plugin ironic git://git.openstack.org/openstack/ironic + + IRONIC_STORAGE_INTERFACE=cinder + + # Credentials + ADMIN_PASSWORD=password + DATABASE_PASSWORD=password + RABBIT_PASSWORD=password + SERVICE_PASSWORD=password + SERVICE_TOKEN=password + SWIFT_HASH=password + SWIFT_TEMPURL_KEY=password + + # Enable Neutron which is required by Ironic and disable nova-network. + disable_service n-net + disable_service n-novnc + enable_service q-svc + enable_service q-agt + enable_service q-dhcp + enable_service q-l3 + enable_service q-meta + enable_service neutron + + # Enable Swift for agent_* drivers + enable_service s-proxy + enable_service s-object + enable_service s-container + enable_service s-account + + # Disable Horizon + disable_service horizon + + # Disable Heat + disable_service heat h-api h-api-cfn h-api-cw h-eng + + # Swift temp URL's are required for agent_* drivers. + SWIFT_ENABLE_TEMPURLS=True + + # Create 3 virtual machines to pose as Ironic's baremetal nodes. + IRONIC_VM_COUNT=3 + IRONIC_BAREMETAL_BASIC_OPS=True + DEFAULT_INSTANCE_TYPE=baremetal + + # Enable Ironic drivers. + IRONIC_ENABLED_DRIVERS=fake,agent_ipmitool,pxe_ipmitool + + # Change this to alter the default driver for nodes created by devstack. + # This driver should be in the enabled list above. + IRONIC_DEPLOY_DRIVER=agent_ipmitool + + # The parameters below represent the minimum possible values to create + # functional nodes. + IRONIC_VM_SPECS_RAM=1280 + IRONIC_VM_SPECS_DISK=10 + + # Size of the ephemeral partition in GB. Use 0 for no ephemeral partition. + IRONIC_VM_EPHEMERAL_DISK=0 + + # To build your own IPA ramdisk from source, set this to True + IRONIC_BUILD_DEPLOY_RAMDISK=False + + VIRT_DRIVER=ironic + + # By default, DevStack creates a 10.0.0.0/24 network for instances. + # If this overlaps with the hosts network, you may adjust with the + # following. + NETWORK_GATEWAY=10.1.0.1 + FIXED_RANGE=10.1.0.0/24 + FIXED_NETWORK_SIZE=256 + + # Log all output to files + LOGFILE=$HOME/devstack.log + LOGDIR=$HOME/logs + IRONIC_VM_LOG_DIR=$HOME/ironic-bm-logs + +After the environment is built, you can create a volume with cinder and request +an instance with the volume to nova:: + + source ~/devstack/openrc + + # query the image id of the default cirros image + image=$(openstack image show $DEFAULT_IMAGE_NAME -f value -c id) + + # create keypair + ssh-keygen + openstack keypair create --public-key ~/.ssh/id_rsa.pub default + + # create volume + volume=$(openstack volume create --image $image --size 1 my-volume -f value -c id) + + # spawn instance + openstack server create --flavor baremetal --volume $volume --key-name default testing + +You can also run an integration test that an instance is booted from a remote +volume with tempest in the environment:: + + cd /opt/stack/tempest + tox -e all-plugin -- ironic_tempest_plugin.tests.scenario.test_baremetal_boot_from_volume