Skip to content

Commit

Permalink
Fix formatting for Sonobuoy config docs
Browse files Browse the repository at this point in the history
  • Loading branch information
zubron committed May 25, 2020
1 parent e1a28d2 commit ac26e99
Showing 1 changed file with 45 additions and 55 deletions.
100 changes: 45 additions & 55 deletions site/docs/master/sonobuoy-config.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,85 +12,75 @@ and you will see the default configuration. Below is a description of each of th

## General options

Description
- A string which provides consumers a way to add extra context to a configuration that may be in memory or saved to disk. Unused by Sonobuoy itself.
Description: A string which provides consumers a way to add extra context to a configuration that may be in memory or saved to disk. Unused by Sonobuoy itself.

UUID
- A unique identifier used to identify the run of this configuration. Used in a few places including the name of the results file.
UUID: A unique identifier used to identify the run of this configuration. Used in a few places including the name of the results file.

Namespace
- The namespace in which to run Sonobuoy.
Namespace: The namespace in which to run Sonobuoy.

WorkerImage
- The image for the Sonobuoy worker container which runs as a sidecar along the plugins. Responsible for reporting results back to the Sonobuoy aggregator.
WorkerImage: The image for the Sonobuoy worker container which runs as a sidecar along the plugins. Responsible for reporting results back to the Sonobuoy aggregator.

ImagePullPolicy
- The image pull policy to set on the Sonobuoy worker sidecars as well as each of the plugins.
ImagePullPolicy: The image pull policy to set on the Sonobuoy worker sidecars as well as each of the plugins.

ResultsDir
- The location on the Sonobuoy aggregator where the results are placed.
ResultsDir: The location on the Sonobuoy aggregator where the results are placed.

Version
- The version of Sonobuoy which created the configuration file.
Version: The version of Sonobuoy which created the configuration file.


## Plugin options

Plugins
- An array of plugin selection objects of the plugins you want to run. When running custom plugins (or avoiding running a particular plugin) this value needs modified.
Plugins: An array of plugin selection objects of the plugins you want to run. When running custom plugins (or avoiding running a particular plugin) this value needs modified.

PluginSearchPath
- The aggregator pod looks for plugin configurations in these locations. You shouldn't need to edit this unless you are doing development work on the aggregator itself.
PluginSearchPath: The aggregator pod looks for plugin configurations in these locations. You shouldn't need to edit this unless you are doing development work on the aggregator itself.

## Query options

Resources
- A list of resources which Sonobuoy will query for in every namespace in which it runs queries. In the namespace in which Sonobuoy is running, PodLogs, Events, and HorizontalPodAutoscalers are also added.

Filters
- Namespace
- A regexp which specifies which namespaces to run queries against.
- LabelSelector
- A Kubernetes [label selector][labelselector] which will be added to every query run.

Limits
- Options for limiting the scope of response.
- **Limits.PodLogs** limits the scope when getting logs from pods. The supported parameters are:
- **Namespaces**: string
- A regular expression for the targeted namespaces.
- Default is empty string
- To get logs from all namespaces use ".*"
- **SonobuoyNamespace**: bool
- If set to true, get pod logs from the namespace Sonobuoy is running in. Can be set along with a `Namespaces` field or on its own.
- Default value is true
- **FieldSelectors**: []string
- A list of field selectors, with OR logic.
- For example, to get logs from two specified namespaces
Resources: A list of resources which Sonobuoy will query for in every namespace in which it runs queries. In the namespace in which Sonobuoy is running, PodLogs, Events, and HorizontalPodAutoscalers are also added.

Filters:

* Namespace: A regexp which specifies which namespaces to run queries against.

* LabelSelector: A Kubernetes [label selector][labelselector] which will be added to every query run.

Limits: Options for limiting the scope of response.

* **Limits.PodLogs** limits the scope when getting logs from pods. The supported parameters are:
* **Namespaces**: string
* A regular expression for the targeted namespaces
* Default is empty string
* To get logs from all namespaces use ".*"
* **SonobuoyNamespace**: bool
* If set to true, get pod logs from the namespace Sonobuoy is running in. Can be set along with a `Namespaces` field or on its own.
* Default value is true
* **FieldSelectors**: []string
* A list of field selectors, with OR logic
* For example, to get logs from two specified namespaces
`FieldSelectors = ["metadata.namespace=default","metadata.namespace=heptio-sonobuoy"]`
- Each field selector contains one or more chained operators, with AND logic
- For example, to get logs from a specified pod
* Each field selector contains one or more chained operators, with AND logic
* For example, to get logs from a specified pod
`FieldSelectors = ["metadata.namespace=default,metadata.name=pod1"]`
- Each field selector follows the same format as
* Each field selector follows the same format as
`k8s.io/apimachinery/pkg/apis/meta/v1/types/ListOptions/FieldSelector`
- Can be set along with a Namespaces/SonobuoyNamespace field or on its own.
- **LabelSelector**: string
- Filtering candidate pods by their labels
- Using the same format as
* **LabelSelector**: string
* Filtering candidate pods by their labels
* Using the same format as
`k8s.io/apimachinery/pkg/apis/meta/v1/types/ListOptions/LabelSelector`
- For example:
* For example:
`LabelSelector = "app=nginx,layer in (frontend, backend)"`
- When set together with other fields, the scope of pods is defined by:
* When set together with other fields, the scope of pods is defined by:
```
(Namespaces OR SonobuoyNamespace OR FieldSelectors) AND LabelSelector
```
- For each candidate pod, the format and size of logs is defined by other fields. These will be passed onto Kubernetes [PodLogOptions][podlogopts]
- Previous: bool
- SinceSeconds: int
- SinceTime: string. RFC3339 format.
- Timestamps: bool
- TailLines: int
- LimitBytes: int
* For each candidate pod, the format and size of logs is defined by other fields. These will be passed onto Kubernetes [PodLogOptions][podlogopts]
* Previous: bool
* SinceSeconds: int
* SinceTime: string. RFC3339 format.
* Timestamps: bool
* TailLines: int
* LimitBytes: int
Expand Down

0 comments on commit ac26e99

Please sign in to comment.