ariframadhan01 / satisfy

Satis composer repository manager with a Web UI

Satisfy

Satis Composer repository manager with a simple web UI.

Introduction

Satisfy provides:

• a Web UI: A CRUD to manage your satis configuration file
• a simple security layer with a login form
• a webhook endpoints for most popular version control systems
• Satis itself

Satisfy ease your satis configuration management. It provides simple web UI over Satis to avoid a hand-editing of the satis.json configuration file. All repositories from a composer.lock file can also be imported via upload.

How it works ?

Basically, it just reads/writes the satis.json file and provides a web CRUD.

• On each HTTP request, the satis.json is loaded.
• If a write occurs in this file, a backup is made in var/satis/

Installation

Composer

• Download composer wget http://getcomposer.org/composer.phar
• Install php composer.phar create-project playbloom/satisfy

Satis configuration

• Either define your default/existing satis configuration
• or use interactice satis CLI tool ./bin/satis init
• or submit form at /admin/configuration

By default, the satis.json file is expected at the project root, but You can set another path under parameter satis_filename.

Application configuration

• Customize app/config/parameters.yml according to your needs.

Security

You can restrict the access setting admin.auth parameter (in app/config/parameters.yml) to true. Set authorized users in admin.users config array.

Run Satisfy

Create a webserver pointing to the public directory. Browse to »/admin/« to manage the satis.json. To serve the package.json it is required to run Satis first.

Satis packages definition generation

Since Satisfy does only manage the Satis configuration file, it is necessary to build the package definitions using Satis.

A bin shortcut to Satis is already included in Satisfy, so run the following command to generate the files in the web folder.

./bin/satis build

Automatically build a single package using WebHooks

For example, you can trigger a package generation for your BitBucket project by setting up a BitBucket webhook to connect back to [your-satis-url]/webhook/bitbucket every time you do a code push. This is more efficient than doing a full build, and avoids you having to run full builds on a frequent schedule, or logging in to the admin interface just to force a build.

Authors

• Ludovic Fleury - [email protected] - http://twitter.com/ludofleury
• Julius Beckmann - [email protected] - https://twitter.com/h4cc
• Ramūnas Dronga - [email protected]

License

Satisfy is licensed under the MIT License - see the LICENSE file for details