From 07868b69162e7d5dd805b6442e5b84a7f8fc5855 Mon Sep 17 00:00:00 2001 From: treddy08 Date: Mon, 9 Sep 2024 13:34:39 +1000 Subject: [PATCH] update --- content/modules/ROOT/nav.adoc | 2 ++ content/modules/ROOT/pages/14-troubleshooting.adoc | 14 ++++++++++++++ 2 files changed, 16 insertions(+) create mode 100644 content/modules/ROOT/pages/14-troubleshooting.adoc diff --git a/content/modules/ROOT/nav.adoc b/content/modules/ROOT/nav.adoc index e7c6089..b71cd7f 100644 --- a/content/modules/ROOT/nav.adoc +++ b/content/modules/ROOT/nav.adoc @@ -24,3 +24,5 @@ * xref:13-AI-model-exploration.adoc[13. AI Model Exploration] +* xref:14-troubleshooting.adoc[14. Troubleshooting] + diff --git a/content/modules/ROOT/pages/14-troubleshooting.adoc b/content/modules/ROOT/pages/14-troubleshooting.adoc new file mode 100644 index 0000000..ca5f297 --- /dev/null +++ b/content/modules/ROOT/pages/14-troubleshooting.adoc @@ -0,0 +1,14 @@ +== Troubleshooting + +=== Cluster Sleep/Wake + +When ordering this demo from demo.redhat.com, you cluster will be woken up from a *stopped* state. Once startup is complete, you should wait around a further 15 minutes for the cluster to fully initialize. There are occasions when certain components in the cluster are not initialized in a healthy state and the following issues occur: + +==== Webhook not triggering pipeline run + +You will notice that any source code changes, tagging and releasing will not trigger a pipeline. To confirm this issue, navigate to your software components *xxx-dev* project and go to *Workloads -> Pods* then locate the *event listener* pod with the name *el--el**. If you select the *Logs* tab, you should notice a certificate error while communicating *tekcon-trigger-core-interceptors* service. To fix this issue, switch the project to *openshift-pipelines* and go to *Workloads - Pods*. Find the pod *tekton-triggers-core-interceptors-** and delete it. This action should recreat the pod and should resolve this issue. Attempt to trigger the pipeline again. + +[Important] +==== +If there are no logs in the event listener indicating a certificate issue, this may be caused by a timing issue i.e. you may have triggered your pipeline before the webhook was successfully created. To ensure that the webhook was created, open your software component on Developer Hub and ensure you are on the *Overview* tab. On the bottom right, under *Deployment Summary* confirm that the ArgoCD App *-dev-build* has a *Sync status* of *Synced* and *Health status* of *Healthy* before triggering your pipeline. +==== \ No newline at end of file