Sha256: 23e9a9b1503e0fe4b579d8225570f6207b38819480bc58e1c7181f14708153ac

Contents?: true

Size: 1.86 KB

Versions: 181

Compression:

Stored size: 1.86 KB

Contents

require 'puppet/face'
require 'puppet/configurer/plugin_handler'

Puppet::Face.define(:plugin, '0.0.1') do
  copyright "Puppet Inc.", 2011
  license   _("Apache 2 license; see COPYING")

  summary _("Interact with the Puppet plugin system.")
  description <<-'EOT'
    This subcommand provides network access to the puppet master's store of
    plugins.

    The puppet master serves Ruby code collected from the `lib` directories
    of its modules. These plugins can be used on agent nodes to extend
    Facter and implement custom types and providers. Plugins are normally
    downloaded by puppet agent during the course of a run.
  EOT

  action :download do
    summary _("Download plugins from the puppet master.")
    description <<-'EOT'
      Downloads plugins from the configured puppet master. Any plugins
      downloaded in this way will be used in all subsequent Puppet activity.
      This action modifies files on disk.
    EOT
    returns _(<<-'EOT')
      A list of the files downloaded, or a confirmation that no files were
      downloaded. When used from the Ruby API, this action returns an array of
      the files downloaded, which will be empty if none were retrieved.
    EOT
    examples <<-'EOT'
      Retrieve plugins from the puppet master:

      $ puppet plugin download

      Retrieve plugins from the puppet master (API example):

      $ Puppet::Face[:plugin, '0.0.1'].download
    EOT

    when_invoked do |options|
      remote_environment_for_plugins = Puppet::Node::Environment.remote(Puppet[:environment])

      handler = Puppet::Configurer::PluginHandler.new()
      handler.download_plugins(remote_environment_for_plugins)
    end

    when_rendering :console do |value|
      if value.empty? then
        _("No plugins downloaded.")
      else
        _("Downloaded these plugins: %{plugins}") % { plugins: value.join(', ') }
      end
    end
  end
end

Version data entries

181 entries across 181 versions & 2 rubygems

Version Path
puppet-6.8.1 lib/puppet/face/plugin.rb
puppet-6.8.1-x86-mingw32 lib/puppet/face/plugin.rb
puppet-6.8.1-x64-mingw32 lib/puppet/face/plugin.rb
puppet-6.8.1-universal-darwin lib/puppet/face/plugin.rb
puppet-6.8.0 lib/puppet/face/plugin.rb
puppet-6.8.0-x86-mingw32 lib/puppet/face/plugin.rb
puppet-6.8.0-x64-mingw32 lib/puppet/face/plugin.rb
puppet-6.8.0-universal-darwin lib/puppet/face/plugin.rb
puppet-6.7.2 lib/puppet/face/plugin.rb
puppet-6.7.2-x86-mingw32 lib/puppet/face/plugin.rb
puppet-6.7.2-x64-mingw32 lib/puppet/face/plugin.rb
puppet-6.7.2-universal-darwin lib/puppet/face/plugin.rb
puppet-6.7.0 lib/puppet/face/plugin.rb
puppet-6.7.0-x86-mingw32 lib/puppet/face/plugin.rb
puppet-6.7.0-x64-mingw32 lib/puppet/face/plugin.rb
puppet-6.7.0-universal-darwin lib/puppet/face/plugin.rb
puppet-6.4.3 lib/puppet/face/plugin.rb
puppet-6.4.3-x86-mingw32 lib/puppet/face/plugin.rb
puppet-6.4.3-x64-mingw32 lib/puppet/face/plugin.rb
puppet-6.4.3-universal-darwin lib/puppet/face/plugin.rb