Streamlining Workflows with Puppet Faces

PUPPET FACESStreamlining Workflows

Kelsey Hightower

AgendaFirst World Problems

Puppet Faces

Familiar Faces

A New Face

Core Components

puppet dashboard

Puppet DashboardVisualize Your Infrastructure: Status, Graphs, and Reports

External Node Classifier (ENC)

Puppet DashboardVisualize Your Infrastructure: Status, Graphs, and Reports

External Node Classifier (ENC)

manage parameters, groups and classes

First World Problems

First World ProblemsOne key/value pair at a time

Time consuming

First World ProblemsOne key/value pair at a time

Time consuming

Managing ENC data in dashboard could be better

First World Problems

First World ProblemsClick Chrome icon

Click on Puppet Dashboard bookmark

Click on each system

Click edit

Click add new parameter

Click edit

Click save

Click edit

Click save

Click on each group

Click edit

Click save

Click on each group

Click edit

Click save

Click on each group

Click edit

Click some more.

Lots of clicking!!

Puppet?

parameters: node: - "el6.puppetize.me": "domain": "puppetize.me"

group: - "webservers": "apache_version": "2.2.16"

puppet cool-subcommand import data.yaml

Puppet Faces

What are Puppet Faces?

What are Puppet Faces?API for extending existing Puppet functionality

API for creating Puppet subcommands and actions

Familiar Facescatalog

certificate

certificate_request

config

report

resource

status

catalog

catalogpuppet catalog select puppet.testing.org package

Package[openssh-server]

catalog

puppet catalog download

puppet catalog select puppet.testing.org package

catalog

notice: Saved catalog for puppet.testing.org to yaml

catalog

puppet catalog apply

catalog

puppet catalog apply

notice: Finished catalog run in 0.39 seconds"#<Puppet::Transaction::Report:0x98eafcc>"

config

configpuppet config print server --mode agent

puppet.testing.org

puppet config print all --mode agent

puppet.testing.org

puppet config print all --mode agent

allow_duplicate_certs = falsearchive_file_server = puppet.testing.orgarchive_files = falseasync_storeconfigs = falseauthconfig = /etc/puppet/namespaceauth.confautoflush = falseautosign = /etc/puppet/autosign.confbindaddress = ""bucketdir = /var/lib/puppet/bucket...

certificate

certificatepuppet certificate find puppet.testing.org --ca-location=remote

resource

resourcepuppet resource package telnet ensure=present

notice: /Package[telnet]/ensure: created

resourcepuppet resource package telnet ensure=present

notice: /Package[telnet]/ensure: created

package { 'telnet': ensure => '0.17-36',}

dashboard face

dashboard

dashboardQuery Puppet Dashboard

Import/Export data

Programming Motherfu*ker

Project LayoutLICENSE

README

lib/puppet/application/dashboard.rb

lib/puppet/face/dashboard.rb

