Skip to content

Commit

Permalink
Istio troubleshooting guide on install fail due to mod resource (#813)
Browse files Browse the repository at this point in the history
* Istio troubleshooting guide for install fail due to mod resource

* Apply suggestions from code review

Co-authored-by: Bartosz Chwila <103247439+barchw@users.noreply.github.com>

* Add step about mutating webhook

* Apply suggestions from code review

Co-authored-by: Natalia Sitko <80401180+nataliasitko@users.noreply.github.com>

* Update docs/user/troubleshooting/03-70-reconciliation-fails-on-istio-install.md

Co-authored-by: Natalia Sitko <80401180+nataliasitko@users.noreply.github.com>

* Update docs/user/troubleshooting/03-70-reconciliation-fails-on-istio-install.md

Co-authored-by: Natalia Sitko <80401180+nataliasitko@users.noreply.github.com>

* Add commands

* Apply suggestions from code review

Co-authored-by: Natalia Sitko <80401180+nataliasitko@users.noreply.github.com>

---------

Co-authored-by: Bartosz Chwila <103247439+barchw@users.noreply.github.com>
Co-authored-by: Natalia Sitko <80401180+nataliasitko@users.noreply.github.com>
  • Loading branch information
3 people authored May 13, 2024
1 parent ce73fd3 commit d627b22
Showing 1 changed file with 25 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Changes to Istio Ingress Gateway Deployment, Istiod Deployment, or Istio CNI DaemonSets Are Not Reverted After Reconciliation

## Symptoms

- The Istio Ingress Gateway Deployment, Istiod Deployment, or Istio CNI DaemonSets fails to start.
- Any of these resources contains a non-default container that is unable to start.
- The Istio custom resource is in the `Error` state.

## Cause

- If an external component, like a mutating webhook, adds a container to the Istio Ingress Gateway Deployment, Istiod Deployment, or Istio CNI DaemonSets, and that new container fails to start for any reason, the Pod is unable to reach the `Running` state. As a result, the Istio module reconciliation fails.

## Remedy

1. Check if a given resource's Pod template has been modified to include an additional container.
2. Check if the newly injected container fails to start.

> [!TIP]
> To retrieve information for the above steps, you can use the command `kubectl describe {RESOURCE_NAME} -n istio-system -o yaml`.
3. If the container is unable to start, remove it from the Pod template of the given resource.

`kubectl edit {RESOURCE_NAME} -n istio-system`

4. If the error persists, check if there is a mutating webhook in the cluster that is modifying Istio resources.

0 comments on commit d627b22

Please sign in to comment.