Class: Pvectl::Services::EditHosts

Inherits:
Object
  • Object
show all
Defined in:
lib/pvectl/services/edit_hosts.rb

Overview

Orchestrates the interactive editing flow for /etc/hosts on a node.

Fetches current /etc/hosts content + digest, opens it in an editor, and POSTs the new content back with the original digest for optimistic locking. If Proxmox returns a digest collision (concurrent modification) or any other error, the message is surfaced verbatim to the user.

Unlike DNS (structured YAML), /etc/hosts is edited as raw text —there is no parsing or validation pvectl-side.

Examples:

Basic usage

service = EditHosts.new(hosts_repository: repo)
result = service.execute(node_name: "pve1")

Dry run

service = EditHosts.new(hosts_repository: repo, options: { dry_run: true })
result = service.execute(node_name: "pve1")

Instance Method Summary collapse

Constructor Details

#initialize(hosts_repository:, editor_session: nil, options: {}) ⇒ EditHosts

Creates a new EditHosts service.

Parameters:

  • hosts_repository (Repositories::Hosts) —

    Hosts repository

  • editor_session (EditorSession, nil) (defaults to: nil) —

    optional injected editor session

  • options (Hash) (defaults to: {}) —

    options (dry_run)



29
30
31
32
33
 
# File 'lib/pvectl/services/edit_hosts.rb', line 29

def initialize(hosts_repository:, editor_session: nil, options: {})
  @hosts_repository = hosts_repository
  @editor_session = editor_session
  @options = options
end

Instance Method Details

#execute(node_name:) ⇒ Models::NodeOperationResult?

Executes the interactive /etc/hosts edit flow.

Parameters:

  • node_name (String) —

    node name

Returns:



39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/pvectl/services/edit_hosts.rb', line 39

def execute(node_name:)
  hosts = @hosts_repository.fetch(node_name)
  original = hosts.data || ""
  digest = hosts.digest

  session = @editor_session || EditorSession.new
  edited = session.edit(original)

  return nil if edited.nil?
  return nil if edited == original

  resource_info = {
    node_name: node_name,
    diff: { original: original, edited: edited }
  }

  return build_result(resource_info, success: true) if @options[:dry_run]

  @hosts_repository.update(node_name, edited, digest)
  build_result(resource_info, success: true)
rescue StandardError => e
  build_result({ node_name: node_name }, success: false, error: e.message)
end