lib/puppet/face/dashboard/*.rb

Core Componentsapplication

options

arguments

actions

Only limited by your imagination.

Dragon Face

puppet dashboard import data.yaml

application

Applicationcopyright

license

summary

description

short_description

action

Application Class

require 'puppet/face'require 'puppet/application/face_base'

class Puppet::Application::Dashboard < Puppet::Application::FaceBaseend

dashboard-puppet-face/lib/puppet/application/dashboard.rb

Application Class

require 'puppet/face'require 'puppet/application/face_base'

class Puppet::Application::Dashboard < Puppet::Application::FaceBaseend

dashboard-puppet-face/lib/puppet/application/dashboard.rb

inherit FaceBase

Applicationpuppet-dashboard-face/lib/puppet/face/dashboard.rb

require 'puppet'require 'puppet/face'

Puppet::Face.define(:dashboard, '0.0.1') do summary "Puppet Dashboard Integration" copyright "Kelsey Hightower", 2011 license "Apache 2 license" description "Puppet Dashboard Integration"end

subcommand

api version

puppet dashboard import data.yaml\--adapter=mysql --host=127.0.0.1

options

Optionsadapter

username

password

database

Optionspuppet-dashboard-face/lib/puppet/face/dashboard.rb

Puppet::Face.define(:dashboard, '0.0.1') do ... option "--adapter ADAPTER" do summary "Active Record database adapter" description <<-'EOT' The adapter for to use when accessing the Puppet Dashboard database. EOT end ...end

Optionspuppet-dashboard-face/lib/puppet/face/dashboard.rb

Puppet::Face.define(:dashboard, '0.0.1') do ... option "--adapter ADAPTER" do summary "Active Record database adapter" description <<-'EOT' The adapter for to use when accessing the Puppet Dashboard database. EOT end ...end

define options

arguments

ArgumentsFaces can accept positional arguments

Argumentspuppet-dashboard-face/lib/puppet/face/dashboard/import.rb

Puppet::Face.define(:dashboard, '0.0.1') do action :import do summary "Import ENC paramters" arguments "<data>" description <<-'EOT' Bulk import external nodes configuration data into dashboard EOT endend

action

Actionssummary

arguments

returns

description

examples

when_invoked

when_rendering

Actionspuppet-dashboard-face/lib/puppet/face/dashboard/import.rb

Puppet::Face.define(:dashboard, '0.0.1') do action :import do summary "Import ENC paramters" arguments "<data>" description <<-'EOT' Bulk import external nodes configuration data into dashboard EOT

when_invoked do |data, options| ... end endend

Action

when_invoked do |data, options| ... end endend This is where the

works gets done.

Almost ready to solve this problem.

Deploying our Face

Deployment

Deploymentrsync -av puppet-dashboard-face/lib/puppet/ \/opt/ruby/lib/ruby/gems/1.8/gems/puppet-2.7.3/lib/puppet/

sending incremental file list./application/application/dashboard.rbface/face/dashboard.rbface/dashboard/face/dashboard/import.rbface/dashboard/list.rbface/dashboard/models.rbface/dashboard/report.rbface/dashboard/search.rb

sent 9069 bytes received 160 bytes 18458.00 bytes/sectotal size is 8546 speedup is 0.93

Deployment

Deploymentpuppet help

Usage: puppet <subcommand> [options] <action> [options]

Available subcommands, from Puppet Faces: catalog Compile, save, view, and convert catalogs. facts Retrieve and store facts. help Display Puppet help. dashboard Puppet Dashboard Integration. man Display Puppet manual pages. node View and manage node definitions. parser Interact directly with the parser.

Helppuppet help dashboard

USAGE: puppet dashboard <action> [--host HOST] ...

Interact with Puppet Dashboard

OPTIONS: ... --adapter ADAPTER - Active Record Database Adapter --host HOST - Database Hostname

ACTIONS: import Import data into Puppet Dashboard.

See 'puppet man dashboard' or 'man puppet-dashboard' for full help.

Read The Face Manual

Read The Face Manualpuppet man dashboard

PUPPET-DASHBOARD(8) Puppet Manual PUPPET-DASHBOARD(8)

NAME puppet-dashboard - Interact with Puppet Dashboard

SYNOPSIS puppet dashboard action [--adapter ADAPTER] [--database DATBASE] [--username USER] [--password PASSWORD] [--host HOST]

OPTIONS Note that any configuration parameter that's valid in the configuration file is also a valid long argument, although it may or may not be rele- vant to the present action. For example, server is a valid configuration parameter, so you can specify --server <servername> as an argument.

Putting it all together

parameters: node: - "master.lab.org": "domain": "puppetize.me"

group: - "webservers": "apache_version": "2.2.16"

Problem solved!

Better for the environment

75% less batteries

Why Puppet Faces?

Consolidation

Consolidation/usr/sbin/dashboard_importer

/usr/sbin/dashboard_importer.bak

/usr/sbin/dashboardImporter

/usr/sbin/dashboard_importer.new

puppet dashboard importer

Free Documentationpuppet man dashboard

puppet help dashboard

Free Ruby API

Free Ruby APIirb

irb> require 'rubygems'

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'irb> arguments = '/tmp/data.yaml'

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'irb> arguments = '/tmp/data.yaml'irb> options = {:adapter => 'mysql', :password => ..

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'irb> arguments = '/tmp/data.yaml'irb> options = {:adapter => 'mysql', :password => ..irb> dashboard = Puppet::Face[:dashboard,'0.0.1']

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'irb> arguments = '/tmp/data.yaml'irb> options = {:adapter => 'mysql', :password => ..irb> dashboard = Puppet::Face[:dashboard,'0.0.1']irb> dashboard.import(arguments, options)

Free Ruby APIirb

irb> require 'rubygems'irb> require 'puppet/face'irb> arguments = '/tmp/data.yaml'irb> options = {:adapter => 'mysql', :password => ..irb> dashboard = Puppet::Face[:dashboard,'0.0.1']irb> dashboard.import(arguments, options)

puppet dashboard import /tmp/data.yaml --adapter=mysql ...

Good Investment

The FutureReference custom parameters from puppet.conf

Expose Faces to external REST API

khightower/puppet-dashboard-face

github

@kelseyhightowertwitter

puppetize.meweb

Questions?

Streamlining Workflows with Puppet Faces

Technology

Streamlining Content Adoption Workflows: A Report on Content Use

Streamlining Your Chromatography Laboratory Operations Through End-to-End Workflows

Puppet Dashboard Manual - Agrarixpub.agrarix.net/OpenSource/Puppet/dashboardmanual.pdf · Puppet Dashboard 1.2 Manual This is the manual for Puppet Dashboard 1.2. Overview Puppet

E&L: Streamlining LC/MS and GC/MS Workflows - agilent.com · E&L: Streamlining LC/MS and GC/MS Workflows Smriti Khera, Ph.D. Pharma Segment Manager Smriti_khera@Agilent.com 1 For

Webinar Etiquette - HTHU · Florida Updates & Webinar Closing - Evelyn Leadbetter, MPA, Network ... consultative expertise involves streamlining practice operations workflows, HIT

State of Puppet - Puppet Camp Austin

APEX SPECIFICATION 0415 MEDIA & DEVICE IFE …...• Enabling content providers to deliver to IFE using established profiles, for example, in IMF and CMAF. • Streamlining IFE workflows

Streamlining Processes and Workflows for Better Business ...€¦ · Workflows for Better Business Practices Greg Fowler, ERPA, QPA, APA, AIF® National Benefit Services, LLC. 10/8/2015

Creating beautiful puppet modules with puppet-lint

Rule IT. · IT Asset Management Inventory License Management Asset Management Software Management ... making IT planning use your time wisely by streamlining workflows with and management

Streamlining the Client's Workflows (in Joomla)

Streamlining acquisition workflows through collaboration

State of Puppet 2013 - Puppet Camp DC

Puppet Camp New York 2014: Streamlining Puppet Development Workflow

UltiMate 3000 Standard HPLC Systems Brochure€¦ · Streamlining All Chromatography Workflows Intelligent Chromatography Software Chromeleon 7 is the next-generation chromatography

Streamlining Financial Modeling - MATLAB & Simulink · Streamlining Financial Modelling: From Development to Approval to Production with MATLAB David Sampson MathWorks. 2 Workflows

Puppet Keynote: Puppet Camp London

Puppet Camp Dallas 2014: Puppet Keynote

Collaborative platforms for streamlining workflows in Open Science

new collaboration catalogue 10 · analytics loop by linking up your business tools and streamlining your workflows. Enterprise on-premise version available. Harness the power of collaborative