hybrid_platforms_conductor 32.12.0 → 32.13.0

data/spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/cli_options_spec.rb

@@ -97,11 +97,15 @@ describe HybridPlatformsConductor::ActionsExecutor do
         end
       end
 
-      it 'fails if no user name has been given, either through environment or command-line' do
+      it 'fails if no user name has been given, either through environment, command-line or using whoami' do
         ENV.delete 'hpc_ssh_user'
         ENV.delete 'USER'
         with_test_platform_for_cli do
-          expect { run 'run', '--node', 'node', '--command', 'echo Hello' }.to raise_error(RuntimeError, 'No SSH user name specified. Please use --ssh-user option or hpc_ssh_user environment variable to set it.')
+          with_cmd_runner_mocked([
+            ['whoami', proc { [0, '', ''] }]
+          ]) do
+            expect { run 'run', '--node', 'node', '--command', 'echo Hello' }.to raise_error(RuntimeError, 'No SSH user name specified. Please use --ssh-user option or hpc_ssh_user environment variable to set it.')
+          end
         end
       end
 

data/spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/global_helpers_spec.rb

@@ -47,7 +47,7 @@ describe HybridPlatformsConductor::ActionsExecutor do
         end.join("\n") + "\n"
       end
 
-      it 'generates a global configuration with user from environment' do
+      it 'generates a global configuration with user from hpc_ssh_user environment variable' do
         with_test_platform do
           ENV['hpc_ssh_user'] = 'test_user'
           expect(ssh_config_for(nil)).to eq <<~EOS
@@ -59,6 +59,43 @@ describe HybridPlatformsConductor::ActionsExecutor do
         end
       end
 
+      it 'generates a global configuration with user from USER environment variable' do
+        with_test_platform do
+          ENV['USER'] = 'test_user'
+          expect(ssh_config_for(nil)).to eq <<~EOS
+            Host *
+              User test_user
+              ControlPath #{Dir.tmpdir}/hpc_ssh/hpc_ssh_mux_%h_%p_%r
+              PubkeyAcceptedKeyTypes +ssh-dss
+          EOS
+        end
+      end
+
+      it 'generates a global configuration with user taken from whoami when no env variable is set' do
+        with_test_platform do
+          original_user = ENV['USER']
+          begin
+            ENV.delete 'USER'
+            ENV.delete 'hpc_ssh_user'
+            with_cmd_runner_mocked(
+              [
+                ['ssh -V 2>&1', proc { [0, "OpenSSH_7.4p1 Debian-10+deb9u7, OpenSSL 1.0.2u  20 Dec 2019\n", ''] }],
+                ['whoami', proc { [0, 'test_whoami_user', ''] }]
+              ]
+            ) do
+              expect(ssh_config_for(nil)).to eq <<~EOS
+                Host *
+                  User test_whoami_user
+                  ControlPath #{Dir.tmpdir}/hpc_ssh/hpc_ssh_mux_%h_%p_%r
+                  PubkeyAcceptedKeyTypes +ssh-dss
+              EOS
+            end
+          ensure
+            ENV['USER'] = original_user
+          end
+        end
+      end
+
       it 'generates a global configuration with user from setting' do
         with_test_platform do
           test_connector.ssh_user = 'test_user'

data/spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/remote_actions_spec.rb

@@ -6,7 +6,7 @@ describe HybridPlatformsConductor::ActionsExecutor do
 
       it 'executes bash commands remotely' do
         with_test_platform_for_remote_testing(
-          expected_cmds: [[/.+\/ssh hpc\.node \/bin\/bash <<'EOF'\nbash_cmd.bash\nEOF/, proc { [0, 'Bash commands executed on node', ''] }]],
+          expected_cmds: [[/.+\/ssh hpc\.node \/bin\/bash <<'HPC_EOF'\nbash_cmd.bash\nHPC_EOF/, proc { [0, 'Bash commands executed on node', ''] }]],
           expected_stdout: 'Bash commands executed on node'
         ) do
           test_connector.remote_bash('bash_cmd.bash')
