consul-templaterb 1.21.4 → 1.21.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e21590daefa93a69c9c00cd3acc6ebf0444a1a84d6bd9f1504c76484b4b97f0a
-  data.tar.gz: 290cbbdd8d86978a93b0c698d75d1c4822b8a2b521e32d7f93df96caac756d31
+  metadata.gz: 5fa40822c8a08d6cef1fff5fc846759ea9134d4b0faba09b2f0d986f3cf27f31
+  data.tar.gz: 25991106429db5b863c56f4ab136a99e2e58cfcd6529c84f5a6f15050d406184
 SHA512:
-  metadata.gz: 41ceec7b88410c5533cc073ec65f396cd6cf44de4a0c373465d3ae2931f024b2e65c1b88673b83c976d80fca5c53a0e28201a752681f21673fb87bcfdba1dfa9
-  data.tar.gz: 256c721efaa834afcfde8d3d7aadd042a2b73dc1d4894f8d657fc02e4883cbbb0a0a6d12f8a8c5c082d7207b704dd5a8214546955ae8058c9fb9e0db02722d1c
+  metadata.gz: d1d606bdb1129c6cc1bea6b62d824f0d5fdbc76620f228f1eb5eb3a89fb14d6b6b568b5189c4ca2e48189fa5a812cdccdc24b1d794ef7f3f724ff8b9af8ce5dd
+  data.tar.gz: 68550789a4a1d95a754329e57f41c24d1b2976c9f32d07f1414d40abc7f014208f4adc59043653b80e58abe567f87d6d31cdf3015e44a12bc8c6a9c584d025f8

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## (UNRELEASED)
 
+## 1.21.5 (December 6, 2019)
+
+* Added clean() method in nodes.js to allow nexw behaviors
+
 ## 1.21.4 (November 28, 2019)
 
 * added 2 decorators `navBarDecorator` and `fetchedResponseDecorator`

data/CONTRIBUTING.md

@@ -1,5 +1,9 @@
 # How to contribute to Consul-Templaterb ?
 
+## Architecxture Overview
+
+Please read [INTERNALS.md](INTERNALS.md) to understand how it works.
+
 ## Samples
 
 The [samples/](samples/) directory contains lots of useable templates that might help others using your new features.

data/INTERNALS.md

@@ -0,0 +1,47 @@
+# consul-templaterb Internal Architecture Overview
+
+## Consul basics
+
+`consul-templaterb` is a ruby library (or `GEM`) with a single binary that does render `.erb` files based on Consul exposed endpoints.
+
+Consul is a kind of distributed K/V tree store that exposes most of his APIs using HTTP endpoints with a way to watch for changes based on an Index. Each part of the Consul Tree has its own Index reflecting the last id of transaction for this
+part of the tree. It means that Consul has a kind of transaction ID for each subtree of the data.
+
+Consul also exposes some specific endpoints to get some discovery specific endpoints (eg: `/v1/catalog/services` to get
+the list of services registered in the cluster).
+
+For each endpoint, `consul-templaterb` performs a watch by getting information about the last transaction on this endpoints, storing it locally and watching at Consul to get updates about the data within this endpoint.
+
+## How it works
+
+There is a loop in the engine, every second, all templates are rendered using the `ERB` template engine.
+
+Each template is assigned to a `ConsulTemplateRender` object that keeps tracks of changes on disk of template (in order
+to be able to hot-reload templates) as well as monitoring if the template is completely rendered, aka all data from
+Consul is properly retrieved and consistent.
+
+At each rendering, each template using a Consul Endpoint (for instance, calling `datacenters()`) does register itself
+in `EndPointsManager`. If the endpoint is already registered, fetch the result if available and return the value, if not,
+the endpoint is tagged as dirty. When the rendering of a template is completed, a check is performed to see if some endpoints used by the template are still marked as dirty. Being dirty means that some data from Consul is missing, so
+that the result is not the definitive one. If no endpoint is dirty, then the result of template can be rendered on disk
+and template is complete.
+
+At startup, in order to converge faster, templates are rendered more quickly that every 1s to speed up startup time for first convergence, meaning that the delay between each rendering of template might be very fast, especially at startup (so, DO NOT USE Ruby I/O in templates unless you really know what you are doing)
+
+### EndPointsManager
+
+`EndPointsManager` is the object responsible of keeping track the endpoints (basically the I/O) of the whole library.
+When a new Consul endpoint is added by a template, it is registered in that object. Each time a template is rendered,
+all the endpoints are marked as used. When some endpoints are not used for a while (a few rendering loops), the 
+`EndPointsManager` will garbage collect those endpoints.
+
+### ConsulTemplateEngine
+
+When `consul-templaterb` starts, it creates an [ConsulTemplateEngine](lib/consul/async/consul_template_engine.rb) that
+aggregates all options, template files and parameters. The engine then starts a loop running every second (this can be changed) that:
+ * perform a rendering of each of the `.erb` template files using a `ConsulTemplateRender` object
+ * when all template are rendered the first time, will start some program(s) if specified (the `--exec` parameters)
+ 
+### ConsulTemplateRender
+
+This object keeps track of template, its last state (rendered or not), and whether the file template needs to be reloaded (aka if file has been modified on filesystem).

data/lib/consul/async/version.rb

@@ -1,5 +1,5 @@
 module Consul
   module Async
-    VERSION = '1.21.4'.freeze
+    VERSION = '1.21.5'.freeze
   end
 end

data/samples/consul-ui/js/nodes.js

@@ -15,6 +15,10 @@ class ConsulNodesManager extends ConsulUIManager {
     async initResource(data) {
         this.mainSelector.initSelector(data["nodes"]);
     }
+
+    async clean() {
+        this.mainSelector.initSelector({});
+    }
 }
 
 class NodeMainSelector extends MainSelector {

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: consul-templaterb
 version: !ruby/object:Gem::Version
-  version: 1.21.4
+  version: 1.21.5
 platform: ruby
 authors:
 - SRE Core Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-28 00:00:00.000000000 Z
+date: 2019-12-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: em-http-request
@@ -172,6 +172,7 @@ files:
 - CONTRIBUTING.md
 - Dockerfile
 - Gemfile
+- INTERNALS.md
 - LICENSE.txt
 - README.md
 - Rakefile