OpenShift-Examples/Debug-In-OpenShift/README.md

How to debug issues in OpenShift

Context

Lets say that you deployed an application in OpenShift and the application is not working. You would like to debug but the application does not embed any troubleshooting tool (for instance, an Alpine Linux or a scratch image)

Two approaches are possible:

• download statically compiled tools in the /tmp of the container
• add a side-car container with the required tools

Static tools

You could download one of the static tools available there in /tmp and run it from there.

Sidecar container

For instance, if you need to troubleshoot network issues:

Deploy our boggus application

oc new-app --name boggus alpine:latest
oc patch dc boggus --type=json -p '[{"op": "add", "path": "/spec/template/spec/containers/0/command", "value": ["/bin/sh", "-c", "while :; do sleep 1; done" ]}]'

Add a sidecar container that has the tools to debug network issues

oc patch dc boggus --type=json -p '[{"op": "add", "path": "/spec/template/spec/containers/1", "value": { "image": "szalek/pentest-tools", "name": "debug", "command": [ "/bin/sh", "-c", "while :; do sleep 1; done" ]} }]'

Enter the sidecar container

oc rsh -c debug $(oc get pods -l app=boggus -o name|tail -n 1)

For strace, it is a bit more complicated since you will have access to the host PID namespace.

Give privileged rights to the default service account

oc adm policy add-scc-to-user privileged -z default

Add a sidecar container that has strace

oc patch dc boggus --type=json -p '[{"op": "add", "path": "/spec/template/spec/containers/1", "value": { "image": "benhall/strace-ubuntu", "name": "debug", "command": [ "/bin/sh", "-c", "while :; do sleep 1; done" ], "securityContext": { "privileged": true } } }, {"op": "add", "path": "/spec/template/spec/hostPID", "value": true } ]'

Enter the sidecar container

oc rsh -c debug $(oc get pods -l app=boggus -o name|tail -n 1)

In the container, try:

ps ax

and then:

strace -ff -p <pid>

Debug a Build Job

Let's say that a Java build is failing and you need to troubleshoot the issue. For the record, let's pretend it's a Java build based on maven. For instance, you are trying to build openshift-tasks application.

Spawn a persistent Build Pod and get a shell on this pod:

oc new-app --name java-debug redhat-openjdk18-openshift:1.2
oc patch dc java-debug --type=json -p '[{"op": "add", "path": "/spec/template/spec/containers/0/command", "value": ["/bin/sh", "-c", "while :; do sleep 1; done" ]}]'
oc get pods
oc rsh $(oc get pods -l app=java-debug -o name|tail -n 1)

Since the Maven has been installed in the container using the Software Collections, you will need to enable this environment with:

scl -l
scl enable rh-maven33 /bin/bash

The source code is usually fetched using GIT but from another container. So, to fetch the source code to build, you can do a git clone and pack it from another machine or if you are using GitHub, you can directly fetch a ZIP:

curl -Lo /tmp/src.zip https://github.com/lbroudoux/openshift-tasks/zipball/eap-7

Unpack it:

mkdir -p /tmp/src
cd /tmp/src
unzip /tmp/src.zip

And then, replicate what the S2I build is doing:

cd lbroudoux-openshift-tasks-d745675
/usr/local/s2i/assemble