From Fedora Project Wiki
Line 51: Line 51:
== Test Plan ==
== Test Plan ==


=== Test Appliance-creator tool in appliance tools package ===
==== Test Appliance-creator tool in appliance tools package ====


1. Pre-reqs - To properly test appliance-creator the following pre-reqs are needed: Running Rawhide, full virt box, kvm and qemu packages, as well as libvirt, virt-manager, libvirt-python, and python-virtinst
Since [[Releases/Rawhide| rawhide]] is not fully functional yet, the latest Appliance Tools packages have been built and are available for download at http://thincrust.org/download/. To install and test appliance-tools follow these instructions:
 
1. First, install F10 from rawhide
 
2. next, install all prerequisites using yum: *note to use kvm you must be running a full virt box
   yum install libvirt virt-manager libvirt-python python-virtinst qemu kvm
   yum install libvirt virt-manager libvirt-python python-virtinst qemu kvm


2. install appliance-tools and livecd-tools, due to the infrastructure issues and delays the appliance-tools package is not in the rawhide/testing repo as of yet.  Also appliance-tools needs a special version of livecd-tools that is not available in rawhide eitheryou will need to manually install these packages to test appliance-creator.
3. next, install the latest versions of appliance-tools and livecd-tools. *note as of this writing these packages are not in the rawhide/testing repo.  You will need to manually install these packages to test appliance-creator.
   rpm -ivh http://thincrust.net/download/appliance-tools-003-3.fc10.noarch.rpm
   rpm -ivh http://thincrust.net/download/appliance-tools-003-3.fc10.noarch.rpm
   rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.x86_64.rpm   
   rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.x86_64.rpm   
Line 62: Line 66:
   rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.i386.rpm
   rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.i386.rpm


3. build the appliance:
4. build the appliance:
   # appliance-creator -n ThinCrust -c /usr/share/appliance-tools/aos-rawhide.ks --cache /var/tmp/act/
   # appliance-creator -n ThinCrust -c /usr/share/appliance-tools/aos-rawhide.ks --cache /var/tmp/act/


4. launch appliance image:
5. launch appliance image:
   # virt-image ThinCrust.xml
   # virt-image ThinCrust.xml


Line 74: Line 78:
   # virt-viewer IDNUM
   # virt-viewer IDNUM


=== Test AOS image boots ===
==== Test AOS image boots ====
   1) Download image
   1) Download image
   2) Launch image on kvm via virt-image (repeat for X flavors of Fedora)
   2) Launch image on kvm via virt-image (repeat for X flavors of Fedora)

Revision as of 18:45, 27 August 2008

Appliance Building

Summary

Appliances are pre-installed, pre-configured, system images. This feature consists of a tools and meta-data that make it easier for anyone (ISVs, developers, OEMS, etc) to create and deploy virtual appliances. The two components of this feature are the ACT (Appliance Creation Tool) and the AOS (The Appliance Operating System)

Owner

Current status

Detailed Description

ACT: The Appliance Creation Tool is a tool to create Appliance Images from a kickstart file. This tool uses the liveCD creator API as well as patches to the LIVECD API originally written by Daniel P. Berrange to create a multi-partitioned disk image. These disk images can then be booted in a virtual container such as Xen, KVM, and VMware. This tool will be contained in the applianace-tools package. This package contains tools for building appliance images on Fedora based systems including derived distributions such as RHEL, CentOS and others.

AOS: The AOS is a scaled down version of Fedora with a small footprint containing only the packages necessary to run an appliance. The hardware supported by this spin of Fedora would be limited, primarily focusing on virtual containers such as KVM and VMware. The goal is to create a base that developers can build their applications on top of, only pulling in packages that their software requires. A "start from the bottom and build up" mentality.

This is similar to the concepts of (Just enough operation system).

See more info on the project at:

http://thincrust.net

Benefit to Fedora

The tooling will:

  • enable developers who want to build a fedora based appliance.
  • enable developers to build a pre-installed multi partitioned disk
  • start to form some continuity around what Fedora appliances will look like.