@@ -17,7 +17,7 @@ describe HybridPlatformsConductor::ActionsExecutor do
         with_test_platform_for_remote_testing(
           expected_cmds: [
             [
-              /.+\/ssh hpc\.node \/bin\/bash <<'EOF'\nbash_cmd.bash\nEOF/,
+              /.+\/ssh hpc\.node \/bin\/bash <<'HPC_EOF'\nbash_cmd.bash\nHPC_EOF/,
               proc do |cmd, log_to_file: nil, log_to_stdout: true, log_stdout_to_io: nil, log_stderr_to_io: nil, expected_code: 0, timeout: nil, no_exception: false|
                 expect(timeout).to eq 5
                 [0, '', '']
@@ -76,7 +76,7 @@ describe HybridPlatformsConductor::ActionsExecutor do
             [
               /.+\/hpc_temp_cmds_.+\.sh$/,
               proc do |received_cmd|
-                expect(File.read(received_cmd)).to match /.+\/ssh hpc\.node \/bin\/bash <<'EOF'\n#{Regexp.escape(cmd)}\nEOF/
+                expect(File.read(received_cmd)).to match /.+\/ssh hpc\.node \/bin\/bash <<'HPC_EOF'\n#{Regexp.escape(cmd)}\nHPC_EOF/
                 [0, 'Bash commands executed on node', '']
               end
             ]
@@ -143,7 +143,7 @@ describe HybridPlatformsConductor::ActionsExecutor do
 
       it 'executes bash commands remotely without Session Exec capabilities' do
         with_test_platform_for_remote_testing(
-          expected_cmds: [[/^\{ cat \| .+\/ssh hpc\.node -T; } <<'EOF'\nbash_cmd.bash\nEOF$/, proc { [0, 'Bash commands executed on node', ''] }]],
+          expected_cmds: [[/^\{ cat \| .+\/ssh hpc\.node -T; } <<'HPC_EOF'\nbash_cmd.bash\nHPC_EOF$/, proc { [0, 'Bash commands executed on node', ''] }]],
           expected_stdout: 'Bash commands executed on node',
           session_exec: false
         ) do
@@ -168,12 +168,12 @@ describe HybridPlatformsConductor::ActionsExecutor do
       it 'copies files remotely without Session Exec capabilities and with sudo' do
         with_test_platform_for_remote_testing(
           expected_cmds: [
-            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'EOF'\nmkdir -p hpc_tmp_scp\nEOF$/, proc { [0, '', ''] }],
+            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'HPC_EOF'\nmkdir -p hpc_tmp_scp\nHPC_EOF$/, proc { [0, '', ''] }],
             [
               /^scp -S .+\/ssh \/path\/to\/src.file hpc\.node:\.\/hpc_tmp_scp$/,
               proc { [0, '', ''] }
             ],
-            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'EOF'\nsudo -u root mv \.\/hpc_tmp_scp\/src\.file \/remote_path\/to\/dst\.dir\nEOF$/, proc { [0, '', ''] }]
+            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'HPC_EOF'\nsudo -u root mv \.\/hpc_tmp_scp\/src\.file \/remote_path\/to\/dst\.dir\nHPC_EOF$/, proc { [0, '', ''] }]
           ],
           session_exec: false
         ) do
@@ -184,12 +184,12 @@ describe HybridPlatformsConductor::ActionsExecutor do
       it 'copies files remotely without Session Exec capabilities and with a different sudo' do
         with_test_platform_for_remote_testing(
           expected_cmds: [
-            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'EOF'\nmkdir -p hpc_tmp_scp\nEOF$/, proc { [0, '', ''] }],
+            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'HPC_EOF'\nmkdir -p hpc_tmp_scp\nHPC_EOF$/, proc { [0, '', ''] }],
             [
               /^scp -S .+\/ssh \/path\/to\/src.file hpc\.node:\.\/hpc_tmp_scp$/,
               proc { [0, '', ''] }
             ],
