Sha256: 34fcab12fcbdb10224b18d20d624711684ad8925dafe0195881e2bef84850b75

Contents?: true

Size: 1.71 KB

Versions: 96

Compression:

Stored size: 1.71 KB

Contents

require 'puppet/indirector/face'

Puppet::Indirector::Face.define(:certificate_request, '0.0.1') do
  copyright "Puppet Labs", 2011
  license   "Apache 2 license; see COPYING"

  summary "Manage certificate requests."
  description <<-EOT
    This subcommand retrieves and submits certificate signing requests (CSRs).
  EOT

  deactivate_action(:destroy)

  find = get_action(:find)
  find.summary "Retrieve a single CSR."
  find.arguments "[<host>]"
  find.render_as = :s
  find.returns <<-EOT
    A single certificate request. When used from the Ruby API, returns a
    Puppet::SSL::CertificateRequest object.

    Defaults to the current nodes certname.
  EOT
  find.examples <<-EOT
    Retrieve a single CSR from the puppet master's CA:

    $ puppet certificate_request find somenode.puppetlabs.lan --terminus rest
  EOT

  search = get_action(:search)
  search.summary "Retrieve all outstanding CSRs."
  search.arguments "<dummy_text>"
  search.render_as = :s
  search.returns <<-EOT
    A list of certificate requests. When used from the Ruby API, returns an
    array of Puppet::SSL::CertificateRequest objects.
  EOT
  search.short_description <<-EOT
    Retrieves all outstanding certificate signing requests. Due to a known bug,
    this action requires a dummy search key, the content of which is irrelevant.
  EOT
  search.notes <<-EOT
    Although this action always returns all CSRs, it requires a dummy search
    key; this is a known bug.
  EOT
  search.examples <<-EOT
    Retrieve all CSRs from the local CA (similar to 'puppet cert list'):

    $ puppet certificate_request search x --terminus ca
  EOT

  get_action(:save).summary "API only: submit a certificate signing request."
  get_action(:save).arguments "<x509_CSR>"
end

Version data entries

96 entries across 96 versions & 2 rubygems

Version Path
puppet-retrospec-1.5.0 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-retrospec-1.4.1 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-retrospec-1.4.0 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-retrospec-1.3.2 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-retrospec-1.3.1 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-retrospec-1.3.0 vendor/gems/puppet-4.5.2/lib/puppet/face/certificate_request.rb
puppet-4.8.2 lib/puppet/face/certificate_request.rb
puppet-4.8.2-x86-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.8.2-x64-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.8.2-universal-darwin lib/puppet/face/certificate_request.rb
puppet-4.7.1 lib/puppet/face/certificate_request.rb
puppet-4.7.1-x86-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.7.1-x64-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.7.1-universal-darwin lib/puppet/face/certificate_request.rb
puppet-4.8.1 lib/puppet/face/certificate_request.rb
puppet-4.8.1-x86-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.8.1-x64-mingw32 lib/puppet/face/certificate_request.rb
puppet-4.8.1-universal-darwin lib/puppet/face/certificate_request.rb
puppet-4.8.0 lib/puppet/face/certificate_request.rb
puppet-4.8.0-x86-mingw32 lib/puppet/face/certificate_request.rb