index.rst 1.76 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
.. image:: images/logo.png
10

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
 * Changing the password of root or arbitrary users
 * Injecting files into the file system, e.g., SSH keys
24
25
26
 * setting a custom hostname
 * re-creating SSH host keys to ensure the image uses unique keys

27
28
snf-image is being used in large scale production environments with Ganeti to
successfully deploy many major Linux distributions (Debian, Ubuntu/Kubuntu,
29
30
31
32
CentOS, Fedora, OpenSUSE, Slackware, Arch Linux, CoreOS), Windows Server
flavors (2008 R2, 2012, 20012 R2), as well as BSD systems (FreeBSD, OpenBSD,
NetBSD). It is also known to work well with current Desktop versions of Windows
(7, 8, 8.1).
33
34
35
36
37

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


38
Contents:
39
^^^^^^^^^
40
41
42
43

.. toctree::
   :maxdepth: 2

44
   architecture
45
   interface
46
   installation
47
   configuration
48
   usage
49
   advanced
50

51
52
53
54
55
56
Indices and tables
==================

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