-            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'EOF'\nother_sudo --user root mv \.\/hpc_tmp_scp\/src\.file \/remote_path\/to\/dst\.dir\nEOF$/, proc { [0, '', ''] }]
+            [/^\{ cat \| .+\/ssh hpc\.node -T; } <<'HPC_EOF'\nother_sudo --user root mv \.\/hpc_tmp_scp\/src\.file \/remote_path\/to\/dst\.dir\nHPC_EOF$/, proc { [0, '', ''] }]
           ],
           additional_config: 'sudo_for { |user| "other_sudo --user #{user}" }',
           session_exec: false

data/spec/hybrid_platforms_conductor_test/docs_spec.rb

@@ -0,0 +1,10 @@
+describe 'Documentation' do
+
+  it 'makes sure all Markdown links are valid' do
+    check_stdout = `bundle exec tools/check_md README.md #{Dir.glob('docs/**/*.md').join(' ')}`.split("\n")
+    summary_idx = check_stdout.index { |line| line =~ /^\d+ errors:$/ }
+    expect(summary_idx).not_to eq(nil), "Could not parse check output: #{check_stdout.join("\n")}"
+    expect(check_stdout[summary_idx]).to eq('0 errors:'), "Invalid links found: #{check_stdout[summary_idx..-1].join("\n")}"
+  end
+
+end

data/tools/check_md

@@ -0,0 +1,89 @@
+#!/usr/bin/env ruby
+
+# Parsed information, per file name.
+# Information is:
+# * *anchors* (Array<String>): List of anchors
+# * *links* (Array<String>): List of links
+@info = {}
+
+# Get a file name from a link
+#
+# Parameters::
+# * *link* (String): The link to find the file from
+# * *file* (String): The file from which the link is taken
+# Result::
+# * String: Resulting file
+def link_to_file(link, file)
+  link_file = link.split('#').first
+  if link_file == ''
+    file
+  elsif link_file.start_with?('/')
+    link_file[1..-1]
+  else
+    File.expand_path("#{File.dirname(file)}/#{link_file}").gsub("#{Dir.pwd}/", '')
+  end
+end
+
+# Parse a Markdown file
+#
+# Parameters::
+# * *file* (String): Markdown file to be parsed
+def parse_md(file)
+  unless @info.key?(file)
+    puts "Parsing #{file}..."
+    content = File.read(file)
+    @info[file] = {
+      anchors: content.scan(/<a name="([^"]*)"><\/a>/).map { |(anchor)| anchor },
+      links: content.scan(/\[[^\]]*\]\(([^\)]*)\)/).map { |(link)| link }
+    }
+    # Parse linked files
+    @info[file][:links].each do |link|
+      puts "Found #{file} => #{link}"
+    end
+    @info[file][:links].each do |link|
+      unless link.start_with?('http')
+        linked_file = link_to_file(link, file)
+        parse_md(linked_file) if File.exist?(linked_file) && linked_file.end_with?('.md')
+      end
+    end
+  end
+end
+
+ARGV.each { |file| parse_md(file) }
+
+# Check links
+errors = []
+@info.sort_by { |file, _info| file }.each do |file, info|
+  puts "= Links from #{file}"
+  info[:links].sort.uniq.each do |link|
+    puts "[#{
+      if link.start_with?('http')
+        '*'
+      else
+        anchor = link.split('#')[1]
+        linked_file = link_to_file(link, file)
+        if @info.key?(linked_file)
+          if anchor.nil?
+            '*'
+          elsif @info[linked_file][:anchors].include?(anchor)
+            '*'
+          else
+            errors << "[#{file} -> #{link}] - Destination has no anchor named #{anchor}"
+            ' '
+          end
+        elsif File.exist?(linked_file)
+          '*'
+        else
+          errors << "[#{file} -> #{link}] - Destination file does not exist"
+          ' '
+        end
+      end
+    }] #{link}"
+  end
+end
+
+puts
+puts "#{errors.size} errors:"
+errors.each do |error|
+  puts error
+end

data/tools/generate_mermaid

