nomadsl 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 516890be1a6a0126435bc38bb940ddd4b42ed7bfdc449603eefc79c2836d76de
-  data.tar.gz: 52df9fdd5da1dc4e3fde08f53648501d4df8ea56142ae01b9ebaa63b345fa476
+  metadata.gz: 7e373810efb5dc4ba6cb71d0788e6e114c6bb9db7f5eacd7aa45e5a3d5cf8903
+  data.tar.gz: 94270c72e2bf26c7c387c87ae9d612dbb5ce2de26decadec9559cd963d1440c1
 SHA512:
-  metadata.gz: 9c84f1b38735ba993d61c58764c6d46c3c5a9b09fa04dcf448c5e773a7400e9de025203f028d2ef4ab280c35f126bc72e74de35f2fc87363ed9730331b5201b2
-  data.tar.gz: 94ce12136ed7aa33ee243b42ca4afb7bcece3a5a96c28b0b550454249df5ced9cb642337a8e9d37b5713d076f4da7b49c2c4474b73e600770e2dbcbbc7542024
+  metadata.gz: 8f1d263ba2e882a691724734df548cd91fd948bbd15d6ed2a51d8b5a7a376548dd1e6faaab24067d4defb5f713f40731cf83d459193637a5f1d14a2bf845522d
+  data.tar.gz: 752afd8496be3adfbe72c38dc7890c85e3f724f64ab5515a59e41bbfb9f580cf7659a377241b03f72a6b41cd79781bf4d09a28bc1b1fbb73b91c7dfe5acd5ed7

data/README.md

@@ -2,11 +2,11 @@
 
 Nomadsl is a Ruby DSL for generating Nomad job specification files.
 
