Skip to content

Commit 0a48924

Browse files
authored
Merge pull request #6224 from helio/docs-feature-flags
📖 document setting feature flags for tilt dev env
2 parents 71526b2 + 822719d commit 0a48924

File tree

2 files changed

+17
-1
lines changed

2 files changed

+17
-1
lines changed

docs/book/src/developer/testing.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -216,6 +216,15 @@ The e2e tests also create a local clusterctl repository. After it has been creat
216216
skipped by setting `-e2e.cluster-config=<ARTIFACTS>/repository/clusterctl-config.yaml`. This also works with a clusterctl repository created
217217
via [Create the local repository](http://localhost:3000/clusterctl/developers.html#create-the-local-repository).
218218

219+
**Feature gates**: E2E tests often use features which need to be enabled first. Make sure to enable the feature gates in the tilt settings file:
220+
```yaml
221+
kustomize_substitutions:
222+
CLUSTER_TOPOLOGY: "true"
223+
EXP_MACHINE_POOL: "true"
224+
EXP_CLUSTER_RESOURCE_SET: "true"
225+
EXP_KUBEADM_BOOTSTRAP_FORMAT_IGNITION: "true"
226+
```
227+
219228
</aside>
220229
221230
### Running specific tests

docs/book/src/developer/tilt.md

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,14 @@ documentation](https://docs.tilt.dev/api.html#api.default_registry) for more det
7070
for more details.
7171

7272
**kustomize_substitutions** (Map{String: String}, default={}): An optional map of substitutions for `${}`-style placeholders in the
73-
provider's yaml.
73+
provider's yaml. **Note**: It's recommended to enable the following feature flags for local dev environment to ensure e2e tests run through:
74+
```yaml
75+
kustomize_substitutions:
76+
CLUSTER_TOPOLOGY: "true"
77+
EXP_MACHINE_POOL: "true"
78+
EXP_CLUSTER_RESOURCE_SET: "true"
79+
EXP_KUBEADM_BOOTSTRAP_FORMAT_IGNITION: "true"
80+
```
7481

7582
**deploy_observability** ([string], default=[]): If set, installs on the dev cluster one of more observability
7683
tools. Supported values are `grafana`, `loki`, `promtail` and/or `prometheus` (Note: the UI for `grafana` and `prometheus` will be accessible via a link in the tilt console).

0 commit comments

Comments
 (0)