[image-guide] Convert fedora image to RST
Change-Id: Ia3f667ed1b17d18647b3cc8d4c4f7860252f131c Implements: blueprint image-guide-rst
This commit is contained in:
KATO Tomoyuki
parent
8e2ffea25d
commit
551e6b15cc
@ -1,3 +1,219 @@
|
||||
=====================
|
||||
Example: Fedora image
|
||||
=====================
|
||||
|
||||
Download a `Fedora <http://getfedora.org/>`_ ISO image.
|
||||
This procedure lets you create a Fedora 20 image.
|
||||
|
||||
#. Start the installation using :command:`virt-install` as shown below:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# qemu-img create -f qcow2 fedora-20.qcow2 8G
|
||||
# virt-install --connect=qemu:///system --network=bridge:virbr0 \
|
||||
--extra-args="console=tty0 console=ttyS0,115200 serial rd_NO_PLYMOUTH" \
|
||||
--name=fedora-20 --disk path=/var/lib/libvirt/images/fedora-20.qcow2,format=qcow2,size=10,cache=none \
|
||||
--ram 2048 --vcpus=2 --check-cpu --accelerate --os-type linux --os-variant fedora19 \
|
||||
--hvm --location=http://dl.fedoraproject.org/pub/fedora/linux/releases/20/Fedora/x86_64/os/ \
|
||||
--nographics
|
||||
|
||||
This will launch a VM and start the installation process.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
Starting install...
|
||||
Retrieving file .treeinfo... | 2.2 kB 00:00:00 !!!
|
||||
Retrieving file vmlinuz... | 9.8 MB 00:00:05 !!!
|
||||
Retrieving file initrd.img... | 66 MB 00:00:37 !!!
|
||||
Allocating 'fedora-20.qcow2' | 10 GB 00:00:00
|
||||
Creating domain... | 0 B 00:00:00
|
||||
Connected to domain fedora-20
|
||||
Escape character is ^]
|
||||
[ 0.000000] Initializing cgroup subsys cpuset
|
||||
[ 0.000000] Initializing cgroup subsys cpu
|
||||
[ 0.000000] Initializing cgroup subsys cpuacct
|
||||
...
|
||||
...
|
||||
...
|
||||
[ OK ] Reached target Local File Systems (Pre).
|
||||
Starting installer, one moment...
|
||||
anaconda 20.25.15-1 for Fedora 20 started.
|
||||
========================================================================
|
||||
========================================================================
|
||||
|
||||
#. Choose the VNC or text mode to set the installation options.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
Text mode provides a limited set of installation options.
|
||||
It does not offer custom partitioning for full control over the
|
||||
disk layout. Would you like to use VNC mode instead?
|
||||
|
||||
1) Start VNC
|
||||
|
||||
2) Use text mode
|
||||
|
||||
Please make your choice from above ['q' to quit | 'c' to continue |
|
||||
'r' to refresh]:
|
||||
|
||||
#. Set the timezone, network configuration, installation source,
|
||||
and the root password. Optionally, you can choose to create a user.
|
||||
|
||||
#. Set up the installation destination as shown below:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
========================================================================
|
||||
Probing storage...
|
||||
Installation Destination
|
||||
|
||||
[x] 1) Virtio Block Device: 10.24 GB (vda)
|
||||
|
||||
1 disk selected; 10.24 GB capacity; 10.24 GB free ...
|
||||
|
||||
Please make your choice from above ['q' to quit | 'c' to continue |
|
||||
'r' to refresh]: c
|
||||
========================================================================
|
||||
========================================================================
|
||||
Autopartitioning Options
|
||||
|
||||
[ ] 1) Replace Existing Linux system(s)
|
||||
|
||||
[x] 2) Use All Space
|
||||
|
||||
[ ] 3) Use Free Space
|
||||
|
||||
Installation requires partitioning of your hard drive. Select what space
|
||||
to use for the install target.
|
||||
|
||||
Please make your choice from above ['q' to quit | 'c' to continue |
|
||||
'r' to refresh]: 2
|
||||
========================================================================
|
||||
========================================================================
|
||||
Autopartitioning Options
|
||||
|
||||
[ ] 1) Replace Existing Linux system(s)
|
||||
|
||||
[x] 2) Use All Space
|
||||
|
||||
[ ] 3) Use Free Space
|
||||
|
||||
Installation requires partitioning of your hard drive. Select what space
|
||||
to use for the install target.
|
||||
|
||||
Please make your choice from above ['q' to quit | 'c' to continue |
|
||||
'r' to refresh]: c
|
||||
========================================================================
|
||||
========================================================================
|
||||
Partition Scheme Options
|
||||
|
||||
[ ] 1) Standard Partition
|
||||
|
||||
[x] 2) LVM
|
||||
|
||||
[ ] 3) BTRFS
|
||||
|
||||
Select a partition scheme configuration.
|
||||
|
||||
Please make your choice from above ['q' to quit | 'c' to continue |
|
||||
'r' to refresh]: c
|
||||
Generating updated storage configuration
|
||||
Checking storage configuration...
|
||||
========================================================================
|
||||
|
||||
|
||||
#. Run the following commands from the host to eject the disk and
|
||||
reboot using :command:`virsh`, as root.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# virsh attach-disk --type cdrom --mode readonly fedora-20 "" hdc
|
||||
# virsh destroy fedora-20
|
||||
# virsh start fedora-20
|
||||
|
||||
You can also use the GUI to detach and reboot it by manually
|
||||
stopping and starting.
|
||||
|
||||
#. Log in as root user when you boot for the first time after installation.
|
||||
|
||||
#. Install and run the ``acpid`` service on the guest system to enable
|
||||
the virtual machine to reboot or shutdown an instance.
|
||||
|
||||
Run the following commands inside the Fedora guest to install the
|
||||
ACPI service and configure it to start when the system boots:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install acpid
|
||||
# chkconfig acpid on
|
||||
|
||||
#. Install ``cloud-init`` package inside the Fedora guest by adding
|
||||
the EPEL repo:
|
||||
|
||||
The ``cloud-init`` package automatically fetches the public key
|
||||
from the metadata server and places the key in an account.
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# yum install http://download.fedoraproject.org/pub/epel/6/x86_64/epel-release-6-8.noarch.rpm
|
||||
# yum install cloud-init
|
||||
|
||||
You can change the name of the account used by ``cloud-init``
|
||||
by editing the ``/etc/cloud/cloud.cfg`` file and adding a line with
|
||||
a different user. For example, to configure ``cloud-init`` to put the
|
||||
key in an account named admin, add this line to the configuration file:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
user: admin
|
||||
|
||||
#. Disable the default ``zeroconf`` route for the instance to access
|
||||
the metadata service:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# echo "NOZEROCONF=yes" >> /etc/sysconfig/network
|
||||
|
||||
#. For the :command:`nova console-log` command to work properly on
|
||||
Fedora 20, you might need to add the following lines to
|
||||
the ``/boot/grub/menu.lst`` file:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
serial --unit=0 --speed=115200
|
||||
terminal --timeout=10 console serial
|
||||
# Edit the kernel line to add the console entries
|
||||
kernel ... console=tty0 console=ttyS0,115200n8
|
||||
|
||||
#. Shut down the instance from inside the instance as a root user:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# /sbin/shutdown -h now
|
||||
|
||||
#. Clean up and remove MAC address details.
|
||||
|
||||
The operating system records the MAC address of the virtual Ethernet
|
||||
card in locations such as ``/etc/sysconfig/network-scripts/ifcfg-eth0``
|
||||
and ``/etc/udev/rules.d/70-persistent-net.rules`` during the instance
|
||||
process. However, each time the image boots up, the virtual Ethernet
|
||||
card will have a different MAC address, so this information must be
|
||||
deleted from the configuration file.
|
||||
|
||||
Use the :command:`virt-sysprep` utility. This performs various cleanup
|
||||
tasks such as removing the MAC address references.
|
||||
It will clean up a virtual machine image in place:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# virt-sysprep -d fedora-20
|
||||
|
||||
#. Undefine the domain since you no longer need to have this
|
||||
virtual machine image managed by libvirt:
|
||||
|
||||
.. code-block:: console
|
||||
|
||||
# virsh undefine fedora-20
|
||||
|
||||
The underlying image file that you created with
|
||||
:command:`qemu-img create` is ready to be uploaded to the Image service.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user