hammer_cli_katello 0.23.1 → 0.24.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39b7d013b69ccff473c384efe07fbc1c1574033c074e685be65723f5e3d79156
-  data.tar.gz: 9ba014e8f0a515eddfbb66d507483fa8f81b8873c5e670eca78755989bc1f40d
+  metadata.gz: 3966349f8fac0df348af893168e4eb594d765834eeef7e973fe465cf78755331
+  data.tar.gz: 51541df551c787282da8367983c6a29543b529e20192c098169b5d0d1c1bc203
 SHA512:
-  metadata.gz: 32c3e1f7dc2aa8fa32ceba935d7229c7b628bdf9429f6ed1fa036e818d3cca44bfa47d5d2319e7b8b16354688302f6743168fca59aa62c4a956f9ba4206fe74c
-  data.tar.gz: d270942a73c21fa9e996f1e0457d82b8e4abc866ddeed5d201d017febfbf9272640144aeacc260387550e8e8e22b36fac80b33b2e7b3d93fad87ff98ee465886
+  metadata.gz: 5ed98c8abdee101d12324fdc9605c568f9adff0e3dae32d59941ac1d5ec8ebfa2d50826297d7826cff39ca2fb9b47707b356eb5e09618b2dc971bd5852cc0c50
+  data.tar.gz: 1c4f11a142861744f6f4ee0c618927d460c84e581ece723d76dc18ea44b90949b8afd1aa53747aa5d3307311814ece3d6cdf8f2ba94cbb019d7f63f395b39d16

data/lib/hammer_cli_katello.rb

@@ -31,6 +31,7 @@ module HammerCLIKatello
   require 'hammer_cli_katello/local_helper'
   require 'hammer_cli_katello/apipie_helper'
   require 'hammer_cli_katello/cv_import_export_helper'
+  require 'hammer_cli_katello/content_export_helper'
 
   # commands
   HammerCLI::MainCommand.lazy_subcommand("activation-key", _("Manipulate activation keys"),
@@ -53,8 +54,7 @@ module HammerCLIKatello
                                         )
 
   HammerCLI::MainCommand.lazy_subcommand("content-credentials",
-                                         _("Manipulate content credentials (i.e. GPG Keys)' \
-                                          'on the server"),
+                                         _("Manipulate content credentials on the server"),
                                          'HammerCLIKatello::ContentCredentialCommand',
                                          'hammer_cli_katello/content_credential'
                                         )
@@ -142,6 +142,18 @@ module HammerCLIKatello
                                          'hammer_cli_katello/file'
                                         )
 
