root / docs / index.rst @ 999bf7b6
History | View | Annotate | Download (5.4 kB)
1 | f936cac5 | Constantinos Venetsanopoulos | Welcome to the Synnefo documentation |
---|---|---|---|
2 | f936cac5 | Constantinos Venetsanopoulos | ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ |
3 | 9940eacf | Kostas Papadimitriou | |
4 | 9940eacf | Kostas Papadimitriou | .. image:: /images/synnefo-logo.png |
5 | 9940eacf | Kostas Papadimitriou | |
6 | 3a0ce98e | Constantinos Venetsanopoulos | Synnefo is a complete open source cloud stack written in Python that provides |
7 | 3a0ce98e | Constantinos Venetsanopoulos | Compute, Network, Image, Volume and Storage services, similar to the ones |
8 | 3a0ce98e | Constantinos Venetsanopoulos | offered by AWS. Synnefo manages multiple `Ganeti |
9 | 3a0ce98e | Constantinos Venetsanopoulos | <http://code.google.com/p/ganeti>`_ clusters at the backend for handling of |
10 | f936cac5 | Constantinos Venetsanopoulos | low-level VM operations and uses `Archipelago |
11 | f936cac5 | Constantinos Venetsanopoulos | <http://www.synnefo.org/docs/archipelago/latest/>`_ to unify cloud storage. To |
12 | f936cac5 | Constantinos Venetsanopoulos | boost 3rd-party compatibility, Synnefo exposes the OpenStack APIs to users. |
13 | 9940eacf | Kostas Papadimitriou | |
14 | f936cac5 | Constantinos Venetsanopoulos | Synnefo powers GRNET's `~okeanos public cloud service |
15 | f936cac5 | Constantinos Venetsanopoulos | <http://okeanos.grnet.gr>`_ and you can try it out live at `demo.synnefo.org |
16 | f936cac5 | Constantinos Venetsanopoulos | <http://demo.synnefo.org>`_. |
17 | 3a0ce98e | Constantinos Venetsanopoulos | |
18 | 3a0ce98e | Constantinos Venetsanopoulos | Synnefo has three main components providing the corresponding services: |
19 | 9940eacf | Kostas Papadimitriou | |
20 | d0e436db | Constantinos Venetsanopoulos | .. toctree:: |
21 | d0e436db | Constantinos Venetsanopoulos | :maxdepth: 1 |
22 | 9940eacf | Kostas Papadimitriou | |
23 | 3a0ce98e | Constantinos Venetsanopoulos | Astakos: Identity/Account services <astakos> |
24 | 3a0ce98e | Constantinos Venetsanopoulos | Pithos: File/Object Storage service <pithos> |
25 | 3a0ce98e | Constantinos Venetsanopoulos | Cyclades: Compute/Network/Image/Volume services <cyclades> |
26 | d6153e72 | Kostas Papadimitriou | |
27 | 3a0ce98e | Constantinos Venetsanopoulos | This is an overview of the Synnefo services: |
28 | 3a0ce98e | Constantinos Venetsanopoulos | |
29 | 3a0ce98e | Constantinos Venetsanopoulos | .. image:: images/synnefo-overview.png |
30 | beb1af5f | Constantinos Venetsanopoulos | :width: 70% |
31 | 3a0ce98e | Constantinos Venetsanopoulos | :target: _images/synnefo-overview.png |
32 | d0e436db | Constantinos Venetsanopoulos | |
33 | f936cac5 | Constantinos Venetsanopoulos | Synnefo is designed with simplicity, scalability and stability in mind. |
34 | beb1af5f | Constantinos Venetsanopoulos | Although it can be deployed in small configurations, it was initially designed |
35 | beb1af5f | Constantinos Venetsanopoulos | to address large-scale installation problems. |
36 | d0e436db | Constantinos Venetsanopoulos | |
37 | f936cac5 | Constantinos Venetsanopoulos | All Synnefo components use an intuitive settings mechanism, that adds and |
38 | f936cac5 | Constantinos Venetsanopoulos | removes settings dynamically as components are getting added or removed from a |
39 | f936cac5 | Constantinos Venetsanopoulos | physical node. All settings are stored in a single location. |
40 | d0e436db | Constantinos Venetsanopoulos | |
41 | 14267d89 | Constantinos Venetsanopoulos | |
42 | 301294a9 | Constantinos Venetsanopoulos | .. _general-arch: |
43 | d0e436db | Constantinos Venetsanopoulos | |
44 | eab73849 | Constantinos Venetsanopoulos | Synnefo General Architecture |
45 | eab73849 | Constantinos Venetsanopoulos | ============================ |
46 | eab73849 | Constantinos Venetsanopoulos | |
47 | f936cac5 | Constantinos Venetsanopoulos | The following figure shows the whole Synnefo stack and how it interacts with |
48 | 14267d89 | Constantinos Venetsanopoulos | multiple Ganeti clusters and the storage backends. Synnefo decouples the cloud |
49 | beb1af5f | Constantinos Venetsanopoulos | from the cluster layer, enhancing robustness and easing administration and |
50 | beb1af5f | Constantinos Venetsanopoulos | upgrades without impacting VM stability. As shown in the figure below, Synnefo |
51 | beb1af5f | Constantinos Venetsanopoulos | sits on the cloud layer: |
52 | eab73849 | Constantinos Venetsanopoulos | |
53 | 14267d89 | Constantinos Venetsanopoulos | .. image:: images/snf-architecture.png |
54 | beb1af5f | Constantinos Venetsanopoulos | :width: 70% |
55 | 14267d89 | Constantinos Venetsanopoulos | :target: _images/snf-architecture.png |
56 | 14267d89 | Constantinos Venetsanopoulos | |
57 | f936cac5 | Constantinos Venetsanopoulos | Synnefo manages multiple Ganeti clusters and different storage backends |
58 | f936cac5 | Constantinos Venetsanopoulos | (e.g., Ceph/RADOS or NFS-based backends as shown in the figure). |
59 | 14267d89 | Constantinos Venetsanopoulos | |
60 | f936cac5 | Constantinos Venetsanopoulos | For an extensive view of all components, the interconnection and APIs between |
61 | f936cac5 | Constantinos Venetsanopoulos | them, please take a look at the Admin Guide's :ref:`corresponding figure |
62 | f936cac5 | Constantinos Venetsanopoulos | <syn+archip>`. |
63 | eab73849 | Constantinos Venetsanopoulos | |
64 | eab73849 | Constantinos Venetsanopoulos | |
65 | bc055d09 | Constantinos Venetsanopoulos | Synnefo Guides |
66 | bc055d09 | Constantinos Venetsanopoulos | ============== |
67 | d0e436db | Constantinos Venetsanopoulos | |
68 | 2ca07643 | Constantinos Venetsanopoulos | There are 4 guides for Synnefo. |
69 | 2ca07643 | Constantinos Venetsanopoulos | |
70 | 2ca07643 | Constantinos Venetsanopoulos | The Quick Installation guide describes how to install Synnefo on a single node |
71 | 2ca07643 | Constantinos Venetsanopoulos | in less than 10 minutes using the `snf-deploy` tool. This kind of installation |
72 | 2ca07643 | Constantinos Venetsanopoulos | is targeted for testing and demo environments rather than production usage |
73 | 2ca07643 | Constantinos Venetsanopoulos | deployments. It is the perfect way, even for an inexperienced user to have the |
74 | 2ca07643 | Constantinos Venetsanopoulos | whole Synnefo stack up and running and allows for a quick preview of the basic |
75 | 2ca07643 | Constantinos Venetsanopoulos | Synnefo features. |
76 | 2ca07643 | Constantinos Venetsanopoulos | |
77 | f936cac5 | Constantinos Venetsanopoulos | The Admin's Installation guide describes how to install the whole Synnefo stack |
78 | 2ca07643 | Constantinos Venetsanopoulos | in just two physical nodes. This guide is useful to those interested in |
79 | 2ca07643 | Constantinos Venetsanopoulos | deploying Synnefo in large scale, as a starting point that will help them get |
80 | 2ca07643 | Constantinos Venetsanopoulos | familiar with the Synnefo components and overall architecture, as well as the |
81 | 2ca07643 | Constantinos Venetsanopoulos | interconnection between different services. This guide explains the whole |
82 | 2ca07643 | Constantinos Venetsanopoulos | procedure step by step, without the use of the `snf-deploy` tool. Anyone |
83 | 2ca07643 | Constantinos Venetsanopoulos | familiar with this guide, will be able to easily install Synnefo in a larger |
84 | 2ca07643 | Constantinos Venetsanopoulos | number of nodes too, or even expand the two node installation dynamically. |
85 | 7a3439cf | Constantinos Venetsanopoulos | |
86 | 7a3439cf | Constantinos Venetsanopoulos | The Administrator's Guide targets system administrators, who want to dive into |
87 | 301294a9 | Constantinos Venetsanopoulos | more details and common tasks regarding Synnefo. For the experienced Synnefo |
88 | 8b5be818 | Constantinos Venetsanopoulos | administrator, there is also a section that describes how to do scale-out |
89 | 8b5be818 | Constantinos Venetsanopoulos | Synnefo deployments with corresponding examples. This targets large scale |
90 | 8b5be818 | Constantinos Venetsanopoulos | installations of Synnefo. |
91 | 7a3439cf | Constantinos Venetsanopoulos | |
92 | 301294a9 | Constantinos Venetsanopoulos | The Developer's Guide targets developers, who want to build on top of Synnefo |
93 | 301294a9 | Constantinos Venetsanopoulos | and so describes all the different types of interfaces Synnefo provides to the |
94 | 8b5be818 | Constantinos Venetsanopoulos | external world. Also documents all Synnefo external REST APIs. |
95 | 8b5be818 | Constantinos Venetsanopoulos | |
96 | 8b5be818 | Constantinos Venetsanopoulos | .. The Integrator's Guide targets developers, who want to actually |
97 | 8b5be818 | Constantinos Venetsanopoulos | .. extend/modify/change Synnefo itself, so describes Synnefo's indepth |
98 | 8b5be818 | Constantinos Venetsanopoulos | .. architecture and the internals of Synnefo components (currently out-of-date!). |
99 | 6928da52 | Dimitris Aragiorgis | |
100 | 77180645 | Dimitris Aragiorgis | |
101 | 77180645 | Dimitris Aragiorgis | .. toctree:: |
102 | 7a3439cf | Constantinos Venetsanopoulos | :maxdepth: 1 |
103 | 7a3439cf | Constantinos Venetsanopoulos | |
104 | 2ca07643 | Constantinos Venetsanopoulos | Quick Installation Guide (single node) <quick-install-guide> |
105 | ff6ba888 | Constantinos Venetsanopoulos | Installation Guide (on two nodes) <quick-install-admin-guide> |
106 | d0e436db | Constantinos Venetsanopoulos | |
107 | bc055d09 | Constantinos Venetsanopoulos | .. toctree:: |
108 | f936cac5 | Constantinos Venetsanopoulos | :maxdepth: 1 |
109 | bdb83fd6 | cven | |
110 | bc055d09 | Constantinos Venetsanopoulos | Administrator's Guide <admin-guide> |
111 | bc055d09 | Constantinos Venetsanopoulos | Developer's Guide <dev-guide> |
112 | d0e436db | Constantinos Venetsanopoulos | |
113 | d0e436db | Constantinos Venetsanopoulos | |
114 | f936cac5 | Constantinos Venetsanopoulos | Synnefo tools |
115 | f936cac5 | Constantinos Venetsanopoulos | ============= |
116 | 44c34efd | Constantinos Venetsanopoulos | |
117 | f936cac5 | Constantinos Venetsanopoulos | There are also the following tools: |
118 | f936cac5 | Constantinos Venetsanopoulos | |
119 | f936cac5 | Constantinos Venetsanopoulos | .. toctree:: |
120 | f936cac5 | Constantinos Venetsanopoulos | :maxdepth: 1 |
121 | 44c34efd | Constantinos Venetsanopoulos | |
122 | f936cac5 | Constantinos Venetsanopoulos | kamaki: Command-line client <http://www.synnefo.org/docs/kamaki/latest/index.html> |
123 | f936cac5 | Constantinos Venetsanopoulos | snf-deploy: Synnefo deployment tool <snf-deploy> |
124 | f936cac5 | Constantinos Venetsanopoulos | snf-image-creator: Image bundling/uploading/registering tool <http://www.synnefo.org/docs/snf-image-creator/latest/index.html> |
125 | f936cac5 | Constantinos Venetsanopoulos | snf-image: Secure image deployment tool <http://www.synnefo.org/docs/snf-image/latest/index.html> |
126 | f936cac5 | Constantinos Venetsanopoulos | snf-burnin: Integration testing tool for a running Synnefo deployment <snf-burnin> |
127 | 44c34efd | Constantinos Venetsanopoulos | |
128 | 44c34efd | Constantinos Venetsanopoulos | |
129 | 98ae2c12 | Constantinos Venetsanopoulos | Design |
130 | 98ae2c12 | Constantinos Venetsanopoulos | ====== |
131 | 98ae2c12 | Constantinos Venetsanopoulos | |
132 | 98ae2c12 | Constantinos Venetsanopoulos | Drafts |
133 | 98ae2c12 | Constantinos Venetsanopoulos | ------ |
134 | 98ae2c12 | Constantinos Venetsanopoulos | |
135 | 98ae2c12 | Constantinos Venetsanopoulos | .. toctree:: |
136 | 98ae2c12 | Constantinos Venetsanopoulos | :maxdepth: 1 |
137 | 98ae2c12 | Constantinos Venetsanopoulos | |
138 | f68199bd | Giorgos Korfiatis | Resource-pool projects design <design/resource-pool-projects> |
139 | 111adca0 | Giorgos Korfiatis | Resource defaults design <design/resource-defaults> |
140 | 5547485e | Sofia Papagiannaki | Pithos view authorization <design/pithos-view-authorization.rst> |
141 | 98ae2c12 | Constantinos Venetsanopoulos | |
142 | 98ae2c12 | Constantinos Venetsanopoulos | |
143 | d0e436db | Constantinos Venetsanopoulos | Contact |
144 | bc055d09 | Constantinos Venetsanopoulos | ======= |
145 | d0e436db | Constantinos Venetsanopoulos | |
146 | eab73849 | Constantinos Venetsanopoulos | You can contact the Synnefo team at the following mailing lists: |
147 | 9940eacf | Kostas Papadimitriou | |
148 | eab73849 | Constantinos Venetsanopoulos | * Users list: synnefo@googlegroups.com |
149 | eab73849 | Constantinos Venetsanopoulos | * Developers list: synnefo-devel@googlegroups.com |
150 | bc055d09 | Constantinos Venetsanopoulos | |
151 | 301294a9 | Constantinos Venetsanopoulos | The official site is: |
152 | 301294a9 | Constantinos Venetsanopoulos | |
153 | 301294a9 | Constantinos Venetsanopoulos | `http://www.synnefo.org <http://www.synnefo.org>`_ |