[{"_1":2,"_154":-5,"_155":-5},"loaderData",{"_3":4,"_13":14,"_21":22,"_133":134},"root",{"_5":-5,"_6":-7,"_7":8,"_9":-7,"_10":11,"_12":-7},"currentUser","primaryEmail","siteVerification","6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI","toast","enableDev",false,"incidentStatus","routes/_layout",{"_15":-5,"_16":17,"_18":17,"_19":11,"_20":11},"username","isAskGordonEnabled",true,"isUsingNewTemplate","showMinimalLanding","showHoneypotTrap","routes/_layout.r.$namespace.$reponame",{"_23":24,"_25":-5,"_26":11,"_27":11,"_28":29,"_30":31,"_32":-5,"_33":11,"_34":35,"_83":-5,"_84":85,"_124":-5,"_125":11,"_126":17,"_127":11,"_128":-5,"_129":11,"_130":-5,"_131":132},"canonicalUrl","https://hub.docker.com/r/kedubuis/jenkins/tags","mcpServer","canSeeDockerfile","canSeeAutobuilds","namespace","kedubuis","reponame","jenkins","cloudBuildSource","isAutobuildsAvailable","repo",{"_36":37,"_38":39,"_41":42,"_43":31,"_44":11,"_45":46,"_47":48,"_49":50,"_52":31,"_28":29,"_53":54,"_55":40,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":29,"_68":69,"_74":11,"_75":76,"_80":29,"_81":82},"categories",[],"content_types",[40],"image","date_registered","2019-04-25T21:15:03.431551Z","description","is_private","last_updated","2019-04-25T21:19:52.968673Z","last_modified","2024-10-16T13:48:34.145251Z","media_types",[51],"application/vnd.docker.container.image.v1+json","name","pull_count",260,"repository_type","star_count",0,"status",1,"status_description","active","source","collaborator_count","full_description","# Jenkins on Azure Web App for Containers\n\nA Docker solution for Jenkins on Azure App Service for Containers. \n\nJenkins is a self-contained, open source automation server which can be used \nto automate all sorts of tasks related to building, testing, and delivering \nor deploying software.\n\n- [Overview](#overview)\n- [Base image](#base-image)\n- [SSH support](#ssh-support)\n- [Persistent Files](#persistent-files)\n- [Gotchas](#gotchas)\n- [References](#references)\n\n\n## Overview\n\nWith the general availability of Azure Web App for Containers in 2017, \nSNP undertook an initiative to port a variety of applications running in\nLinux VM's to Docker containers running in the new App Service for Linux. \nOur Jenkins workload is one such application.\n\nGenerally speaking, one can run just about any Docker, Linux container in\nAzure Web App for Containers. We describe below considertions we took into account\nfor this Jenkins solution.\n\n\n## Base image\n\nWe use the official Jenkins Docker image available on Docker Hub:\nhttps://hub.docker.com/r/jenkins/jenkins.\n\n`FROM jenkins/jenkins:lts`\n\nThis is a fully functional [Jenkins instance](https://jenkins.io/).\n\n\n## SSH support\n\nSSH enables secure communication between a container and a client. \nIn order for a custom Docker image in Azure Web App for Containers to support SSH, \nyou must build it into a Dockerfile. You enable SSH in the Docker file itself.\n\nIn the context of Web App for Containers, SSH is necessary to install the Jenkins UI.\n\nFor this purpose we followed [instructions in the Microsoft documentation](https://docs.microsoft.com/en-us/azure/app-service/containers/tutorial-custom-docker-image#connect-to-web-app-for-containers-using-ssh).\n\nThe customization include:\n\n* Several lines added to our Dockerfile\n```\nRUN apt-get update -y\nRUN apt-get install openssh-server -y\nRUN echo \"root:Docker!\" | chpasswd \\\n && echo \"cd /home\" >> /etc/bash.bashrc\n\nCOPY sshd_config /etc/ssh/\n...\nEXPOSE 2222\n```\n\n* A `sshd_config` file copied to `/etc/ssh/`\n* `service ssh start` command in the entrypoint shell script `jenkins.sh`\n\n\n## Persistent Files\n\nIn order to persist Jenkins data, we utilize the Web App's /home directory that is mounted \nto Azure File Storage (see NOTE below). \n\nTo make our Azure data persistent, we install Jenkins in `/home/jenkins_home`. \nIn the Dockerfile, the relevant lines are:\n```\nRUN mkdir -p /home/jenkins_home\nENV JENKINS_HOME /home/jenkins_home\n```\nNOTE: By default, the Web App for Containers platform mounts an SMB share \nto the /home/ directory. You can do that by setting the \n`WEBSITES_ENABLE_APP_SERVICE_STORAGE` app setting to \"true\" in the Application settings \nblade of the Web App.\n\nIMPORTANT: Manually create the `jenkins_home` directory in the Web App `/home` directory \n_before_ you run the container and install Jenkins. This can be done from the Kudu Bash screen \nor from an FTPS session.\n\n\n## Gotchas\n\nAt the \"Create First Admin User\" step of the Jenkins installation process (Figure 1), you may be shown the message \n'No valid crumb was included in the request'. Bypass this issue by clicking the \"Continue as admin\" link \ninstead of the \"Save and Continue\" button (Figure 2). \n\nOnce in Jenkins:\n\n1. You may see an error message that reads, \"It appears that your reverse proxy set up is broken.\" (Figure 3) \nGo to the \"Configure System\" screen (/configure), scroll down to the Jenkins UTL setting, append port 8080 to the \nURL - e.g. https://mysitename.azurewebsites.net:8080 (Figure 4) , click Apply, then click Save.\n\n2. Next, Go to the \"Configure Global Security\" screen (/configureSecurity), scroll down to the \"Prevent Cross Site Require Forgery exploits\"\nsection, enable \"Enable proxy compatibility\", click Apply, then click Save (Figure 5).\n\n3. Now you can update the admin user configuration at /user/admin/configure.\n\n**Figure 1**\n\n![Create admin error](/images/jenkins-create-admin-error.jpg)\n\n**Figure 2**\n\n![Continue](/images/jenkins-continue.jpg)\n\n**Figure 3**\n\n![Reverse proxy is broken](images/jenkins-reverse-proxy-broken.jpg)\n\n**Figure 4**\n\n![Append port 8080](images/jenkins-url-port.jpg)\n\n**Figure 5**\n\n![Enable proxy compatibility](images/jenkins-proxy.jpg)\n\n\n## References\n\n1. [Docker Hub official repository for Jenkins](https://hub.docker.com/r/jenkins/jenkins)\n2. [GitHub site for the repository image code](https://github.com/jenkinsci/docker)\n3. [Connect to Web App for Containers using SSH](https://docs.microsoft.com/en-us/azure/app-service/containers/tutorial-custom-docker-image#connect-to-web-app-for-containers-using-ssh)\n4. [SSH support for Azure App Service on Linux](https://docs.microsoft.com/en-us/azure/app-service/containers/app-service-linux-ssh-support)\n5. [Understanding the Azure App Service file system](https://github.com/projectkudu/kudu/wiki/Understanding-the-Azure-App-Service-file-system)\n6. [Azure App Service on Linux FAQ](https://docs.microsoft.com/en-us/azure/app-service/containers/app-service-linux-faq)\n7. [Administering Jenkins](https://wiki.jenkins.io/display/JENKINS/Administering+Jenkins)\n","has_starred","hub_user","immutable_tags_settings",{"_70":11,"_71":72},"enabled","rules",[73],".*","is_automated","permissions",{"_77":17,"_78":11,"_79":11},"read","write","admin","user","storage_size",343924437,"orgData","recentTags",[86],{"_87":40,"_88":89,"_90":91,"_92":93,"_94":95,"_45":113,"_114":89,"_115":29,"_116":51,"_52":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},"content_type","creator",3217328,"full_size",343903456,"id",53805871,"images",[96],{"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":91,"_58":61,"_112":-5},"architecture","amd64","digest","sha256:3f77d17ba893eb85f46fc2f4fdcdd2ad414055a5a6a31a593d6076d39a85adad","features","","last_pulled","2026-09-21T02:23:34.591680308Z","last_pushed","2019-04-25T21:19:53Z","os","linux","os_features","os_version","size","variant","2019-04-25T21:19:52.588829Z","last_updater","last_updater_username","media_type","latest","repository",7030273,"tag_last_pulled","tag_last_pushed","tag_status","v2","sbxKitMetadata","isPotentialSpam","isHubSbxKitsEnabled","showSbxLogoOverride","sbxTrademarkText","displaySecurityMetadata","tagAttestations","tagsHaveAttestations",[],"routes/_layout.r.$namespace.$reponame.tags",{"_34":135,"_142":143,"_131":152,"_153":11},{"_36":136,"_38":137,"_41":42,"_43":31,"_44":11,"_45":46,"_47":48,"_49":138,"_52":31,"_28":29,"_53":54,"_55":40,"_56":57,"_58":59,"_60":61,"_62":-5,"_63":57,"_64":65,"_66":11,"_67":29,"_68":139,"_74":11,"_75":141,"_80":29,"_81":82},[],[40],[51],{"_70":11,"_71":140},[73],{"_77":17,"_78":11,"_79":11},"tags",{"_144":59,"_145":-5,"_146":-5,"_147":148},"count","next","previous","results",[149],{"_87":40,"_88":89,"_90":91,"_92":93,"_94":150,"_45":113,"_114":89,"_115":29,"_116":51,"_52":117,"_118":119,"_120":104,"_121":113,"_122":61,"_123":17},[151],{"_97":98,"_99":100,"_101":102,"_103":104,"_105":106,"_107":108,"_109":102,"_110":-5,"_111":91,"_58":61,"_112":-5},[],"canDeleteTags","actionData","errors"]

kedubuis/jenkins

Tags for kedubuis/jenkins