6cd887423d
New header 'expires -1' forbids caching of / (index.html) to avoid caching issues which may exist after master node upgrade. This header is not needed for /static - for JS and other assets Fuel UI uses its own cachebusting mechanism. Change-Id: Ic9a199394a0167a4da977b5d135caf676e7d2b67 Closes-Bug: #1475310 |
||
|---|---|---|
| debian | ||
| deployment | ||
| files | ||
| logs | ||
| specs | ||
| tests | ||
| utils | ||
| .gitignore | ||
| .gitreview | ||
| CHANGELOG | ||
| Gemfile | ||
| LICENSE | ||
| MAINTAINERS | ||
| README.md | ||
| Rakefile | ||
README.md
fuel-library
Table of Contents
- Overview - What is the fuel-library?
- Structure - What is in the fuel-library?
- Granular Deployment - What is the granular deployment for Fuel?
- Upstream Modules - How to work with librarian.
- Testing - How to run fuel-library tests.
- Development
- Core Reviers
- Contributors
Overview
The fuel-library is collection of Puppet modules and related code used by Fuel to deploy OpenStack environments.
Structure
Basic Repository Layout
fuel-library
├── CHANGELOG
├── LICENSE
├── README.md
├── MAINTAINERS
├── debian
├── deployment
├── files
├── specs
├── tests
└── utils
root
The root level contains important repository documentation and license information.
MAINTAINERS
This is repository level MAINTAINERS file. One submitting a patch should contact the apropriate maintainer or invite her or him for the code review. Note, core reviewers are not the maintainers. Normally, cores do reviews after maintainers.
debian/
This folder contains the required information to create fuel-library debian packages.
deployment/
This folder contains the fuel-library Puppet code, the Puppetfile for upstream modules, and scripts to manage modules with librarian-puppet-simple.
files/
This folder contains scripts and configuration files that are used when creating the packages for fuel-library.
specs/
This folder contains our rpm spec file for fuel-library rpm packages.
tests/
This folder contains our testing scripts for the fuel-library.
utils/
This folder contains scripts that are useful when doing development on fuel-library
Granular Deployment
The top-scope puppet manifests (sometimes also refered as the composition layer) represent the known deploy paths (aka supported deployment scenarios) for the task-based deployment.
Upstream Modules
In order to be able to pull in upstream modules for use by the fuel-library, the deployment folder contains a Puppetfile for use with librarian-puppet-simple. Upstream modules should be used whenever possible. For additional details on the process for working with upstream modules, please read the Fuel library for Puppet manifests of the Fuel wiki.
Testing
Testing is important for the fuel-library to ensure changes do what they are supposed to do, regressions are not introduced and all code is of the highest quality. The fuel-library leverages existing Puppet module rspec tests, bats tests for bash scripts and noop tests for testing the module deployment tasks in fuel-library.
Puppet module tests
Puppet rspec tests should be provided for an every module's directory included.
All of the discovered tests will be automatically executed by the
rake spec command issued from the repository root path.
Bats: Bash Automated Testing System
Shell scripts residing in the ./files directories should be
covered by the BATS test cases.
These should be put under the ./tests/bats path as well.
Here is an example bats tests
written for the UMM feature.
See also the bats how-to.
fuel-library noop
The Noop testing framework is used for testing of the known deploy paths with existing modular tasks. For details, see the README