Browse Source

Retire repository

Fuel (from openstack namespace) and fuel-ccp (in x namespace)
repositories are unused and ready to retire.

This change removes all content from the repository and adds the usual
README file to point out that the repository is retired following the
process from
https://docs.openstack.org/infra/manual/drivers.html#retiring-a-project

See also
http://lists.openstack.org/pipermail/openstack-discuss/2019-December/011647.html

Depends-On: https://review.opendev.org/699362
Change-Id: Ice4cf064434d2d4bd4b089fc06e9aa8ad96d9a64
changes/12/699612/1
Andreas Jaeger 7 months ago
parent
commit
91aa182bec
100 changed files with 8 additions and 3836 deletions
  1. +0
    -64
      .gitignore
  2. +0
    -182
      CHANGELOG.md
  3. +0
    -17
      CONTRIBUTING.rst
  4. +0
    -4
      HACKING.rst
  5. +0
    -202
      LICENSE
  6. +0
    -37
      MAINTAINERS
  7. +8
    -96
      README.rst
  8. +0
    -202
      examples/fuel_plugin_example_v1/LICENSE
  9. +0
    -4
      examples/fuel_plugin_example_v1/README.md
  10. +0
    -23
      examples/fuel_plugin_example_v1/deployment_scripts/deploy.sh
  11. +0
    -48
      examples/fuel_plugin_example_v1/environment_config.yaml
  12. +0
    -26
      examples/fuel_plugin_example_v1/fuel-simple-service.py
  13. +0
    -56
      examples/fuel_plugin_example_v1/metadata.yaml
  14. +0
    -21
      examples/fuel_plugin_example_v1/pre_build_hook
  15. +0
    -0
      examples/fuel_plugin_example_v1/repositories/centos/.gitkeep
  16. +0
    -0
      examples/fuel_plugin_example_v1/repositories/ubuntu/.gitkeep
  17. +0
    -14
      examples/fuel_plugin_example_v1/tasks.yaml
  18. +0
    -3
      examples/fuel_plugin_example_v2/.gitignore
  19. +0
    -202
      examples/fuel_plugin_example_v2/LICENSE
  20. +0
    -4
      examples/fuel_plugin_example_v2/README.md
  21. +0
    -23
      examples/fuel_plugin_example_v2/deployment_scripts/deploy.sh
  22. +0
    -7
      examples/fuel_plugin_example_v2/environment_config.yaml
  23. +0
    -26
      examples/fuel_plugin_example_v2/fuel-simple-service.py
  24. +0
    -54
      examples/fuel_plugin_example_v2/metadata.yaml
  25. +0
    -21
      examples/fuel_plugin_example_v2/pre_build_hook
  26. +0
    -0
      examples/fuel_plugin_example_v2/repositories/centos/.gitkeep
  27. +0
    -0
      examples/fuel_plugin_example_v2/repositories/ubuntu/.gitkeep
  28. +0
    -20
      examples/fuel_plugin_example_v2/tasks.yaml
  29. +0
    -3
      examples/fuel_plugin_example_v2_update/.gitignore
  30. +0
    -202
      examples/fuel_plugin_example_v2_update/LICENSE
  31. +0
    -4
      examples/fuel_plugin_example_v2_update/README.md
  32. +0
    -23
      examples/fuel_plugin_example_v2_update/deployment_scripts/deploy.sh
  33. +0
    -7
      examples/fuel_plugin_example_v2_update/environment_config.yaml
  34. +0
    -26
      examples/fuel_plugin_example_v2_update/fuel-simple-service.py
  35. +0
    -54
      examples/fuel_plugin_example_v2_update/metadata.yaml
  36. +0
    -21
      examples/fuel_plugin_example_v2_update/pre_build_hook
  37. +0
    -0
      examples/fuel_plugin_example_v2_update/repositories/centos/.gitkeep
  38. +0
    -0
      examples/fuel_plugin_example_v2_update/repositories/ubuntu/.gitkeep
  39. +0
    -34
      examples/fuel_plugin_example_v2_update/tasks.yaml
  40. +0
    -3
      examples/fuel_plugin_example_v3/.gitignore
  41. +0
    -202
      examples/fuel_plugin_example_v3/LICENSE
  42. +0
    -4
      examples/fuel_plugin_example_v3/README.md
  43. +0
    -12
      examples/fuel_plugin_example_v3/deployment_scripts/deploy.pp
  44. +0
    -23
      examples/fuel_plugin_example_v3/deployment_scripts/deploy.sh
  45. +0
    -86
      examples/fuel_plugin_example_v3/deployment_tasks.yaml
  46. +0
    -7
      examples/fuel_plugin_example_v3/environment_config.yaml
  47. +0
    -26
      examples/fuel_plugin_example_v3/fuel-simple-service.py
  48. +0
    -46
      examples/fuel_plugin_example_v3/metadata.yaml
  49. +0
    -21
      examples/fuel_plugin_example_v3/network_roles.yaml
  50. +0
    -6
      examples/fuel_plugin_example_v3/node_roles.yaml
  51. +0
    -21
      examples/fuel_plugin_example_v3/pre_build_hook
  52. +0
    -0
      examples/fuel_plugin_example_v3/repositories/centos/.gitkeep
  53. +0
    -0
      examples/fuel_plugin_example_v3/repositories/ubuntu/.gitkeep
  54. +0
    -7
      examples/fuel_plugin_example_v3/tasks.yaml
  55. +0
    -6
      examples/fuel_plugin_example_v3/volumes.yaml
  56. +0
    -202
      examples/fuel_plugin_example_v4/LICENSE
  57. +0
    -4
      examples/fuel_plugin_example_v4/README.md
  58. +0
    -17
      examples/fuel_plugin_example_v4/components.yaml
  59. +0
    -14
      examples/fuel_plugin_example_v4/deployment_scripts/deploy.pp
  60. +0
    -23
      examples/fuel_plugin_example_v4/deployment_scripts/deploy.sh
  61. +0
    -46
      examples/fuel_plugin_example_v4/deployment_tasks.yaml
  62. +0
    -15
      examples/fuel_plugin_example_v4/environment_config.yaml
  63. +0
    -26
      examples/fuel_plugin_example_v4/fuel-simple-service.py
  64. +0
    -45
      examples/fuel_plugin_example_v4/metadata.yaml
  65. +0
    -24
      examples/fuel_plugin_example_v4/network_roles.yaml
  66. +0
    -6
      examples/fuel_plugin_example_v4/node_roles.yaml
  67. +0
    -21
      examples/fuel_plugin_example_v4/pre_build_hook
  68. +0
    -0
      examples/fuel_plugin_example_v4/repositories/centos/.gitkeep
  69. +0
    -0
      examples/fuel_plugin_example_v4/repositories/ubuntu/.gitkeep
  70. +0
    -5
      examples/fuel_plugin_example_v4/tasks.yaml
  71. +0
    -6
      examples/fuel_plugin_example_v4/volumes.yaml
  72. +0
    -202
      examples/fuel_plugin_example_v5/LICENSE
  73. +0
    -4
      examples/fuel_plugin_example_v5/README.md
  74. +0
    -18
      examples/fuel_plugin_example_v5/bond_config.yaml
  75. +0
    -17
      examples/fuel_plugin_example_v5/components.yaml
  76. +0
    -14
      examples/fuel_plugin_example_v5/deployment_scripts/deploy.pp
  77. +0
    -23
      examples/fuel_plugin_example_v5/deployment_scripts/deploy.sh
  78. +0
    -46
      examples/fuel_plugin_example_v5/deployment_tasks.yaml
  79. +0
    -15
      examples/fuel_plugin_example_v5/environment_config.yaml
  80. +0
    -26
      examples/fuel_plugin_example_v5/fuel-simple-service.py
  81. +0
    -40
      examples/fuel_plugin_example_v5/metadata.yaml
  82. +0
    -24
      examples/fuel_plugin_example_v5/network_roles.yaml
  83. +0
    -18
      examples/fuel_plugin_example_v5/nic_config.yaml
  84. +0
    -25
      examples/fuel_plugin_example_v5/node_config.yaml
  85. +0
    -6
      examples/fuel_plugin_example_v5/node_roles.yaml
  86. +0
    -21
      examples/fuel_plugin_example_v5/pre_build_hook
  87. +0
    -0
      examples/fuel_plugin_example_v5/repositories/centos/.gitkeep
  88. +0
    -0
      examples/fuel_plugin_example_v5/repositories/ubuntu/.gitkeep
  89. +0
    -6
      examples/fuel_plugin_example_v5/volumes.yaml
  90. +0
    -0
      fuel_plugin_builder/__init__.py
  91. +0
    -23
      fuel_plugin_builder/actions/__init__.py
  92. +0
    -32
      fuel_plugin_builder/actions/base.py
  93. +0
    -276
      fuel_plugin_builder/actions/build.py
  94. +0
    -65
      fuel_plugin_builder/actions/create.py
  95. +0
    -128
      fuel_plugin_builder/cli.py
  96. +0
    -18
      fuel_plugin_builder/consts.py
  97. +0
    -63
      fuel_plugin_builder/errors.py
  98. +0
    -36
      fuel_plugin_builder/logger.py
  99. +0
    -33
      fuel_plugin_builder/messages.py
  100. +0
    -3
      fuel_plugin_builder/templates/base/.gitignore

