Jenkins on StackOS
Jenkins app deployment from the StackOS AppStore.
Jenkins is a tool used by developers to automate various processes.
We will show how a basic setup can fail, how to discover the failure, and how to fix the failure.

References

Docker Hub
docker/README.md at master · jenkinsci/docker
GitHub

✅ First Launch

Use this image: jenkins/jenkins:lts-jdk11

✅ Initial Setup Results

After your initial setup you will be presented with a URL such as:

✅ Seeing your first failure

Navigate to the provided URL to see the following message
1
no healthy upstream
Copied!

✅ Checking Failure

Open a WebTTY and list your pod statuses
You will see that your Jenkins pod is flagged with "CrashLoopBackOff"
This indicates your pod is crashing

✅ Determine Nature of Crash

Use the WebTTY to show the pod logs. In some cases you will see something, in other cases you will not. It depends on the method used to set up the docker image.
kubectl logs jenkins-0xYourEthAddress
We have now determined our persistent data is owned by the wrong user. This is common if the pod is running as a user other than root. Determine the owner of the directory, set the ownership properly, and restart.

✅ Determining Owner

We now know the user/group should be 1000 / 1000 respectively.

✅ Changing Ownership

We use a dummy container image to make an easy shell and change ownership of the data directory
Temporarily set your pod image to "nginx:latest" and Update your Application
Shell into your pod
kubectl exec -ti jenkins-0xYourEthAddress-Random -- bash
Change the ownership of the persistent data directory
chmod 1000:1000 /var/jenkins_home
Verify the new ownership
1
# ls -al /var/jenkins_home
2
total 28
3
drwxr-xr-x 3 1000 1000 4096 Mar 18 13:29 .
4
drwxr-xr-x 1 root root 4096 Mar 18 13:45 ..
5
drwx------ 2 root root 16384 Mar 18 13:29 lost+found
Copied!
Change the image back to jenkins/jenkins:lts-jdk11

✅ Success

Jenkins is now running!

✅ Obtain your setup password

1
kubectl exec jenkins-0xYourEthAddress-random more /var/jenkins_home/secrets/initialAdminPassword
2
Copied!
Fill in the password
Proceed through the installation steps. We recommend you take the basic route the first time to get familiar before doing more complex setups.
Your site is now ready: