layout | title | subtitle | canonical |
---|---|---|---|
default |
PE 3.2 » Orchestration » Browsing Resources |
Orchestration: Browsing and Comparing Resources |
/pe/latest/orchestration_resources.html |
Use the live management page's Browse Resources tab to browse the resources on your nodes and inspect their current state.
Note: Resource browsing and comparison are only available in the PE console; there is not a command line interface for these features.
If you need to do simple resource inspections on the command line, you can investigate the
puppetral
plugin'sfind
andsearch
actions. These give output similar to what you can get from runningpuppet resource <type> [<name>]
locally.
Browsing resources requires you to select a node or group of nodes to inspect.
To learn how to navigate the live management page and select/filter nodes, see the Navigating Live Management page of this manual.
The Browse Resources tab contains a resource type navigation list in its left pane. This is used to switch the right pane between several resource type pages (and a summary page, which includes an Inspect All button for pre-caching resource data).
The Browse Resources tab can inspect the following resource types:
For an introduction to resources and types, please see the Resources chapter of Learning Puppet.
The summary view's Inspect All button scans all resources of all types and reports on their similarity. This is mostly useful when you think you've selected a group of very similar nodes but want to make sure.
After clicking Inspect All, the Browse Resources tab will use the lists of resources it got to pre-populate the corresponding lists in each resource type page. This can save you a few clicks on the Find Resources buttons (see below).
Resource type pages contain a search field, a Find Resources button, and (if the Find Resources button has been used) a list of resources labeled with their nodes and number of variants.
To browse resources, you must first select a resource type. You must also have one or more nodes selected.
If you have previously clicked the Inspect All button, the resource type page will be pre-populated; if it is empty, you must click the Find Resources button.
The resource type page will display a list of all resources of that type on the selected nodes, plus a summary of how similar the resources are. An Update button is available for re-scanning your nodes. In general, a set of nodes that perform similar tasks should have very similar resources.
The resource list shows the name of each resource, the number of nodes it was found on, and how many variants of it were found. You can sort the list by any of these properties by clicking the headers.
To inspect a resource, click its name.
To find resources by name, you must first select a resource type. You must also have one or more nodes selected.
The search field on a resource type page is not a standard search field; it only works with the exact name of a resource. Wildcards are not allowed. If you are unsure of the name of the resource you're looking for, you should browse instead.
To search, enter a resource name in the search field and confirm with the enter key or the search button.
Once located, you will be taken directly to the inspect view for that resource. This is the same as the inspect view available when browsing (see below).
When you inspect a resource, you can see the values of all its properties. If there is more than one variant, you can see all of them and the properties that differ across nodes will be highlighted.
To see which nodes have each variant, click the on N nodes labels to expand the node lists.