@@ -0,0 +1,75 @@
+#!/usr/bin/env ruby
+
+require 'json'
+require 'tempfile'
+
+MARKER_BEGIN = '<!-- Mermaid generator - Section start -->'
+MARKER_END = '<!-- Mermaid generator - Section end -->'
+
+# Generate Mermaid diagrams from a Markdown file.
+# Modify the Markdown file if the Mermaid diagram is to be referenced for the first time.
+#
+# Parameters::
+# * *file* (String): Markdown file to be parsed
+def gen_mermaid(file)
+  markdown = []
+  mermaid_content = nil
+  in_markers = false
+  idx_mermaid = 0
+  File.read(file).split("\n").each do |line|
+    # Logic is simple: Mermaid code blocks should be encapsulated between comment markers that will also include the generated diagram and the details setion.
+    # We always regenerate the content between existing comment markers.
+    # If those comment markers are missing, we will find Mermaid code blocks to add them.
+    # We always re-generate all diagrams.
+    if line == MARKER_BEGIN
+      in_markers = true
+    elsif line == MARKER_END
+      in_markers = false
+    elsif line == '```mermaid'
+      mermaid_content = []
+    elsif line == '```'
+      # End any block, including Mermaid block
+      if mermaid_content.nil?
+        markdown << line
+      else
+        # We have a diagram to generate
+        gen_file = "docs/gen/mermaid/#{file}-#{idx_mermaid}.png"
+        puts "Generate #{file} / Diagram ##{idx_mermaid} => #{gen_file}..."
+        FileUtils.mkdir_p File.dirname(gen_file)
+        Tempfile.create('mermaid') do |mermaid_file|
+          mermaid_file.write(mermaid_content.join("\n"))
+          mermaid_file.flush
+          mmdc_cmd = "./node_modules/.bin/mmdc -p #{@puppeteer_conf} -i #{mermaid_file.path} -o #{gen_file} -w 2048"
+          raise "Error while running mmdc: #{mmdc_cmd}" unless system mmdc_cmd
+        end
+        markdown.concat [
+          MARKER_BEGIN,
+          "![Mermaid diagram](/#{gen_file})",
+          '<details>',
+          '<summary>See diagram Mermaid code</summary>',
+          '',
+          '```mermaid'
+        ] + mermaid_content + [
+          '```',
+          '</details>',
+          MARKER_END
+        ]
+        idx_mermaid += 1
+        mermaid_content = nil
+      end
+    elsif !mermaid_content.nil?
+      # We are in a Mermaid content
+      mermaid_content << line
+    elsif !in_markers
+      markdown << line
+    end
+  end
+  File.write(file, markdown.map { |line| "#{line}\n" }.join) if idx_mermaid > 0
+end
+
+Tempfile.create('puppeteer') do |puppeteer_file|
+  puppeteer_file.write({ args: ['--no-sandbox'] }.to_json)
+  puppeteer_file.flush
+  @puppeteer_conf = puppeteer_file.path
+  ARGV.each { |file| gen_mermaid(file) }
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hybrid_platforms_conductor
 version: !ruby/object:Gem::Version
-  version: 32.12.0
+  version: 32.13.0
 platform: ruby
 authors:
 - Muriel Salvan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-04-09 00:00:00.000000000 Z
+date: 2021-05-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: range_operators
@@ -281,23 +281,120 @@ description: Provides a complete toolset to help DevOps maintain, deploy, monito
 email:
 - muriel@x-aeon.com
 executables:
-- run
-- get_impacted_nodes
 - dump_nodes_json
-- check-node
-- nodes_to_deploy
+- get_impacted_nodes
+- topograph
+- run
 - free_veids
+- nodes_to_deploy
+- setup
 - free_ips
-- test
-- deploy
+- check-node
 - report
-- topograph
-- setup
+- test
 - last_deploys
 - ssh_config
