You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/vendor/preflight-defining.mdx
+20-4Lines changed: 20 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -50,7 +50,7 @@ To add a preflight spec to a release for your application:
50
50
For the complete list of available collectors and analyzers, see the [Collect](https://troubleshoot.sh/docs/collect/all/) and [Analyze](https://troubleshoot.sh/docs/analyze/) sections in the Troubleshoot documentation.
51
51
52
52
:::note
53
-
The [clusterInfo](https://troubleshoot.sh/docs/collect/cluster-info/) and [clusterResources](https://troubleshoot.sh/docs/collect/cluster-resources/) collectors are included automatically to gather information about the cluster and cluster resources. You do not need manually include the `clusterInfo` or `clusterResources` collectors in the specification.
53
+
Troubleshoot automatically includes the [clusterInfo](https://troubleshoot.sh/docs/collect/cluster-info/) and [clusterResources](https://troubleshoot.sh/docs/collect/cluster-resources/) collectors to gather information about the cluster and cluster resources. You do not need to manually include the `clusterInfo` or `clusterResources` collectors in the specification.
54
54
55
55
To use only the `clusterInfo` and `clusterResources` collectors, delete the `spec.collectors` key from the preflight spec.
56
56
:::
@@ -67,14 +67,30 @@ To add a preflight spec to a release for your application:
67
67
68
68
## (Optional) Block installation with required (strict) preflights {#strict}
69
69
70
-
For applications installed with a Replicated installer (Embedded Cluster, KOTS, kURL), you can set any preflight analyzer to `strict: true`. When `strict: true` is set, any `fail` outcomes for the analyzer block the deployment of the release.
70
+
For applications installed with a Replicated installer (Embedded Cluster, KOTS, kURL), you can set any preflight analyzer to `strict: true`. When you set `strict: true`, any `fail` outcomes for the analyzer block the deployment of the release.
71
71
72
72
:::note
73
-
Strict preflight analyzers are ignored if the `exclude` property is also included and evaluates to `true`. See [exclude](https://troubleshoot.sh/docs/analyze/#exclude) in the Troubleshoot documentation.
73
+
Troubleshoot ignores strict preflight analyzers if the `exclude` property is also included and evaluates to `true`. See [exclude](https://troubleshoot.sh/docs/analyze/#exclude) in the Troubleshoot documentation.
74
74
:::
75
75
76
-
The following image shows how a `fail` outcome is displayed when `strict: true` is set on an analyzer, which prevents installation from continuing if the preflight check fails:
76
+
The following image shows how a `fail` outcome appears when you set `strict: true` on an analyzer, which prevents installation from continuing if the preflight check fails:
77
77
78
78

79
79
80
80
[View a larger version of this image](/images/preflight-mysql-fail-strict.png)
81
+
82
+
## Add a preflight spec for non-Helm applications or installations with KOTS v1.100.3 and earlier
83
+
84
+
For non-Helm applications or KOTS v1.100.3 and earlier, add the following SupportBundle custom resource at the root level of your release:
Copy file name to clipboardExpand all lines: docs/vendor/support-bundle-customizing.mdx
+22-8Lines changed: 22 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,8 +2,6 @@
2
2
3
3
This topic describes how to add a default support bundle spec to a release for your application. It also describes how to customize the default support bundle spec based on your application's needs. For more information about support bundles, see [About Preflight Checks and Support Bundles](/vendor/preflight-support-bundle-about).
4
4
5
-
The information in this topic applies to Helm applications and Kubernetes manifest-based application installed with Helm or with Replicated KOTS.
6
-
7
5
## Add the default support bundle spec to a release
8
6
9
7
When you add an empty support bundle spec to your Helm chart, the spec automatically includes the [clusterInfo](https://troubleshoot.sh/docs/collect/cluster-info/) and [clusterResources](https://troubleshoot.sh/docs/collect/cluster-resources/) collectors by default. You do not need manually include these collectors in the spec.
@@ -13,7 +11,7 @@ To add the default support bundle spec to a release for your application:
13
11
1. In your Helm chart `templates` directory, create a YAML file. Name the file `support-bundle.yaml` or similar.
14
12
15
13
:::note
16
-
If your application is deployed as multiple Helm charts, Replicated recommends that you create separate support bundle specs for each subchart. This allows you to make specs that are specific to different components of your application. When a support bundle is generated, all the specs are combined to provide a single bundle.
14
+
If you deploy your application as multiple Helm charts, Replicated recommends that you create separate support bundle specs for each subchart. This allows you to make specs that are specific to different components of your application. When Replicated generates a support bundle, it combines all the specs into a single bundle.
17
15
:::
18
16
19
17
1. In the YAML file, add the following to create a Kubernetes Secret with the default support bundle spec:
@@ -41,7 +39,7 @@ To add the default support bundle spec to a release for your application:
41
39
42
40
1. (Recommended) Customize the default spec by adding more collectors and analyzers or editing the default collectors. See [Customize the default support bundle spec](#customize-the-spec) on this page.
43
41
44
-
1. If your application is deployed as multiple subcharts, repeat the previous steps to add a support bundle spec to the templates directory of each chart.
42
+
1. If you deploy your application as multiple subcharts, repeat the previous steps to add a support bundle spec to the templates directory of each chart.
45
43
46
44
1. Test the support bundle by following the instructions in [Generating a Support Bundle](/vendor/support-bundle-generating).
47
45
@@ -89,14 +87,14 @@ To add collectors and analyzers:
89
87
- [postgresql](https://troubleshoot.sh/docs/analyze/postgresql/), [mysql](https://troubleshoot.sh/docs/analyze/mysql/), and [redis](https://troubleshoot.sh/docs/analyze/redis/)
90
88
91
89
:::note
92
-
Good analyzers clearly identify failure modes and provide troubleshooting guidance for the user. For example, if you can identify a log message from your database component that indicates a problem, you should write an analyzer that checks for that log and provides a description of the error to the user.
90
+
Good analyzers clearly identify failure modes and provide troubleshooting guidance for the user. For example, if you can identify a log message that indicates a problem in your database component, write an analyzer to check for that log. Include a description of the error for the user.
93
91
:::
94
92
95
93
### Customize the default `clusterResources` collector
96
94
97
95
You can edit the default [`clusterResources`](https://troubleshoot.sh/docs/collect/cluster-resources/) using the following properties:
98
96
99
-
* `namespaces`: The list of namespaces where the resources and information is collected. If the `namespaces` key is not specified, then the `clusterResources` collector defaults to collecting information from all namespaces. The `default` namespace cannot be removed, but you can specify additional namespaces.
97
+
* `namespaces`: The list of namespaces from which to collect resources and information. If the `namespaces` key is not specified, then the `clusterResources` collector defaults to collecting information from all namespaces. You cannot remove the `default` namespace, but you can specify additional namespaces.
100
98
101
99
* `ignoreRBAC`: When true, the `clusterResources` collector does not check for RBAC authorization before collecting resource information from each namespace. This is useful when your cluster uses authorization webhooks that do not support SelfSubjectRuleReviews. Defaults to false.
102
100
@@ -135,9 +133,9 @@ For more information, see [Namespace](/reference/template-functions-static-conte
135
133
136
134
### Exclude the default collectors
137
135
138
-
Although Replicated recommends including the default `clusterInfo` and `clusterResources` collectors because they collect a large amount of data to help with installation and debugging, you can optionally exclude them.
136
+
Replicated recommends including the default `clusterInfo` and `clusterResources` collectors because they collect a large amount of data for installation and debugging. However, you can exclude them.
139
137
140
-
The following example shows how to exclude both the clusterInfo and clusterResources collectors from your support bundle spec:
138
+
The following example shows how to exclude both the `clusterInfo` and `clusterResources` collectors from your support bundle spec:
141
139
142
140
```yaml
143
141
spec:
@@ -147,3 +145,19 @@ spec:
147
145
- clusterResources:
148
146
exclude: true
149
147
```
148
+
149
+
## Add a support bundle spec for non-Helm applications or installations with KOTS v1.94.1 and earlier
150
+
151
+
For non-Helm applications or KOTS v1.94.1 and earlier, add the following SupportBundle custom resource at the root level of your release:
0 commit comments