The proposed AOS spin will:

  • provide a template for developers who want to build a fedora based appliance.
  • provide a minimal version of fedora for those who want to start form the ground up and add only what they want/need
  • allow developers to "kick the tires" of the AOS without having to build it from scratch.

Scope

  • Requires new package applinace-tools
  • Requires hosting an AOS kickstart file in the kickstart pool
  • Requires hosting a binary image on http://spins.fedoraproject.org/
  • May require tooling changes to build/host an appliance image rather than a livecd iso? (appliance image = tar.gz which contains a binary disk image and meta-date used to launch the image.)

Target audience would mainly be developers wanting to quickly develop appliances based off of fedora

Test Plan

Test Appliance-creator tool in appliance tools package

Since rawhide is not fully functional yet, the latest Appliance Tools packages have been built and are available for download at http://thincrust.org/download/. To install and test appliance-tools follow these instructions:

1. First, install F10 from rawhide

2. next, install all prerequisites using yum: *note to use kvm you must be running a full virt box

 yum install libvirt virt-manager libvirt-python python-virtinst qemu kvm

3. next, install the latest versions of appliance-tools and livecd-tools. *note as of this writing these packages are not in the rawhide/testing repo. You will need to manually install these packages to test appliance-creator.

 rpm -ivh http://thincrust.net/download/appliance-tools-003-3.fc10.noarch.rpm
 rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.x86_64.rpm  
   - or -
 rpm -ivh http://thincrust.net/download/livecd-tools-018-1.fc10.thincrust.i386.rpm

4. build the appliance:

 # appliance-creator -n ThinCrust -c /usr/share/appliance-tools/aos-rawhide.ks --cache /var/tmp/act/

5. launch appliance image:

 # virt-image ThinCrust.xml

6. use "virsh list" to see if its running and get the IDNUM

 # virsh list

7. connect to appliance and log in with root/thincrust and verify its running:

 # virt-viewer IDNUM

Test AOS image boots

 1) Download image
 2) Launch image on kvm via virt-image (repeat for X flavors of Fedora)
 3) Launch image on VMware??
  • In all cases the expected results are really "It boots, we can log in"

User Experience

  • Users can download a pre-built binary image and run in a container such as vmware or KVM and be able to have a demo up and running in minimal time
# wget http://thincrust.org/downloads/thincrust.tar.gz
# tar xvfz thincrust.tar.gz
# virt-image ThinCrust.xml 
 
  • Users can build there own version of the AOS locally using the appliance-creator tool
# appliance-creator -n ThinCrust -c /usr/share/appliance-tools/aos-f9.ks --cache=/var/tmp/livecd/
# virt-image ThinCrust.xml

Dependencies

  • patches in Livecd-tools
    • [PATCH] added get_partitions to kickstart.py
    • [PATCH] re-factor imgcreate/fs.py module
    • [PATCH] added compat shims in fs.py for old api
    • [PATCH] switch internal code to use new api
  • commited on 08/05/2008 08:27 PM
    • [Fedora-livecd-list] 7 commits - imgcreate/creator.py imgcreate/fs.py imgcreate/kickstart.py imgcreate/live.py
    • commit: 5a3a91fe44795fb0d5c1f6215081b214d0af3f5b
  • There may be a soft dependency on the "fedora upstream" or "based on fedora" trademark discussion. We think it would really make this a strong feature if there was a story similar to: "Build the appliance, and brand it this way." without this, we need to provide alot more robust un-branding tools/doco.

Contingency Plan

  • port all functionality of new api re-factor imgcreate/fs.py module into applinace-tools package

Documentation

Release Notes

Fedora 10 now includes tools which make it easier for anyone (ISVs, developers, OEMS, etc) to create and deploy virtual appliances. These tools are extensions of existing fedora tools, Meta-data, and best practices for appliance development and delivery. With these tools anyone with basic scripting experience can build virtual appliances.

Comments and Discussion