+- deploy
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- CHANGELOG.md
+- LICENSE.md
+- README.md
+- docs/plugins.md
+- docs/plugins/provisioner/podman.md
+- docs/plugins/provisioner/docker.md
+- docs/plugins/provisioner/proxmox.md
+- docs/plugins/connector/local.md
+- docs/plugins/connector/ssh.md
+- docs/plugins/action/scp.md
+- docs/plugins/action/interactive.md
+- docs/plugins/action/bash.md
+- docs/plugins/action/remote_bash.md
+- docs/plugins/action/ruby.md
+- docs/plugins/report/stdout.md
+- docs/plugins/report/confluence.md
+- docs/plugins/report/mediawiki.md
+- docs/plugins/cmdb/host_ip.md
+- docs/plugins/cmdb/platform_handlers.md
+- docs/plugins/cmdb/config.md
+- docs/plugins/cmdb/host_keys.md
+- docs/plugins/test/veids.md
+- docs/plugins/test/idempotence.md
+- docs/plugins/test/jenkins_ci_conf.md
+- docs/plugins/test/check_deploy_and_idempotence.md
+- docs/plugins/test/divergence.md
+- docs/plugins/test/check_from_scratch.md
+- docs/plugins/test/bitbucket_conf.md
+- docs/plugins/test/public_ips.md
+- docs/plugins/test/deploy_freshness.md
+- docs/plugins/test/private_ips.md
+- docs/plugins/test/connection.md
+- docs/plugins/test/orphan_files.md
+- docs/plugins/test/ports.md
+- docs/plugins/test/file_system_hdfs.md
+- docs/plugins/test/jenkins_ci_masters_ok.md
+- docs/plugins/test/can_be_checked.md
+- docs/plugins/test/local_users.md
+- docs/plugins/test/executables.md
+- docs/plugins/test/spectre.md
+- docs/plugins/test/deploy_removes_root_access.md
+- docs/plugins/test/deploy_from_scratch.md
+- docs/plugins/test/file_system.md
+- docs/plugins/test/mounts.md
+- docs/plugins/test/ip.md
+- docs/plugins/test/vulnerabilities.md
+- docs/plugins/test/hostname.md
+- docs/plugins/test/linear_strategy.md
+- docs/plugins/platform_handler/yaml_inventory.md
+- docs/plugins/test_report/stdout.md
+- docs/plugins/test_report/confluence.md
+- docs/install.md
+- docs/plugins_create.md
+- docs/executables/topograph.md
+- docs/executables/report.md
+- docs/executables/free_ips.md
+- docs/executables/free_veids.md
+- docs/executables/last_deploys.md
+- docs/executables/check-node.md
+- docs/executables/nodes_to_deploy.md
+- docs/executables/run.md
+- docs/executables/deploy.md
+- docs/executables/setup.md
+- docs/executables/dump_nodes_json.md
+- docs/executables/ssh_config.md
+- docs/executables/get_impacted_nodes.md
+- docs/executables/test.md
+- docs/executables.md
+- docs/gen/mermaid/README.md-0.png
+- docs/gen/mermaid/docs/executables/last_deploys.md-0.png
+- docs/gen/mermaid/docs/executables/check-node.md-0.png
+- docs/gen/mermaid/docs/executables/deploy.md-0.png
+- docs/gen/mermaid/docs/executables/free_ips.md-0.png
+- docs/gen/mermaid/docs/executables/nodes_to_deploy.md-0.png
+- docs/gen/mermaid/docs/executables/setup.md-0.png
+- docs/gen/mermaid/docs/executables/test.md-0.png
+- docs/gen/mermaid/docs/executables/run.md-0.png
+- docs/gen/mermaid/docs/executables/get_impacted_nodes.md-0.png
+- docs/gen/mermaid/docs/executables/report.md-0.png
+- docs/gen/mermaid/docs/executables/free_veids.md-0.png
+- docs/gen/mermaid/docs/executables/ssh_config.md-0.png
+- docs/api.md
+- docs/tutorial/05_extend_with_plugins.md
+- docs/tutorial/01_installation.md
+- docs/tutorial/04_test.md
+- docs/tutorial/03_scale.md
+- docs/tutorial/02_first_node.md
+- docs/config_dsl.md
+- docs/tutorial.md
+- examples/localhost/Gemfile
+- examples/localhost/hpc_config.rb
+- examples/localhost/inventory.yaml
+- examples/bare/Gemfile
+- examples/bare/hpc_config.rb
 files:
+- CHANGELOG.md
+- LICENSE.md
+- README.md
 - bin/check-node
 - bin/deploy
 - bin/dump_nodes_json
@@ -312,6 +409,97 @@ files:
 - bin/ssh_config
 - bin/test
 - bin/topograph
+- docs/api.md
+- docs/config_dsl.md
+- docs/executables.md
+- docs/executables/check-node.md
+- docs/executables/deploy.md
+- docs/executables/dump_nodes_json.md
+- docs/executables/free_ips.md
+- docs/executables/free_veids.md
+- docs/executables/get_impacted_nodes.md
+- docs/executables/last_deploys.md
+- docs/executables/nodes_to_deploy.md
+- docs/executables/report.md
+- docs/executables/run.md
+- docs/executables/setup.md
+- docs/executables/ssh_config.md
+- docs/executables/test.md
+- docs/executables/topograph.md
+- docs/gen/mermaid/README.md-0.png
+- docs/gen/mermaid/docs/executables/check-node.md-0.png
+- docs/gen/mermaid/docs/executables/deploy.md-0.png
+- docs/gen/mermaid/docs/executables/free_ips.md-0.png
+- docs/gen/mermaid/docs/executables/free_veids.md-0.png
+- docs/gen/mermaid/docs/executables/get_impacted_nodes.md-0.png
+- docs/gen/mermaid/docs/executables/last_deploys.md-0.png
+- docs/gen/mermaid/docs/executables/nodes_to_deploy.md-0.png
+- docs/gen/mermaid/docs/executables/report.md-0.png
+- docs/gen/mermaid/docs/executables/run.md-0.png
+- docs/gen/mermaid/docs/executables/setup.md-0.png
+- docs/gen/mermaid/docs/executables/ssh_config.md-0.png
+- docs/gen/mermaid/docs/executables/test.md-0.png
+- docs/install.md
+- docs/plugins.md
+- docs/plugins/action/bash.md
+- docs/plugins/action/interactive.md
+- docs/plugins/action/remote_bash.md
+- docs/plugins/action/ruby.md
+- docs/plugins/action/scp.md
+- docs/plugins/cmdb/config.md
+- docs/plugins/cmdb/host_ip.md
+- docs/plugins/cmdb/host_keys.md
+- docs/plugins/cmdb/platform_handlers.md
+- docs/plugins/connector/local.md
+- docs/plugins/connector/ssh.md
+- docs/plugins/platform_handler/yaml_inventory.md
+- docs/plugins/provisioner/docker.md
+- docs/plugins/provisioner/podman.md
+- docs/plugins/provisioner/proxmox.md
+- docs/plugins/report/confluence.md
+- docs/plugins/report/mediawiki.md
+- docs/plugins/report/stdout.md
+- docs/plugins/test/bitbucket_conf.md
+- docs/plugins/test/can_be_checked.md
+- docs/plugins/test/check_deploy_and_idempotence.md
+- docs/plugins/test/check_from_scratch.md
+- docs/plugins/test/connection.md
+- docs/plugins/test/deploy_freshness.md
+- docs/plugins/test/deploy_from_scratch.md
+- docs/plugins/test/deploy_removes_root_access.md
+- docs/plugins/test/divergence.md
+- docs/plugins/test/executables.md
+- docs/plugins/test/file_system.md
+- docs/plugins/test/file_system_hdfs.md
+- docs/plugins/test/hostname.md
+- docs/plugins/test/idempotence.md
+- docs/plugins/test/ip.md
+- docs/plugins/test/jenkins_ci_conf.md
+- docs/plugins/test/jenkins_ci_masters_ok.md
+- docs/plugins/test/linear_strategy.md
+- docs/plugins/test/local_users.md
+- docs/plugins/test/mounts.md
+- docs/plugins/test/orphan_files.md
+- docs/plugins/test/ports.md
+- docs/plugins/test/private_ips.md
+- docs/plugins/test/public_ips.md
+- docs/plugins/test/spectre.md
+- docs/plugins/test/veids.md
+- docs/plugins/test/vulnerabilities.md
+- docs/plugins/test_report/confluence.md
+- docs/plugins/test_report/stdout.md
+- docs/plugins_create.md
+- docs/tutorial.md
+- docs/tutorial/01_installation.md
+- docs/tutorial/02_first_node.md
+- docs/tutorial/03_scale.md
+- docs/tutorial/04_test.md
+- docs/tutorial/05_extend_with_plugins.md
+- examples/bare/Gemfile
+- examples/bare/hpc_config.rb
+- examples/localhost/Gemfile
+- examples/localhost/hpc_config.rb
+- examples/localhost/inventory.yaml
 - lib/hybrid_platforms_conductor/action.rb
 - lib/hybrid_platforms_conductor/actions_executor.rb
 - lib/hybrid_platforms_conductor/bitbucket.rb
@@ -339,9 +527,11 @@ files:
 - lib/hybrid_platforms_conductor/hpc_plugins/cmdb/host_keys.rb
 - lib/hybrid_platforms_conductor/hpc_plugins/cmdb/my_cmdb.rb.sample
 - lib/hybrid_platforms_conductor/hpc_plugins/cmdb/platform_handlers.rb
+- lib/hybrid_platforms_conductor/hpc_plugins/connector/local.rb
 - lib/hybrid_platforms_conductor/hpc_plugins/connector/my_connector.rb.sample
 - lib/hybrid_platforms_conductor/hpc_plugins/connector/ssh.rb
 - lib/hybrid_platforms_conductor/hpc_plugins/platform_handler/platform_handler_plugin.rb.sample
+- lib/hybrid_platforms_conductor/hpc_plugins/platform_handler/yaml_inventory.rb
 - lib/hybrid_platforms_conductor/hpc_plugins/provisioner/docker.rb
 - lib/hybrid_platforms_conductor/hpc_plugins/provisioner/my_provisioner.rb.sample
 - lib/hybrid_platforms_conductor/hpc_plugins/provisioner/podman.rb
@@ -422,6 +612,8 @@ files:
 - spec/hybrid_platforms_conductor_test/api/actions_executor/actions/scp_spec.rb
 - spec/hybrid_platforms_conductor_test/api/actions_executor/actions_spec.rb
 - spec/hybrid_platforms_conductor_test/api/actions_executor/connection_spec.rb
+- spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/local/connectable_nodes_spec.rb
+- spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/local/remote_actions_spec.rb
 - spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/cli_options_spec.rb
 - spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/config_dsl_spec.rb
 - spec/hybrid_platforms_conductor_test/api/actions_executor/connectors/ssh/connectable_nodes_spec.rb
@@ -491,6 +683,7 @@ files:
 - spec/hybrid_platforms_conductor_test/cmdb_plugins/test_cmdb2.rb
 - spec/hybrid_platforms_conductor_test/cmdb_plugins/test_cmdb_others.rb
 - spec/hybrid_platforms_conductor_test/cmdb_plugins/test_cmdb_others2.rb
+- spec/hybrid_platforms_conductor_test/docs_spec.rb
 - spec/hybrid_platforms_conductor_test/executables/check-node_spec.rb
 - spec/hybrid_platforms_conductor_test/executables/deploy_spec.rb
 - spec/hybrid_platforms_conductor_test/executables/get_impacted_nodes_spec.rb
@@ -542,6 +735,8 @@ files:
 - spec/hybrid_platforms_conductor_test/test_provisioner.rb
 - spec/hybrid_platforms_conductor_test/tests_report_plugin.rb
 - spec/spec_helper.rb
+- tools/check_md
+- tools/generate_mermaid
 homepage: 
 licenses:
 - BSD-3-Clause
@@ -561,7 +756,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.1.6
 signing_key: 
 specification_version: 4
 summary: Hybrid Platforms Conductor