From 530dddec969df385e9aa29af0917f6ca97094d68 Mon Sep 17 00:00:00 2001 From: =?utf8?q?Ga=C3=ABtan=20Duchaussois?= Date: Fri, 20 Apr 2018 10:01:33 +0200 Subject: [PATCH] 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