From 530dddec969df385e9aa29af0917f6ca97094d68 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Ga=C3=ABtan=20Duchaussois?= <gaetan.duchaussois@fretlink.com>
Date: Fri, 20 Apr 2018 10:01:33 +0200
Subject: [PATCH 1/1] README

---
 README.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5cf5f18
--- /dev/null
+++ b/README.md
@@ -0,0 +1,52 @@
+kong-app
+=========
+
+This role aims at creating on a remote kong the service, routes and plugins needed by an app
+
+Requirements
+------------
+
+None at the moment
+
+Role Variables
+--------------
+
+* `kong_app_admin_url` the kong admin url (mandatory).
+* `kong_app_admin_apikey` the apikey to use kong admin api. Default to ""
+* `kong_app_service_name` the nameof the service to create for this app, mandatory
+* `kong_app_service_url` the url of the backend of the app, mandatory
+* `kong_app_plugins` An array of plugins to activate with their name and config in a dict
+  * `name`
+  * `config`
+* `kong_app_routes` An array of routes to create for this app.
+  * `hosts`
+  * `paths`
+  * `protocols`
+  * `methods`
+
+Dependencies
+------------
+
+
+
+Example Playbook
+----------------
+
+    - hosts: localhost
+      roles:
+         - { role: kong-app, kong_app_admin_url: http://localhost:8001,
+             kong_app_service_name: example,
+             kong_app_service_url: http://example.com,
+             kong_app_plugins: [],
+             kong_app_routes: [ { hosts: [my.kong.example], paths: [/] } ]
+           }
+
+License
+-------
+
+TBD
+
+Author Information
+------------------
+
+FretLink Team
-- 
2.41.0