+ 0
- 64
.gitignore View File

@@ -1,64 +0,0 @@
# Fuel Plugins
fpb_venv
*.rpm
*.deb
built_plugins/
.build/
*.fp

*.py[cod]

# C extensions
*.so

# Packages
*.egg*
*.egg-info
dist
build
eggs
parts
bin
var
sdist
develop-eggs
.installed.cfg
lib
lib64

# Installer logs
pip-log.txt

# Unit test / coverage reports
cover/
.coverage*
!.coveragerc
.tox
nosetests.xml
.testrepository
.venv

# Translations
*.mo

# Mr Developer
.mr.developer.cfg
.project
.pydevproject

# Complexity
output/*.html
output/*/index.html

# Sphinx
doc/build

# pbr generates these
AUTHORS
ChangeLog

# Editors
*~
.*.swp
.*sw?
.idea

+ 0
- 182
CHANGELOG.md View File

@@ -1,182 +0,0 @@
# Changelog

## 4.2.0 (2017-01-02)

New package version "4.2.0" includes the following features:

- Added new plugin version with node & nic attributes support

Bugfixes:

- Move Release.mako into v1 template dir
[LP1655289](https://bugs.launchpad.net/fuel/+bug/1655289)
- Make ubuntu repo similar for all plugin versions
[LP1650551](https://bugs.launchpad.net/fuel/+bug/1650551)
- Show team and repo badges on `README`
- Remove reboot task from plugin example version "3.0.0"
[LP1625244](https://bugs.launchpad.net/fuel/+bug/1625244)
- Files with no code must be left completely empty
- Legacy deployment tasks are turned back for plugin example version "3.0.0"
[LP1625244](https://bugs.launchpad.net/fuel/+bug/1625244)
- `tasks.yaml` was commented for plugin example version "3.0.0"
[LP1625244](https://bugs.launchpad.net/fuel/+bug/1625244)
- Allow unauthenticated packages in the deployment scripts
[LP1622506](https://bugs.launchpad.net/fuel/+bug/1622506)
- Allow arrays in 'value' in environment_config.yaml
[LP1616466](https://bugs.launchpad.net/fuel/+bug/1616466)
- Old `tasks.yaml` content is commented for plugins packages version "4.0.0"
[LP1619255](https://bugs.launchpad.net/fuel/+bug/1619255)
- Allow possibility to provide rpm `Release` version
[LP1616929](https://bugs.launchpad.net/fuel/+bug/1616929)
- Rename existing BaseValidator to LegacyBaseValidator
[LP1534126](https://bugs.launchpad.net/fuel/+bug/1534126)
- Fix a word spell error in `README.rst`
- Support multi versions of package in fuel plugin
[LP1599896](https://bugs.launchpad.net/fuel/+bug/1599896)

## 4.1.0 (2016-06-29)

Bugfixes:

- `tasks.yaml` is now optional for package version "4.0.0"
[LP1552248](https://bugs.launchpad.net/fuel/+bug/1552248)
- Fuel Mitaka (9.0) is supported by default in package version "4.0.0"
[LP1549276](https://bugs.launchpad.net/fuel/+bug/1549276)
- Use more reliable way to check for `fpm` Ruby GEM
[LP1561069](https://bugs.launchpad.net/fuel/+bug/1561069)
- Add ability for role to conflict with all roles by using `*` sign
[LP1547590](https://bugs.launchpad.net/fuel/+bug/1547590)
- Do not execute `uninstall.sh` on plugin upgrade
[LP1564123](https://bugs.launchpad.net/fuel/+bug/1564123)
- Add possiblity to use generators in `environment_config.yaml`
[LP1557562](https://bugs.launchpad.net/fuel/+bug/1557562)
- Don't put any code to PREUN section if `uninstall.sh` doesn't exist or empty
[LP1574478](https://bugs.launchpad.net/fuel/+bug/1574478)
- Allow a user to specify any arbitrary string as role name for cross-deps
[LP1557997](https://bugs.launchpad.net/fuel/+bug/1557997)
- Add deployment tasks v2.1 validation support
[LP1590389](https://bugs.launchpad.net/fuel/+bug/1590389)

## 4.0.0 (2016-02-26)

New package version "4.0.0" includes the following features:

- New flag `is_hotpluggable` in `metadata.yaml` that allows to install and use
plugin on previously deployed environments.
- Plugin can specify settings group using "group" field in metadata in
environment_config.yaml file.
- New group `equipment` added to groups list in `metadata.yaml`.
- New `components.yaml` file that allows to declare new components.

Bugfixes:

- Fix of missing strategy parameter in V3 and V4 deployment tasks
[LP1522785](https://bugs.launchpad.net/fuel/+bug/1522785)

## 3.0.0 (2014-09-16)

New package version "3.0.0" includes the following features:

- New `node_roles.yaml` file that allows to add new node roles.
- New `volumes.yaml` file that allows to add new volumes and/or define
"node roles <-> volumes" mapping.
- New `deployment_tasks.yaml` file that allows to declare pre/post- and
regular deployment tasks for any node role. Unlike `tasks.yaml`, the
tasks go through global deployment graph and that provides ability
to execute task at any place during deployment, or overwrite/skip
already existing ones.
- New `network_roles.yaml` file that allows to add new network roles
and reserve some VIPs, to be proceed by plugin.

Bugfixes:

- Fix executing of `deploy.sh` deployment script
[LP1463441](https://bugs.launchpad.net/fuel/+bug/1463441)
- Remove "Origin" field from Ubuntu's `Release` file in order to reduce
probability of broken apt pinning
[LP1475665](https://bugs.launchpad.net/fuel/+bug/1475665)

## 2.0.4 (2014-06-23)

- Fix, remove plugin package from previous build
https://bugs.launchpad.net/fuel/+bug/1464143

## 2.0.3 (2014-06-08)

- New "monitoring" group
https://bugs.launchpad.net/fuel/+bug/1458592
- Fix, fail build, if there are invalid deb packages for ubuntu repository
https://bugs.launchpad.net/fuel/+bug/1447981
- Fix dependency package name for newer CentOS
https://bugs.launchpad.net/fuel/+bug/1455882

## 2.0.2 (2014-05-15)

- Reverted fix for https://bugs.launchpad.net/fuel/+bug/1447981
because it caused creation of broken ubuntu repository
https://bugs.launchpad.net/fuel-plugins/+bug/1455130

## 2.0.1 (2014-05-08)

- Fix, fail build, if there are invalid deb packages for ubuntu repository
https://bugs.launchpad.net/fuel/+bug/1447981
- Fix validation for UI restrictions
https://bugs.launchpad.net/fuel/+bug/1448147
- Fix packages duplication after plugin build
https://bugs.launchpad.net/fuel/+bug/1451751
- Fix plugin name validation
https://bugs.launchpad.net/fuel/+bug/1439760

## 2.0.0 (2014-04-30)

- New package version "2.0.0", which is generated by default
- For plugins with 2.0.0 package version, fpb builds rpm packages
instead of *.fp archives. It was required for plugins updates
https://github.com/stackforge/fuel-specs/blob/master/specs/6.1/plugins-security-fixes.rst
- New "reboot" task for 2.0.0 plugins, which can reboot the node
and wait until reboot process is finished, see more details in the specification
https://github.com/stackforge/fuel-specs/blob/master/specs/6.1/reboot-task-type-for-plugin-developers.rst
- New required field groups, now you can specify a list of groups
which your plugin implements, see more details in the specification
https://github.com/stackforge/fuel-specs/blob/master/specs/6.1/plugin-groups.rst
- New required field authors (for plugins with 2.0.0 package version)
- New required field licenses (for plugins with 2.0.0 package version)
- New required field homepage (for plugins with 2.0.0 package version)
- New parameter "--package-version", to generate the plugins in old
format (e.g. package version 1.0.0)
- Fixed, plugins with package version 2.0.0, generate Release file
for Ubuntu repositories
https://bugs.launchpad.net/fuel/+bug/1435892
- New format of stages for plugins with package version 2.0.0,
added numerical postfixes
https://github.com/stackforge/fuel-specs/blob/master/specs/6.1/plugins-deployment-order.rst

## 1.0.2 (2014-12-19)

- Show correct message, if 'timeout' field is not specified for
task in tasks.yaml
https://bugs.launchpad.net/fuel/+bug/1396234
- Print error messages to stderr instead of stdout
- Fixed validation for environment_config.yaml file, "attributes"
field is optional
https://bugs.launchpad.net/fuel/+bug/1396491
- Improved validation for environment_config.yaml file, added
required fields for attributes
- Generate file with SHA1 checksums for each file in the plugin
https://bugs.launchpad.net/fuel/+bug/1403960

## 1.0.1 (2014-11-20)

- Show instruction for CentOS if not all requirements are installed
- Fixed bug, deploy.sh doesn't have execution permission
https://bugs.launchpad.net/fuel/+bug/1392736
- Fixed bug, don't fail validation if environment_config.yaml file has checkbox
https://bugs.launchpad.net/fuel/+bug/1392807

## 1.0.0 (2014-11-13)

Initial public release

- Plugin create
- Plugin build
- Plugin check

+ 0
- 17
CONTRIBUTING.rst View File

@@ -1,17 +0,0 @@
If you would like to contribute to the development of OpenStack, you must
follow the steps in this page:

http://docs.openstack.org/infra/manual/developers.html

If you already have a good understanding of how the system works and your
OpenStack accounts are set up, you can skip to the development workflow
section of this documentation to learn how changes to OpenStack should be
submitted for review via the Gerrit tool:

http://docs.openstack.org/infra/manual/developers.html#development-workflow

Pull requests submitted through GitHub will be ignored.

Bugs should be filed on Launchpad, not GitHub:

https://bugs.launchpad.net/fuel

+ 0
- 4
HACKING.rst View File

@@ -1,4 +0,0 @@
Fuel Plugins Style Commandments
===============================

Read the OpenStack Style Commandments http://docs.openstack.org/developer/hacking/

+ 0
- 202
LICENSE View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "{}"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright {yyyy} {name of copyright owner}

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


+ 0
- 37
MAINTAINERS View File

@@ -1,37 +0,0 @@
---
description:
For Fuel team structure and contribution policy, see [1].

This is repository level MAINTAINERS file. All contributions to this
repository must be approved by one or more Core Reviewers [2].
If you are contributing to files (or create new directories) in
root folder of this repository, please contact Core Reviewers for
review and merge requests.

If you are contributing to subfolders of this repository, please
check 'maintainers' section of this file in order to find maintainers
for those specific modules.

It is mandatory to get +1 from one or more maintainers before asking
Core Reviewers for review/merge in order to decrease a load on Core Reviewers [3].
Exceptions are when maintainers are actually cores, or when maintainers
are not available for some reason (e.g. on vacation).

[1] http://specs.fuel-infra.org/fuel-specs-master/policy/team-structure.html
[2] https://review.openstack.org/#/admin/groups/661,members
[3] http://lists.openstack.org/pipermail/openstack-dev/2015-August/072406.html

Please keep this file in YAML format in order to allow helper scripts
to read this as a configuration data.

maintainers:

- ./:

- name: Andrii Popovych
email: apopovych@mirantis.com
IRC: apopovych

- name: Ilya Kutukov
email: ikutukov@mirantis.com
IRC: ikutukov

+ 8
- 96
README.rst View File

@@ -1,98 +1,10 @@
========================
Team and repository tags
========================
This project is no longer maintained.

.. image:: http://governance.openstack.org/badges/fuel-plugins.svg
:target: http://governance.openstack.org/reference/tags/index.html
The contents of this repository are still available in the Git
source code management system. To see the contents of this
repository before it reached its end of life, please check out the
previous commit with "git checkout HEAD^1".

.. Change things from this point on

Fuel Plugins
============

Starting with version 6.0, Fuel supports a Pluggable architecture.

Fuel plugins allow you to install and configure additional capabilities for
your cloud, such as additional storage types and networking functionality.
For example, a Load Balancing as a Service (LBaaS) plugin allows you to add
network load balancing functionality to your cloud so that incoming traffic
can be spread across multiple nodes. Or you might want to use a GlusterFS
plugin so that you can use a Gluster file system as backend for Cinder
volumes.


Finding Plugins
---------------

For production versions of plugins, including certified plugins, see
`Released Plugins Catalog`_.

For instructions on installing Fuel plugins, see `Installing Plugins`_.


Finding documentation
---------------------

You can find Fuel Plugins documentation in the following sources:

* Development issues - `Plugins Wiki`_ page.
* Common installation instructions - `Install Fuel Plugins`_ and
`CLI command reference`_ sections in the User Guide.
* Specific installation instructions - `Fuel Plugins Catalog`_.


OpenStack Fuel-plugins Repository
---------------------------------

This repository contains plugin example, and the Fuel plugin builder tool
(fpb). The plugin code here might not be suitable for production use please
see `Released Plugins Catalog`_ to download release versions of these and
other Fuel plugins.


Creating your own plugins
-------------------------

Detailed instructions can be found in the `Plugins Wiki`_ page.

Plugins should be built using the ``fuel-plugin-builder`` (fpb) utility
found in this repoistory or via ``pip``. ``fpb`` will ensure that build
steps as well as validation is performed prior to assembling a package.

Abbreviated instructions:

.. code:: bash

pip install fuel-plugin-builder
fpb --create fuel_plugin_name
fpb --build <path to plugin>

This will:

* install fuel-plugin-builder
* clone the fuel_plugin_example plugin with the name fuel_plugin_name
* build the plugin ``.rpm`` package.

Examples
````````

Simple Fuel plugin examples you can find here:

https://github.com/openstack/fuel-plugins/tree/master/examples

Other Plugin repositories
`````````````````````````

Other locations known to have Fuel plugins. *Note, these may not be supported
by the Fuel team*

* `Community Plugins`_


.. _Released Plugins Catalog: https://www.fuel-infra.org/plugins/catalog.html
.. _Installing Plugins: https://wiki.openstack.org/wiki/Fuel/Plugins#Installation_procedure
.. _Plugins Wiki: http://wiki.openstack.org/Fuel/Plugins
.. _Install Fuel Plugins: http://docs.mirantis.com/openstack/fuel/fuel-master/user-guide.html#install-fuel-plugins
.. _CLI command reference: http://docs.mirantis.com/openstack/fuel/fuel-master/user-guide.html#fuel-plugins-cli
.. _Fuel Plugins Catalog: https://software.mirantis.com/download-mirantis-openstack-fuel-plug-ins/
.. _Community Plugins: https://github.com/openstack/?query=fuel-plugin
For any further questions, please email
openstack-discuss@lists.openstack.org or join #openstack-dev on
Freenode.

+ 0
- 202
examples/fuel_plugin_example_v1/LICENSE View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "{}"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright {yyyy} {name of copyright owner}

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


+ 0
- 4
examples/fuel_plugin_example_v1/README.md View File

@@ -1,4 +0,0 @@
fuel_plugin_example
============

Plugin description

+ 0
- 23
examples/fuel_plugin_example_v1/deployment_scripts/deploy.sh View File

@@ -1,23 +0,0 @@
#!/bin/bash
set -eux

# It's a script which deploys your plugin
echo fuel_plugin_example > /tmp/fuel_plugin_example

OS_NAME=''
if grep -i CentOS /etc/issue.net >/dev/null; then
OS_NAME='centos';
elif grep -i Ubuntu /etc/issue.net >/dev/null; then
OS_NAME='ubuntu';
fi

function install_package {
if [ $OS_NAME == 'ubuntu' ]; then
apt-get install -y --force-yes -o 'APT::Get::AllowUnauthenticated=1' fuel-simple-service
elif [ $OS_NAME == 'centos' ]; then
yum install -y fuel-simple-service
fi
}

install_package
fuel-simple-service.py &

+ 0
- 48
examples/fuel_plugin_example_v1/environment_config.yaml View File

@@ -1,48 +0,0 @@
attributes:

fuel_plugin_example_text:
type: "text"
weight: 10
value: "Default text"
label: "Text field label"
description: "Field description"
regex:
source: '\S'
error: "Error field cannot be empty"

fuel_plugin_example_select:
type: "select"
weight: 20
value: "value2"
label: "Select label"
description: "Select description"
values:
- data: "value1"
label: "Value 1 label"
- data: "value2"
label: "Value 2 label"
- data: "value3"
label: "Value 3 label"

fuel_plugin_example_checkbox:
type: "checkbox"
weight: 30
value: false
label: "Checkbox label"
description: "Checkbox description"

fuel_plugin_example_radio:
type: "radio"
weight: 40
value: "disabled"
label: "Radio buttons label"
values:
- data: "data1"
label: "Label data1"
description: "Description data1"
- data: "data2"
label: "Label data2"
description: "Description data2"
- data: "data3"
label: "Label data3"
description: "Description data3"

+ 0
- 26
examples/fuel_plugin_example_v1/fuel-simple-service.py View File

@@ -1,26 +0,0 @@
#!/usr/bin/env python
# -*- encoding: utf-8 -*-

from wsgiref.simple_server import make_server

def web_app(environ, start_response):
status = '200 OK'
headers = [('Content-type', 'text/plain')]

start_response(status, headers)

return open('/etc/astute.yaml').read()


def start_server(host, port):
httpd = make_server(host, port, web_app)
print 'Started server 8234'
httpd.serve_forever()


def main():
start_server('', 8234)


if __name__ == '__main__':
main()

+ 0
- 56
examples/fuel_plugin_example_v1/metadata.yaml View File

@@ -1,56 +0,0 @@
# Plugin name
name: fuel_plugin_example
title: Fuel plugin example
# Plugin version
version: '1.0.0'
# Description
description: Plugin example which installs simple service on controllers
# Minimum required fuel version
fuel_version: ['6.0']

# The plugin is compatible with releases in the list
releases:
- os: ubuntu
version: 2014.2-6.0
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: centos
version: 2014.2-6.0
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/centos
- os: ubuntu
version: 2014.2-6.1
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: centos
version: 2014.2-6.1
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/centos
- os: ubuntu
version: 2015.1.0-7.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: liberty-8.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: mitaka-9.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: newton-10.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu


# Version of plugin package
package_version: '1.0.0'

+ 0
- 21
examples/fuel_plugin_example_v1/pre_build_hook View File

@@ -1,21 +0,0 @@
#!/bin/bash
set -eux

command -v fpm >/dev/null 2>&1 || {
echo >&2 "Install 'fpm' to build this plugin. Aborting."; exit 1;
}

ruby -e "require 'fpm'" 2>&1 || {
echo >&2 "'Fpm' binary file is present, but gem seems to be broken! Aborting."; exit 1;
}

ROOT=$(dirname `readlink -f $0`)

UBUNTU_REPO_PATH=$ROOT/repositories/ubuntu
CENTOS_REPO_PATH=$ROOT/repositories/centos

rm -f $UBUNTU_REPO_PATH/*.deb
rm -f $CENTOS_REPO_PATH/*.rpm

fpm -t deb -p $UBUNTU_REPO_PATH -n fuel-simple-service -v 1.0.0 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py
fpm -t rpm -p $CENTOS_REPO_PATH -n fuel-simple-service -v 1.0.0 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py

+ 0
- 0
examples/fuel_plugin_example_v1/repositories/centos/.gitkeep View File


+ 0
- 0
examples/fuel_plugin_example_v1/repositories/ubuntu/.gitkeep View File


+ 0
- 14
examples/fuel_plugin_example_v1/tasks.yaml View File

@@ -1,14 +0,0 @@
# This tasks will be applied on controller nodes
- role: ['controller']
stage: post_deployment
type: shell
parameters:
cmd: bash deploy.sh
timeout: 42
# Task is applied for all roles
- role: '*'
stage: pre_deployment
type: shell
parameters:
cmd: echo all > /tmp/plugin.all
timeout: 42

+ 0
- 3
examples/fuel_plugin_example_v2/.gitignore View File

@@ -1,3 +0,0 @@
.tox
.build
*.pyc

+ 0
- 202
examples/fuel_plugin_example_v2/LICENSE View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "{}"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright {yyyy} {name of copyright owner}

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


+ 0
- 4
examples/fuel_plugin_example_v2/README.md View File

@@ -1,4 +0,0 @@
fuel_plugin_example
===================

Plugin description

+ 0
- 23
examples/fuel_plugin_example_v2/deployment_scripts/deploy.sh View File

@@ -1,23 +0,0 @@
#!/bin/bash
set -eux

# It's a script which deploys your plugin
echo fuel_plugin_example > /tmp/fuel_plugin_example

OS_NAME=''
if grep -i CentOS /etc/issue.net >/dev/null; then
OS_NAME='centos';
elif grep -i Ubuntu /etc/issue.net >/dev/null; then
OS_NAME='ubuntu';
fi

function install_package {
if [ $OS_NAME == 'ubuntu' ]; then
apt-get install -y --force-yes -o 'APT::Get::AllowUnauthenticated=1' fuel-simple-service
elif [ $OS_NAME == 'centos' ]; then
yum install -y fuel-simple-service
fi
}

install_package
fuel-simple-service.py &

+ 0
- 7
examples/fuel_plugin_example_v2/environment_config.yaml View File

@@ -1,7 +0,0 @@
attributes:
fuel_plugin_example:
value: 'Set default value'
label: 'Text field'
description: 'Description for text field'
weight: 25
type: "text"

+ 0
- 26
examples/fuel_plugin_example_v2/fuel-simple-service.py View File

@@ -1,26 +0,0 @@
#!/usr/bin/env python
# -*- encoding: utf-8 -*-

from wsgiref.simple_server import make_server

def web_app(environ, start_response):
status = '200 OK'
headers = [('Content-type', 'text/plain')]

start_response(status, headers)

return open('/etc/astute.yaml').read()


def start_server(host, port):
httpd = make_server(host, port, web_app)
print 'Started server 8234'
httpd.serve_forever()


def main():
start_server('', 8234)


if __name__ == '__main__':
main()

+ 0
- 54
examples/fuel_plugin_example_v2/metadata.yaml View File

@@ -1,54 +0,0 @@
# Plugin name
name: fuel_plugin_example
# Human-readable name for your plugin
title: Title for fuel_plugin_example plugin
# Plugin version
version: '2.0.0'
# Description
description: Please describe your plugin here
# Minimum required fuel version
fuel_version: ['6.1']
# Specify license of your plugin
licenses: ['Apache License Version 2.0']
# Specify author or company name
authors: ['Specify author or company name']
# A link to the plugin's page
homepage: 'https://github.com/stackforge/fuel-plugins'
groups: []

# The plugin is compatible with releases in the list
releases:
- os: ubuntu
version: 2014.2-6.1
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: centos
version: 2014.2-6.1
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/centos
- os: ubuntu
version: 2015.1.0-7.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: liberty-8.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: mitaka-9.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: newton-10.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu


# Version of plugin package
package_version: '2.0.0'

+ 0
- 21
examples/fuel_plugin_example_v2/pre_build_hook View File

@@ -1,21 +0,0 @@
#!/bin/bash
set -eux

command -v fpm >/dev/null 2>&1 || {
echo >&2 "Install 'fpm' to build this plugin. Aborting."; exit 1;
}

ruby -e "require 'fpm'" 2>&1 || {
echo >&2 "'Fpm' binary file is present, but gem seems to be broken! Aborting."; exit 1;
}

ROOT=$(dirname `readlink -f $0`)

UBUNTU_REPO_PATH=$ROOT/repositories/ubuntu
CENTOS_REPO_PATH=$ROOT/repositories/centos

rm -f $UBUNTU_REPO_PATH/*.deb
rm -f $CENTOS_REPO_PATH/*.rpm

fpm -t deb -p $UBUNTU_REPO_PATH -n fuel-simple-service -v 2.0.0 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py
fpm -t rpm -p $CENTOS_REPO_PATH -n fuel-simple-service -v 2.0.0 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py

+ 0
- 0
examples/fuel_plugin_example_v2/repositories/centos/.gitkeep View File


+ 0
- 0
examples/fuel_plugin_example_v2/repositories/ubuntu/.gitkeep View File


+ 0
- 20
examples/fuel_plugin_example_v2/tasks.yaml View File

@@ -1,20 +0,0 @@
# This tasks will be applied on controller nodes
- role: ['primary-controller', 'controller']
stage: post_deployment
type: shell
parameters:
cmd: bash deploy.sh
timeout: 42
# Task is applied for all roles
- role: '*'
stage: pre_deployment
type: shell
parameters:
cmd: echo all > /tmp/plugin.all
timeout: 42
# "reboot" task reboots the nodes and waits until they get back online
# - role: '*'
# stage: pre_deployment
# type: reboot
# parameters:
# timeout: 600

+ 0
- 3
examples/fuel_plugin_example_v2_update/.gitignore View File

@@ -1,3 +0,0 @@
.tox
.build
*.pyc

+ 0
- 202
examples/fuel_plugin_example_v2_update/LICENSE View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.

5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.

6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.

7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.

8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.

9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.

END OF TERMS AND CONDITIONS

APPENDIX: How to apply the Apache License to your work.

To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "{}"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.

Copyright {yyyy} {name of copyright owner}

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.


+ 0
- 4
examples/fuel_plugin_example_v2_update/README.md View File

@@ -1,4 +0,0 @@
fuel_plugin_example
===================

Plugin description

+ 0
- 23
examples/fuel_plugin_example_v2_update/deployment_scripts/deploy.sh View File

@@ -1,23 +0,0 @@
#!/bin/bash
set -eux

# It's a script which deploys your plugin
echo fuel_plugin_example > /tmp/fuel_plugin_example

OS_NAME=''
if grep -i CentOS /etc/issue.net >/dev/null; then
OS_NAME='centos';
elif grep -i Ubuntu /etc/issue.net >/dev/null; then
OS_NAME='ubuntu';
fi

function install_package {
if [ $OS_NAME == 'ubuntu' ]; then
apt-get install -y --force-yes -o 'APT::Get::AllowUnauthenticated=1' fuel-simple-service
elif [ $OS_NAME == 'centos' ]; then
yum install -y fuel-simple-service
fi
}

install_package
fuel-simple-service.py &

+ 0
- 7
examples/fuel_plugin_example_v2_update/environment_config.yaml View File

@@ -1,7 +0,0 @@
attributes:
fuel_plugin_example:
value: 'Set default value'
label: 'Text field'
description: 'Description for text field'
weight: 25
type: "text"

+ 0
- 26
examples/fuel_plugin_example_v2_update/fuel-simple-service.py View File

@@ -1,26 +0,0 @@
#!/usr/bin/env python
# -*- encoding: utf-8 -*-

from wsgiref.simple_server import make_server

def web_app(environ, start_response):
status = '200 OK'
headers = [('Content-type', 'text/plain')]

start_response(status, headers)

return open('/etc/astute.yaml').read()


def start_server(host, port):
httpd = make_server(host, port, web_app)
print 'Started server 8234'
httpd.serve_forever()


def main():
start_server('', 8234)


if __name__ == '__main__':
main()

+ 0
- 54
examples/fuel_plugin_example_v2_update/metadata.yaml View File

@@ -1,54 +0,0 @@
# Plugin name
name: fuel_plugin_example
# Human-readable name for your plugin
title: Title for fuel_plugin_example plugin
# Plugin version
version: '2.0.2'
# Description
description: Please describe your plugin here
# Minimum required fuel version
fuel_version: ['6.1']
# Specify license of your plugin
licenses: ['Apache License Version 2.0']
# Specify author or company name
authors: ['Specify author or company name']
# A link to the plugin's page
homepage: 'https://github.com/stackforge/fuel-plugins'
groups: []

# The plugin is compatible with releases in the list
releases:
- os: ubuntu
version: 2014.2-6.1
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: centos
version: 2014.2-6.1
mode: ['ha', 'multinode']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/centos
- os: ubuntu
version: 2015.1.0-7.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: liberty-8.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: mitaka-9.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu
- os: ubuntu
version: newton-10.0
mode: ['ha']
deployment_scripts_path: deployment_scripts/
repository_path: repositories/ubuntu


# Version of plugin package
package_version: '2.0.0'

+ 0
- 21
examples/fuel_plugin_example_v2_update/pre_build_hook View File

@@ -1,21 +0,0 @@
#!/bin/bash
set -eux

command -v fpm >/dev/null 2>&1 || {
echo >&2 "Install 'fpm' to build this plugin. Aborting."; exit 1;
}

ruby -e "require 'fpm'" 2>&1 || {
echo >&2 "'Fpm' binary file is present, but gem seems to be broken! Aborting."; exit 1;
}

ROOT=$(dirname `readlink -f $0`)

UBUNTU_REPO_PATH=$ROOT/repositories/ubuntu
CENTOS_REPO_PATH=$ROOT/repositories/centos

rm -f $UBUNTU_REPO_PATH/*.deb
rm -f $CENTOS_REPO_PATH/*.rpm

fpm -t deb -p $UBUNTU_REPO_PATH -n fuel-simple-service -v 2.0.2 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py
fpm -t rpm -p $CENTOS_REPO_PATH -n fuel-simple-service -v 2.0.2 -s dir $ROOT/fuel-simple-service.py=/usr/bin/fuel-simple-service.py

+ 0
- 0
examples/fuel_plugin_example_v2_update/repositories/centos/.gitkeep View File


+ 0
- 0
examples/fuel_plugin_example_v2_update/repositories/ubuntu/.gitkeep View File


+ 0
- 34
examples/fuel_plugin_example_v2_update/tasks.yaml View File

@@ -1,34 +0,0 @@
# This tasks will be applied on controller nodes
- role: ['primary-controller', 'controller']
stage: post_deployment
type: shell
parameters:
cmd: bash deploy.sh
timeout: 42

- role: '*'
stage: pre_deployment/100
type: shell
parameters:
cmd: echo all > /tmp/plugin+100.all
timeout: 42

- role: '*'
stage: pre_deployment/+101.0
type: shell
parameters:
cmd: echo all > /tmp/plugin+100.0.all
timeout: 42

- role: '*'
stage: pre_deployment/-100
type: shell
parameters:
cmd: echo all > /tmp/plugin-100.all
timeout: 42

- role: '*'
stage: pre_deployment
type: reboot
parameters:
timeout: 600

+ 0
- 3
examples/fuel_plugin_example_v3/.gitignore View File

@@ -1,3 +0,0 @@
.tox
.build
*.pyc

+ 0
- 202
examples/fuel_plugin_example_v3/LICENSE View File

@@ -1,202 +0,0 @@
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/

TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

1. Definitions.

"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.

"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.

"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.

"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.

"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.

"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.

"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).

"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.

"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."

"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.

2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.

3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.

4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:

(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and

(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and

(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and

(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.

You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with