-Methods mapping to keys and attributes described in the Nomad Job Specification
-(https://www.nomadproject.io/docs/job-specification/index.html) are defined in
-an includable module.
+Methods mapping to keys and attributes described in the
+[Nomad Job Specification](https://www.nomadproject.io/docs/job-specification/index.html)
+are defined in an includable module.
 
-Nomadsl supports Nomad configuration syntax through version 0.9.0. The mapping
+Nomadsl supports Nomad configuration syntax through version 0.12.0. The mapping
 of key and attribute names to method names is generally one-to-one, but you can
 specify arbitrary configuration values to be rendered if necessary.
 
@@ -89,9 +89,9 @@ Will generate this output:
 
 ## Using `nomadsl` as the interpreter
 
-As of 0.1.4, you can also set your shbang line to use `nomadsl` as the
-interpreter of the script. This will evaluate everything as Ruby, but with the
-necessary `nomadsl` boilerplate already built in:
+You can also set your shbang line to use `nomadsl` as the interpreter of the
+script. This will evaluate everything as Ruby, but with the necessary `nomadsl`
+boilerplate already built in:
 
     #!/usr/bin/env nomadsl
 

data/lib/nomadsl.rb

@@ -13,6 +13,10 @@ module Nomadsl
     @nomadsl_print = b
   end
 
+  def parent
+    @stack.last
+  end
+
   def only(*levels)
     unless levels.include? @stack.last
       loc = caller_locations(1,1)[0]
@@ -168,7 +172,7 @@ module Nomadsl
   end
 
   # https://www.nomadproject.io/docs/job-specification/service.html#check-parameters
-  def check(address_mode: nil, args: nil, command: nil, grpc_service: nil, grpc_use_tls: nil, initial_status: nil, interval: nil, method: nil, name: nil, path: nil, port: nil, protocol: nil, timeout: nil, type: nil, tls_skip_verify: nil)
+  def check(address_mode: nil, args: nil, command: nil, grpc_service: nil, grpc_use_tls: nil, initial_status: nil, interval: nil, method: nil, name: nil, path: nil, expose: nil, port: nil, protocol: nil, task: nil, timeout: nil, type: nil, tls_skip_verify: nil)
     only :service
     block(:check) do
       str :address_mode, address_mode
@@ -177,14 +181,16 @@ module Nomadsl
       str :grpc_service, grpc_service
       bool :grpc_use_tls, grpc_use_tls
       str :initial_status, initial_status
-      str :interval, interval
+      str! :interval, interval
       str :method, method
       str :name, name
       str :path, path
+      bool :expose, expose
       str :port, port
       str :protocol, protocol
-      str :timeout, timeout
-      str :type, type
+      str :task, task
+      str! :timeout, timeout
+      str! :type, type
       bool :tls_skip_verify, tls_skip_verify
       yield if block_given?
     end
@@ -202,7 +208,7 @@ module Nomadsl
 
   # https://www.nomadproject.io/docs/job-specification/task.html#config
   def config(**opts)
-    only :task
+    only :task, :sidecar_task, :proxy
     config_method = "__config_#{@driver}".to_sym
     if private_methods.include?(config_method)
       send(config_method, **opts)
@@ -224,6 +230,14 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/connect
+  def connect(native: nil)
+    only :service
+    block(:connect) do
+      bool :native, native
+      yield if block_given?
+    end
+  end
 
   # https://www.nomadproject.io/docs/job-specification/constraint.html
   def constraint(attribute: nil, operator: nil, value: nil)
@@ -235,6 +249,16 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/csi_plugin
+  def csi_plugin(id: nil, type: nil, mount_dir: nil)
+    only :volume
+    block(:csi_plugin) do
+      str! :id, id
+      str! :type, type
+      str! :mount_dir, mount_dir
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/job.html#datacenters
   def datacenters(*d)
     only :job
@@ -258,9 +282,19 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/network#dns-parameters
+  def dns(servers: nil, searches: nil, options: nil)
+    only :network
+    block(:dns) do
+      list :servers, servers
+      list :searches, searches
+      list :options, options
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/env.html
   def env(**opts)
-    only :task
+    only :task, :sidecar_task
     strmap :env, opts
   end
 
@@ -274,11 +308,21 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/expose
+  def expose
+    only :proxy
+    block(:expose) do
+      yield if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/group.html
-  def group(name, count: nil)
+  def group(name, count: nil, shutdown_delay: nil, stop_after_client_disconnect: nil)
     only :job
     block(:group, name) do
       int :count, count
+      str :shutdown_delay, shutdown_delay
+      str :stop_after_client_disconnect, stop_after_client_disconnect
       yield
     end
   end
@@ -291,6 +335,15 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/lifecycle
+  def lifecycle(hook: nil, sidecar: nil)
+    only :task
+    block(:lifecycle) do
+      str :hook, hook
+      bool :sidecar, sidecar
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/job.html
   def job(j)
     # initialize the variables since this is the actual root
@@ -309,7 +362,7 @@ module Nomadsl
 
   # https://www.nomadproject.io/docs/job-specification/logs.html
   def logs(max_files: nil, max_file_size: nil)
-    only :task
+    only :task, :sidecar_task
     block(:logs) do
       int :max_files, max_files
       int :max_file_size, max_file_size
@@ -318,7 +371,7 @@ module Nomadsl
 
   # https://www.nomadproject.io/docs/job-specification/meta.html
   def meta(**opts)
-    only :job, :group, :task
+    only :job, :group, :task, :sidecar_task, :region
     strmap :meta, opts
   end
 
@@ -333,6 +386,14 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/multiregion
+  def multiregion
+    only :job
+    block(:multiregion) do
+      yield if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/job.html#namespace
   # Supported by Nomad Enterprise ONLY
   def namespace(n)
@@ -360,6 +421,17 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/expose#path-parameters
+  def path(path: nil, protocol: nil, local_path_port: nil)
+    only :expose
+    block(:path) do
+      str! :path, path
+      str! :protocol, protocol
+      int! :local_path_port, local_path_port
+      yield if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/periodic.html
   def periodic(cron: nil, prohibit_overlap: nil, time_zone: nil)
     only :job
@@ -370,9 +442,15 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/scaling#policy
+  def policy(**args)
+    only :scaling
+    any :policy, args
+  end
+
   # https://www.nomadproject.io/docs/job-specification/network.html#port
   def port(n, static: nil)
-    only :network
+    only :network, :path
     if static
       block(:port, n) do
         int :static, static
@@ -388,10 +466,29 @@ module Nomadsl
     int! :priority, p
   end
 
+  # https://www.nomadproject.io/docs/job-specification/proxy
+  def proxy(local_service_address: nil, local_service_port: nil)
+    only :sidecar_service
+    block(:proxy) do
+      str :local_service_address, local_service_address
+      int :local_service_port, local_service_port
+      yield if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/job.html#region
-  def region(r)
-    only :job
-    str! :region, r
+  # https://www.nomadproject.io/docs/job-specification/multiregion#region-parameters
+  def region(name, count: nil, datacenters: nil)
+    only :job, :multiregion
+    if parent == :job
+      str! :region, name
+    elsif parent == :multiregion
+      block(:region, name) do
+        int :count, count
+        list :datacenters, datacenters
+        yield if block_given?
+      end
+    end
   end
 
   # https://www.nomadproject.io/docs/job-specification/reschedule.html
@@ -409,10 +506,9 @@ module Nomadsl
 
   # https://www.nomadproject.io/docs/job-specification/resources.html
   def resources(cpu: nil, iops: nil, memory: nil)
-    only :task
+    only :task, :sidecar_task
     block(:resources) do
       int :cpu, cpu
-      int :iops, iops
       int :memory, memory
       yield if block_given?
     end
@@ -429,6 +525,17 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/scaling
+  def scaling(min: nil, max: nil, enabled: nil)
+    only :group
+    block(:scaling) do
+      int :min, min
+      int! :max, max
+      bool :enabled, enabled
+      yield if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/service.html
   def service(address_mode: nil, canary_tags: nil, name: nil, port: nil, tags: nil)
     only :task
@@ -442,6 +549,30 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/sidecar_service
+  def sidecar_service(tags: nil, port: nil)
+    only :connect
+    block(:sidecar_service) do
+      list :tags, tags
+      int :port, port
+      yield if block_given?
+    end
+  end
+
+  # https://www.nomadproject.io/docs/job-specification/sidecar_task
+  def sidecar_task(name: nil, driver: nil, user: nil, logs: nil, kill_timeout: nil, shutdown_delay: nil, kill_signal: nil)
+    only :connect
+    block(:sidecar_task) do
+      str :name, name
+      str :driver, driver
+      str :user, user
+      str :kill_timeout, kill_timeout
+      str :shutdown_delay, shutdown_delay
+      str :kill_signal, kill_signal
+      yielf if block_given?
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/spread.html
   def spread(attribute: nil, weight: nil)
     only :job, :group, :task
@@ -452,6 +583,15 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/multiregion#strategy-parameters
+  def strategy(max_parallel: nil, on_failure: nil)
+    only :multiregion
+    block(:strategy) do
+      int :max_parallel, max_parallel
+      str :on_failure, on_failure
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/spread.html#target-parameters
   def target(name: nil, value: nil, percent: nil)
     only :spread
@@ -516,6 +656,15 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/upstreams
+  def upstreams(destination_name: nil, local_bind_port: nil)
+    only :proxy
+    block(:upstreams) do
+      str! :destination_name, destination_name
+      int! :local_bind_port, local_bind_port
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/vault.html
   def vault(change_mode: nil, change_token: nil, env: nil, policies: nil)
     only :job, :group, :task
@@ -527,6 +676,26 @@ module Nomadsl
     end
   end
 
+  # https://www.nomadproject.io/docs/job-specification/volume
+  def volume(name, type: nil, source: nil, read_only: nil)
+    only :group
+    block(:volume, name) do
+      str :type, type
+      str! :source, source
+      bool :read_only, read_only
+    end
+  end
+
+  # https://www.nomadproject.io/docs/job-specification/volume_mount
+  def volume_mount(volume: nil, destination: nil, read_only: nil)
+    only :task
+    block(:volume_mount) do
+      str! :volume, volume
+      str! :destination, destination
+      bool :read_only, read_only
+    end
+  end
+
   # https://www.nomadproject.io/docs/job-specification/job.html#vault_token
   # NOTE: explicitly unsupported, dangerous
 
@@ -544,8 +713,12 @@ module Nomadsl
 
   def _vault_aws_creds(path, export)
     prefix = export ? "export " : ""
+    path = path.is_a?(String) ? [path] : path
+    args = path.reduce("") do |concat, str|
+      concat = "#{concat} \"#{str}\""
+    end
     <<~DATA
-      {{with secret "#{path}"}}
+      {{with secret #{args}}}
       #{prefix}AWS_ACCESS_KEY_ID={{.Data.access_key}}
       #{prefix}AWS_SECRET_ACCESS_KEY={{.Data.secret_key}}
       {{if .Data.security_token}}
@@ -565,8 +738,12 @@ module Nomadsl
 
   def _vault_consul_creds(path, export)
     prefix = export ? "export " : ""
+    path = path.is_a?(String) ? [path] : path
+    args = path.reduce("") do |concat, str|
+      concat = "#{concat} \"#{str}\""
+    end
     <<~DATA
-      {{with secret "#{path}"}}
+      {{with secret #{args}}}
       #{prefix}CONSUL_HTTP_TOKEN={{.Data.token}}
       {{end}}
     DATA

data/lib/nomadsl/version.rb

@@ -1,3 +1,3 @@
 module Nomadsl
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: nomadsl
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - David Adams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-22 00:00:00.000000000 Z
+date: 2021-02-24 00:00:00.000000000 Z
 dependencies: []
 description: 
 email: daveadams@gmail.com
@@ -43,7 +43,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Ruby DSL for generating Nomad job specification files