+  HammerCLI::MainCommand.lazy_subcommand("content-export",
+                                          _("Prepare content for export to a disconnected Katello"),
+                                         'HammerCLIKatello::ContentExport',
+                                         'hammer_cli_katello/content_export'
+                                        )
+
+  HammerCLI::MainCommand.lazy_subcommand("content-import",
+                                         _("Import content from an upstream archive."),
+                                         'HammerCLIKatello::ContentImport',
+                                         'hammer_cli_katello/content_import'
+                                        )
+
   HammerCLI::MainCommand.lazy_subcommand("module-stream", _("View Module Streams"),
                                          'HammerCLIKatello::ModuleStreamCommand',
                                          'hammer_cli_katello/module_stream'

data/lib/hammer_cli_katello/content_export.rb

@@ -0,0 +1,72 @@
+require 'hammer_cli_katello/content_export_complete'
+require 'hammer_cli_katello/content_export_incremental'
+
+module HammerCLIKatello
+  class ContentExport < HammerCLIKatello::Command
+    desc "Prepare content for export to a disconnected Katello"
+    resource :content_exports
+
+    class GenerateMetadataCommand < HammerCLIKatello::Command
+      desc _("Writes export metadata to disk for use by the importing Katello. This command "\
+        + "only needs to be used if the export was performed asynchronously "\
+        + "or if the metadata was lost")
+
+      command_name 'generate-metadata'
+
+      include ContentExportHelper
+
+      option "--task-id", "TASK_ID",
+             _("Generate metadata based on output of the specified export task"),
+             :attribute_name => :option_task_id,
+             :required => false
+
+      option "--id", "ID",
+             _("Generate metadata based on specified export history"),
+             :attribute_name => :option_export_id,
+             :required => false
+
+      def execute
+        export_history = if option_task_id
+                           export_task = reload_task(option_task_id)
+                           fetch_export_history_from_task(export_task)
+                         else
+                           fetch_export_history(option_export_id)
+                         end
+
+        unless export_history
+          raise _("No export history was found. Verify the value given for "\
+            + "--task-id or --id")
+        end
+
+        generate_metadata_json(export_history)
+
+        HammerCLI::EX_OK
+      end
+    end
+
+    class ListCommand < HammerCLIKatello::ListCommand
+      desc "View content view export histories"
+      output do
+        field :id, _('ID')
+        field :destination_server, _('Destination Server')
+        field :path, _('Path')
+        field :content_view_version, _('Content View Version')
+        field :content_view_version_id, _('Content View Version ID')
+        field :created_at, _('Created at')
+        field :updated_at, _('Updated at'), Fields::Field, :hide_blank => true
+      end
+
+      build_options
+    end
+
+    autoload_subcommands
+
+    subcommand HammerCLIKatello::ContentExportComplete.command_name,
+               HammerCLIKatello::ContentExportComplete.desc,
+               HammerCLIKatello::ContentExportComplete
+
+    subcommand HammerCLIKatello::ContentExportIncremental.command_name,
+               HammerCLIKatello::ContentExportIncremental.desc,
+               HammerCLIKatello::ContentExportIncremental
+  end
+end

data/lib/hammer_cli_katello/content_export_complete.rb

@@ -0,0 +1,25 @@
+module HammerCLIKatello
+  class ContentExportComplete < HammerCLIKatello::Command
+    desc "Prepare content for a full export to a disconnected Katello"
+    resource :content_exports
+    command_name 'complete'
+
+    class VersionCommand < HammerCLIKatello::SingleResourceCommand
+      desc _('Performs a full export a content view version')
+      command_name "version"
+
+      include HammerCLIForemanTasks::Async
+      include ContentExportHelper
+    end
+
+    class LibraryCommand < HammerCLIKatello::SingleResourceCommand
+      desc _("Performs a full export of the organization's library environment")
+      command_name "library"
+
+      include HammerCLIForemanTasks::Async
+      include ContentExportHelper
+    end
+
+    autoload_subcommands
+  end
+end

data/lib/hammer_cli_katello/content_export_helper.rb

@@ -0,0 +1,181 @@
+require 'hammer_cli_katello/repository'
+# rubocop:disable ModuleLength
+module HammerCLIKatello
+  module ContentExportHelper
+    include ApipieHelper
+
+    def execute
+      warn_unexportable_repositories
+      response = super
+      if option_async?
+        output.print_message _("Once the task completes the export metadata must be generated "\
+          + "with the command:")
+        output.print_message(" hammer content-export generate-metadata --task-id #{@task['id']}")
+        HammerCLI::EX_OK
+      elsif response != HammerCLI::EX_OK
+        response
+      else
+        export_history = fetch_export_history_from_task(reload_task(@task))
+        if export_history
+          generate_metadata_json(export_history)
+          HammerCLI::EX_OK
+        else
+          output.print_error _("Could not fetch the export history")
+          HammerCLI::EX_CANTCREAT
+        end
+      end
+    end
+
+    def send_request
+      @task = super
+    end
+
+    def reload_task(task)
+      task_id = if task.is_a? Hash
+                  task['id']
+                else
+                  task
+                end
+      show(:foreman_tasks, id: task_id)
+    end
+
+    def fetch_export_history(export_history_id)
+      resource.call(:index, :id => export_history_id)["results"].first if export_history_id
+    end
+
+    def fetch_export_history_from_task(task)
+      # checking this here implies the task object was loaded recently
+      if %w(error warning).include?(task['result'])
+        raise _("Can not fetch export history from an unfinished task")
+      end
+
+      export_history_id = task.dig('output', 'export_history_id')
+      fetch_export_history(export_history_id)
+    end
+
+    def generate_metadata_json(export_history)
+      metadata_json = export_history["metadata"].to_json
+      begin
+        metadata_path = "#{export_history['path']}/metadata.json"
+        File.write(metadata_path, metadata_json)
+        output.print_message _("Generated #{metadata_path}")
+      rescue SystemCallError
+        filename = "metadata-#{export_history['id']}.json"
+        File.write(filename, metadata_json)
+        output.print_message _("Unable to access/write to '#{export_history['path']}'. "\
+                               "Generated '#{Dir.pwd}/#{filename}' instead. "\
+                               "This file is necessary to perform an import.")
+      end
+    end
+
+    def version_command?
+      self.class.command_name.first.to_sym == :version
+    end
+
+    def fetch_repositories
+      repo_options = {
+        library: true,
+        content_type: 'yum',
+        search: 'download_policy != immediate'
+      }
+      if version_command?
+        repo_options[:content_view_version_id] = resolver.content_view_version_id(options)
+      else
+        repo_options[:organization_id] = options["option_organization_id"]
+      end
+      index(:repositories, repo_options)
+    end
+
+    def warn_unexportable_repositories
+      repos = fetch_repositories
+      unless repos.empty?
+        if version_command?
+          output.print_message _("NOTE: Unable to fully export this version because"\
+            " it contains repositories without the 'immediate' download policy."\
+            " Update the download policy and sync affected repositories."\
+            " Once synced republish the content view"\
+            " and export the generated version.")
+        else
+          output.print_message _("NOTE: Unable to fully export this organization's library because"\
+            " it contains repositories without the 'immediate' download policy."\
+            " Update the download policy and sync affected"\
+            " repositories to include them in the export.")
+        end
+        output.print_message _("Use the following command to update the "\
+          "download policy of these repositories.")
+        output.print_message "hammer repository update --id=<REPOSITORY_ID> "\
+          "--download-policy='immediate'"
+        output.print_message ""
+        print_record(::HammerCLIKatello::Repository::ListCommand.output_definition, repos)
+        exit(HammerCLI::EX_SOFTWARE) if option_fail_on_missing_content?
+      end
+    end
+
+    def self.included(base)
+      if base.command_name.first.to_sym == :version
+        setup_version(base)
+      elsif base.command_name.first.to_sym == :library
+        setup_library(base)
+      end
+    end
+
+    def self.setup_library(base)
+      base.action(:library)
+      base.success_message _("Library environment is being exported in task %{id}.")
+      base.failure_message _("Could not export the library")
+      base.option "--fail-on-missing-content", :flag,
+                    _("Fails if any of the repositories belonging"\
+                      " to this organization are unexportable.")
+
+      base.build_options do |o|
+        o.expand(:all).including(:organizations)
+      end
+    end
+
+    def self.setup_version(base)
+      base.action(:version)
+      setup_version_options(base)
+      base.success_message _("Content view version is being exported in task %{id}.")
+      base.failure_message _("Could not export the content view version")
+
+      base.extend_with(
+        HammerCLIKatello::CommandExtensions::LifecycleEnvironments.new(only: :option_sources)
+      )
+      base.include(LifecycleEnvironmentNameMapping)
+
+      base.class_eval do
+        def request_params
+          super.tap do |opts|
+            opts["id"] = resolver.content_view_version_id(options)
+          end
+        end
+      end
+    end
+
+    def self.setup_version_options(base)
+      base.option "--fail-on-missing-content", :flag,
+                    _("Fails if any of the repositories belonging"\
+                      " to this version are unexportable.")
+
+      base.option "--version", "VERSION", _("Filter versions by version number."),
+                 :attribute_name => :option_version,
+                 :required => false
+
+      base.build_options do |o|
+        o.expand(:all).including(:content_views, :organizations, :environments)
+        o.without(:environment_ids, :environment_id)
+      end
+
+      base.validate_options do
+        unless option(:option_id).exist?
+          any(:option_id, :option_content_view_name, :option_content_view_id).required
+          any(:option_version, :option_environment_id, :option_environment_name).required
+          unless option(:option_content_view_id).exist?
+            any(:option_organization_id, :option_organization_name, \
+                                :option_organization_label).required
+          end
+        end
+      end
+    end
+  end
+end

data/lib/hammer_cli_katello/content_export_incremental.rb

@@ -0,0 +1,25 @@
+module HammerCLIKatello
+  class ContentExportIncremental < HammerCLIKatello::Command
+    desc "Prepare content for an incremental export to a disconnected Katello"
+    resource :content_export_incrementals
+    command_name 'incremental'
+
+    class VersionCommand < HammerCLIKatello::SingleResourceCommand
+      desc _('Performs an incremental export of a content view version')
+      command_name "version"
+
+      include HammerCLIForemanTasks::Async
+      include ContentExportHelper
+    end
+
+    class LibraryCommand < HammerCLIKatello::SingleResourceCommand
+      desc _("Performs an incremental export of the organization's library environment")
+      command_name "library"
+
+      include HammerCLIForemanTasks::Async
+      include ContentExportHelper
+    end
+
+    autoload_subcommands
+  end
+end

data/lib/hammer_cli_katello/content_import.rb

@@ -0,0 +1,63 @@
+module HammerCLIKatello
+  class ContentImport < HammerCLIKatello::Command
+    desc "Import content from a content archive"
+    resource :content_imports
+
+    module ContentImportCommon
+      def self.included(base)
+        base.option "--metadata-file",
+                "METADATA_FILE", _("Location of the metadata.json file. "\
+                                   "This is not required if the metadata.json file"\
+                                   " is already in the archive directory."),
+                 :attribute_name => :option_metadata_file,
+                 :required => false
+
+        base.build_options do |o|
+          o.expand(:all).including(:content_views, :organizations).except(:metadata)
+        end
+
+        base.validate_options do
+          option(:option_path).required
+
+          metadata_file = option(:option_metadata_file).value ||
+                          File.join(option(:option_path).value, "metadata.json")
+          unless File.exist?(metadata_file)
+            msg = _("Unable to find '#{metadata_file}'. "\
+                     "If the metadata.json file is at a different location "\
+                     "provide it to the --metadata-file option ")
+            raise HammerCLI::Options::Validators::ValidationError, msg
+          end
+        end
+        base.success_message _("Archive is being imported in task %{id}.")
+        base.failure_message _("Could not import the archive.")
+      end
+
+      def request_params
+        super.tap do |opts|
+          metadata_file = option_metadata_file || File.join(option_path, "metadata.json")
+          opts["metadata"] = JSON.parse(File.read(metadata_file))
+        end
+      end
+    end
+
+    class VersionCommand < HammerCLIKatello::SingleResourceCommand
+      desc _('Imports a content archive to a content view version')
+      action :version
+      command_name "version"
+
+      include HammerCLIForemanTasks::Async
+      include ContentImportCommon
+    end
+
+    class LibraryCommand < HammerCLIKatello::SingleResourceCommand
+      desc _("Imports a content archive to an organization's library lifecycle environment")
+      action :library
+      command_name "library"
+
+      include HammerCLIForemanTasks::Async
+      include ContentImportCommon
+    end
+
+    autoload_subcommands
+  end
+end

data/lib/hammer_cli_katello/content_view.rb

@@ -106,10 +106,12 @@ module HammerCLIKatello
       failure_message _("Could not create the content view")
 
       option ["--composite"], :flag, _("Create a composite content view")
-
+      option ["--import-only"], :flag, _("Designate this Content View for "\
+                                         "importing from upstream servers only.")
       def request_params
         super.tap do |opts|
           opts['composite'] = option_composite? || false
+          opts['import_only'] = option_import_only? || false
         end
       end
 

data/lib/hammer_cli_katello/host_traces.rb

@@ -14,6 +14,23 @@ module HammerCLIKatello
       end
       build_options
     end
+
+    class ResolveCommand < HammerCLIKatello::SingleResourceCommand
+      include HammerCLIForemanTasks::Async
+      resource :host_tracer, :resolve
+      command_name "resolve"
+
+      success_message _("Traces are being resolved with task %{id}.")
+      failure_message _("Could not resolve traces")
+
+      validate_options do
+        option(:option_trace_ids).required
+        option(:option_host_id).required
+      end
+
+      build_options
+    end
+
     autoload_subcommands
   end
 end