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.

• #connects_to ⇒ Object

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

• #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, connects_to: 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, connects_to: 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 3788

def initialize(
  bind_address: nil,
  connects_to: 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
  @connects_to = connects_to == nil ? "" : connects_to
  @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 3747

def bind_address
  @bind_address
end

#connects_to ⇒ Object

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

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

def connects_to
  @connects_to
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 3753

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 3756

def gateway_filter
  @gateway_filter
end

#id ⇒ Object

Unique identifier of the Gateway.

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

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 3760

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 3763

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 3776

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 3778

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 3781

def state
  @state
end

#tags ⇒ Object

Tags is a map of key, value pairs.

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

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 3786

def version
  @version
end

Instance Method Details

#to_json(options = {}) ⇒ Object

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

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