Class: SDM::Gateway

Inherits:

Object

• Object
• SDM::Gateway

Defined in:

lib/models/porcelain.rb

Overview

Gateway represents a StrongDM CLI installation running in gateway mode.

Instance Attribute Summary

• #bind_address ⇒ Object

  The hostname/port tuple which the gateway daemon will bind to.

• #device ⇒ Object

  Device is a read only device name uploaded by the gateway process when it comes online.

• #gateway_filter ⇒ Object

  GatewayFilter can be used to restrict the peering between relays and gateways.

• #id ⇒ Object

  Unique identifier of the Gateway.

• #listen_address ⇒ Object

  The public hostname/port tuple at which the gateway will be accessible to clients.

• #location ⇒ Object

  Location is a read only network location uploaded by the gateway process when it comes online.

• #maintenance_windows ⇒ Object

  Maintenance Windows define when this node is allowed to restart.

• #name ⇒ Object

  Unique human-readable name of the Gateway.

• #state ⇒ Object

  The current state of the gateway.

• #tags ⇒ Object

  Tags is a map of key, value pairs.

• #version ⇒ Object

  Version is a read only sdm binary version uploaded by the gateway process when it comes online.

Instance Method Summary

• #initialize(bind_address: nil, device: nil, gateway_filter: nil, id: nil, listen_address: nil, location: nil, maintenance_windows: nil, name: nil, state: nil, tags: nil, version: nil) ⇒ Gateway constructor

  A new instance of Gateway.

• #to_json(options = {}) ⇒ Object

Constructor Details

#initialize(bind_address: nil, device: nil, gateway_filter: nil, id: nil, listen_address: nil, location: nil, maintenance_windows: nil, name: nil, state: nil, tags: nil, version: nil) ⇒ Gateway

Returns a new instance of Gateway.

# File 'lib/models/porcelain.rb', line 4777

def initialize(
  bind_address: nil,
  device: nil,
  gateway_filter: nil,
  id: nil,
  listen_address: nil,
  location: nil,
  maintenance_windows: nil,
  name: nil,
  state: nil,
  tags: nil,
  version: nil
)
  @bind_address = bind_address == nil ? "" : bind_address
  @device = device == nil ? "" : device
  @gateway_filter = gateway_filter == nil ? "" : gateway_filter
  @id = id == nil ? "" : id
  @listen_address = listen_address == nil ? "" : listen_address
  @location = location == nil ? "" : location
  @maintenance_windows = maintenance_windows == nil ? [] : maintenance_windows
  @name = name == nil ? "" : name
  @state = state == nil ? "" : state
  @tags = tags == nil ? SDM::_porcelain_zero_value_tags() : tags
  @version = version == nil ? "" : version
end

Instance Attribute Details

#bind_address ⇒ Object

The hostname/port tuple which the gateway daemon will bind to. If not provided on create, set to "0.0.0.0:listen_address_port".

# File 'lib/models/porcelain.rb', line 4739

def bind_address
  @bind_address
end

#device ⇒ Object

Device is a read only device name uploaded by the gateway process when it comes online.

# File 'lib/models/porcelain.rb', line 4742

def device
  @device
end

#gateway_filter ⇒ Object

GatewayFilter can be used to restrict the peering between relays and gateways. Deprecated.

# File 'lib/models/porcelain.rb', line 4745

def gateway_filter
  @gateway_filter
end

#id ⇒ Object

Unique identifier of the Gateway.

# File 'lib/models/porcelain.rb', line 4747

def id
  @id
end

#listen_address ⇒ Object

The public hostname/port tuple at which the gateway will be accessible to clients.

# File 'lib/models/porcelain.rb', line 4749

def listen_address
  @listen_address
end

#location ⇒ Object

Location is a read only network location uploaded by the gateway process when it comes online.

# File 'lib/models/porcelain.rb', line 4752

def location
  @location
end

#maintenance_windows ⇒ Object

Maintenance Windows define when this node is allowed to restart. If a node is requested to restart, it will check each window to determine if any of them permit it to restart, and if any do, it will. This check is repeated per window until the restart is successfully completed.

If not set here, may be set on the command line or via an environment variable on the process itself; any server setting will take precedence over local settings. This setting is ineffective for nodes below version 38.44.0.

If this setting is not applied via this remote configuration or via local configuration, the default setting is used: always allow restarts if serving no connections, and allow a restart even if serving connections between 7-8 UTC, any day.

# File 'lib/models/porcelain.rb', line 4765

def maintenance_windows
  @maintenance_windows
end

#name ⇒ Object

Unique human-readable name of the Gateway. Node names must include only letters, numbers, and hyphens (no spaces, underscores, or other special characters). Generated if not provided on create.

# File 'lib/models/porcelain.rb', line 4767

def name
  @name
end

#state ⇒ Object

The current state of the gateway. One of: "new", "verifying_restart", "restarting", "started", "stopped", "dead", "unknown"

# File 'lib/models/porcelain.rb', line 4770

def state
  @state
end

#tags ⇒ Object

Tags is a map of key, value pairs.

# File 'lib/models/porcelain.rb', line 4772

def tags
  @tags
end

#version ⇒ Object

Version is a read only sdm binary version uploaded by the gateway process when it comes online.

# File 'lib/models/porcelain.rb', line 4775

def version
  @version
end

Instance Method Details

#to_json(options = {}) ⇒ Object

# File 'lib/models/porcelain.rb', line 4803

def to_json(options = {})
  hash = {}
  self.instance_variables.each do |var|
    hash[var.id2name.delete_prefix("@")] = self.instance_variable_get var
  end
  hash.to_json
end