Skip to content
Vinod Panicker edited this page May 12, 2016 · 27 revisions

OpenAppHack

Openapphack is an opensource application aggregrator.

Openapphack and its subprojects help aggregate ,validate and test github repositories that derived from openapphack-vm, openapphack-cluster, openapphack-pi-vm, openapphack-pi-cluster repositories

Openapphack also enables end to end automation of application deployment which can be leveraged for prototyping and distributed deployment of opensource applications .

Openapphack uses opensource tools for provisioning , code authoring and scaffolding.

Openapphack-vms/clusters leverages vagrant, ansible ,yeoman,virtualbox and docker for automation.

The goal is to get a collection of fully functional , customizable apps working on the openapphack-vm from a set of plain yaml files.

The broader purpose is to provide a simplified path for full stack developers to quickly get started on opensource technologies and experiment freely on opensource applications

What is OpenAppHack Project?

An OpenAppHack Project is a repository forked from the openapphack-vm to your github organization or individual namespace.

You need to make use of the openapphack ansible roles and openapphack yoeman generators and build an impressive fully functional opensource application.

Openapphack repositories

The others repositories used by the openapphack project are:

Openapphack-vm : Main repository which participants have to fork and will submit their pull requests.

Openapphack-ansibleroles : Repository for ansible roles that can be used by openapphack projects , You can also add your own ansible roles that work on openapphack-vm

Openapphack-yeoman-generators : Repository for the generators. You can also add your own yeoman generators that work on openapphack-vm, more info

Contributing to this projects

You can start contributing to this project by starting your own openapphack project as mentioned below.

How do you start your openapphack-project?

You begin by forking an openapphack-vm and follow the instructions mentioned here

How do you customize your openapphack-project?

You are free to tweak the vm configurations as long as the base vagrant box and the openapphack vm folder structure is maintained.Any additional customization must be done only in the yaml files.

You are also free to add (only add) and include your own yeoman generator and ansbile roles as long as they work together on the openapphack-vm.

Please take a look here , on how to add your own openapphack ansible role

Please take a look here , on how to add your own openapphack yeoman generator

How do you test your openapphack-project?

clone your openapphack-vm associated with your githubid or org and run vagrant up , vagrant provision.

You should be able to validate and test your vm.

How do you submit your openapphack-project?

You will have to submit a pull request to openapphack repository to do so.

Do mention your github repository url and details of any ansible or yeoman generators you have included to get your openapphack project working.

Please join the community https://groups.google.com/forum/#!forum/openapphack. If you have any questions/suggestions please email to [email protected]

License

This project is licensed under the MIT open source license.

Credits

Still compiling this.. Lot of folks to thank, very are standing on the shoulders of a lot of excellent programmers and a lot of opensource projects.

here is a list ..