1
0
Fork 0
mirror of https://github.com/mmumshad/ansible-playable.git synced 2025-02-12 20:21:55 +00:00

Update Readme file

This commit is contained in:
Mumshad Mannambeth 2017-07-13 13:06:50 -04:00
parent 653c157263
commit 3d38e6d8ff
3 changed files with 71 additions and 4 deletions

View file

@ -1,15 +1,82 @@
# app2 # Playable
This project was generated with the [Angular Full-Stack Generator](https://github.com/DaftMonk/generator-angular-fullstack) version 4.2.2. [![ansible-playable](client/assets/images/banner.png)](https://angular-fullstack.github.io/)
Playable is an Ansible Playbook generator UI developed in MEAN stack using [Yeoman angular-fullstack-generator](https://github.com/angular-fullstack/generator-angular-fullstack) and built using [Docker](https://www.docker.com/).
The tool may be used by an individual or a team to
- Generate Ansible Playbooks
- Easily Search and import roles from Galaxy or Github
- Execute and Test Playbooks (Not available in the publicly hosted version)
- Develop custom modules and test them
- All the above while enforcing Ansible Best Practices
This is a fun project I started working on from my experience working with Ansible an developing custom modules. I think it will help the Ansible community and am looking forward to assistance in developing and maintaining this project.
> Note: This project is in its initial Alpha release. Hence this is only to be used for test purpose and at your own risk.
## Getting Started ## Getting Started
The easiest way to get started is to use Docker. The latest version of the software is built using docker and is available at [Docker hub](https://hub.docker.com/r/mmumshad/ansible-playable/)
Run the image to get started
```angular2html
docker run -p 80:8080 mmumshad/ansible-playable
```
Remember to use port mapping to map http port to external host.
Once the docker container is running visit http://\<docker host\> to access the web portal.
## Features
The tool currently supports the following features and functionality:
- Ansible Engine
- Add one Ansible Engine/s (Ansible Controller) per project
- Test connectivity to Ansible Engine
- Identify Ansible version
- Ansible Projects
- Create/Edit/Delete Ansible Projects
- Define Ansible Inventory files and variables
- View and edit project files
- Create Playbooks
- Create Plays and Tasks
- List all available modules
- Show module descriptions and parameters. Automatically identify parameters from documentation. (Provided the module was documented correctly in the standard format)
- List defined variables and values from inventory files as module parameters
- Search Roles from Github/Ansible Galaxy
- Show ReadMe file of roles in HTML format
- Import Roles from Github/Ansible Galaxy
- Playbook Execution
- Execute playbooks - individual or full
- Select custom verbose level
- Select custom hosts
- View Ansible output in the UI
- Test imported Roles
- View previous execution results
- Custom Modules
- Auto generate custom module template as per best practice
- Auto update documentation and parameter section based on user input
- Provides default properties and available types in UI
- Test developed custom module
### Prerequisites ### Prerequisites
#### With Docker
A host with docker installed. For instructions on installing Docker on host please check [here](https://docs.docker.com/engine/installation/)
#### Without Docker
Without Docker you will have to setup the system manually:
Install the following dependencies
- [Git](https://git-scm.com/) - [Git](https://git-scm.com/)
- [Node.js and npm](nodejs.org) Node >= 4.x.x, npm >= 2.x.x - [Node.js and npm](nodejs.org) Node >= 4.x.x, npm >= 2.x.x
- [Gulp](http://gulpjs.com/) (`npm install --global gulp`) - [Gulp](http://gulpjs.com/) (`npm install --global gulp`)
- [MongoDB](https://www.mongodb.org/) - Keep a running daemon with `mongod` - [MongoDB](https://www.mongodb.org/) - Keep a running daemon with `mongod`
- [Ansible](https://www.ansible.org/)
The Dockerfile in this code repository will give you the exact instructions to install dependencies and setup environment
### Developing ### Developing
@ -25,4 +92,4 @@ Run `gulp build` for building and `gulp serve` for preview.
## Testing ## Testing
Running `npm test` will run the unit tests with karma. Running `gulp test` will run the unit tests with karma.

View file

@ -7,7 +7,7 @@
<div class="row"> <div class="row">
<div class="col-md-offset-4 col-md-4"> <div class="col-md-offset-4 col-md-4">
Try it ! Try it !
<div class="logconsole" style="font-size: larger;"> <div class="logconsole" style="font-size: larger;background: rgba(0, 0, 0, 0.31)">
> docker run mmumshad/ansible-playable > docker run mmumshad/ansible-playable
</div> </div>
</div> </div>

Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB