Merge pull request #697 from dmvolod/simplify-configmap-configuration

📖 Simplifying ConfigMap with metadata configuration

docs/book/src/03_topics/02_configuration/01_air-gapped-environtment.md

@@ -167,28 +167,22 @@ For example, you have two files: `components.yaml` and `metadata.yaml`. To creat
 gzip -c components.yaml > components.gz
 ```
 
-2. Create a ConfigMap manifest from the archived data:
+2. Create a ConfigMap in your Kubernetes cluster from the archived data:
 
 ```sh
-kubectl create configmap v1.9.3 --namespace=capz-system --from-file=components=components.gz --from-file=metadata=metadata.yaml --dry-run=client -o yaml > configmap.yaml
+kubectl create configmap v1.9.3 -n capz-system --from-file=components=components.gz --from-file=metadata=metadata.yaml
 ```
 
-3. Edit the file by adding "provider.cluster.x-k8s.io/compressed: true" annotation:
+3. Add "provider.cluster.x-k8s.io/compressed: true" annotation to the ConfigMap:
 
 ```sh
-yq eval -i '.metadata.annotations += {"provider.cluster.x-k8s.io/compressed": "true"}' configmap.yaml
+kubectl annotate configmap v1.9.3 -n capz-system provider.cluster.x-k8s.io/compressed=true
 ```
 
 **Note**: Without this annotation, the operator won't be able to determine if the data is compressed or not.
 
 4. Add labels that will be used to match the ConfigMap in the `fetchConfig` section of the provider:
 
 ```sh
-yq eval -i '.metadata.labels += {"my-label": "label-value"}' configmap.yaml
-```
-
-5. Create the ConfigMap in your Kubernetes cluster using kubectl:
-
-```sh
-kubectl create -f configmap.yaml
+kubectl label configmap v1.9.3 -n capz-system provider-components=azure
 ```

docs/local-development.md

@@ -8,7 +8,7 @@ kind create cluster
 ```
 
 ## Run Tilt
-Once the cluster is live and you've confirmed you're using the correct context, you can simply run:
+Once the cluster is live, and you've confirmed you're using the correct context, you can simply run:
 ```bash
 tilt up
 ```