index.rst 1.6 KB
Newer Older
1
2
3
4
5
6
7
8
.. snf-image documentation master file, created by
   sphinx-quickstart on Fri Sep 13 16:50:13 2013.
   You can adapt this file completely to your liking, but it should at least
   contain the root `toctree` directive.

Welcome to snf-image's documentation!
=====================================

9
10
.. image:: /images/logo.png

11
12
13
14
15
snf-image is a `Ganeti <http://code.google.com/p/ganeti/>`_ OS definition. It
allows Ganeti to launch instances from predefined or untrusted custom Images.
The whole process of deploying an Image onto the block device, as provided by
Ganeti, is done in complete isolation from the physical host, enhancing
robustness and security.
16
17

snf-image supports `KVM <http://www.linux-kvm.org/page/Main_Page>`_ and
18
`Xen <http://www.xenproject.org/>`_ based Ganeti clusters.
19

20
snf-image also supports Image customization via hooks. Hooks allow for:
21
22
23
24
25
26

 * changing the password of root or arbitrary users
 * injecting files at arbitrary locations inside the filesystem, e.g., SSH keys
 * setting a custom hostname
 * re-creating SSH host keys to ensure the image uses unique keys

27
28
29
30
snf-image is being used in large scale production environments with Ganeti to
successfully deploy many major Linux distributions (Debian, Ubuntu/Kubuntu,
CentOS, Fedora, OpenSUSE), Windows 2008 R2 & Windows Server 2012, as well as
FreeBSD 9.1.
31
32
33
34
35

The snf-image Ganeti OS Definition is released under
`GPLv2 <http://www.gnu.org/licenses/gpl-2.0.html>`_.


36
Contents:
37
^^^^^^^^^
38
39
40
41

.. toctree::
   :maxdepth: 2

42
43
44
   architecture
   installation
   usage
45
   advanced
46

47
48
49
50
51
52
Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`