| <!doctype html> |
| <html class="no-js" lang="en" dir="ltr"> |
| <head> |
| <meta charset="utf-8"> |
| <meta http-equiv="x-ua-compatible" content="ie=edge"> |
| <meta name="viewport" content="width=device-width, initial-scale=1.0"> |
| <title>Application upgrades policy and workflow - Apache Infrastructure Website</title> |
| <link href="/css/bootstrap.min.css" rel="stylesheet"> |
| <link href="/css/fontawesome.all.min.css" rel="stylesheet"> |
| <link href="/css/headerlink.css" rel="stylesheet"> |
| <script src="/highlight/highlight.min.js"></script> </head> |
| <body class="d-flex flex-column h-100"> |
| <main class="flex-shrink-0"> |
| <div> |
| |
| <!-- nav bar --> |
| <nav class="navbar navbar-expand-lg navbar-dark bg-dark" aria-label="Fifth navbar example"> |
| <div class="container-fluid"> |
| <a class="navbar-brand" href="/"><img src="/images/feather.png" style="height: 32px;"/> Apache Infrastructure</a> |
| <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarADP" aria-controls="navbarADP" aria-expanded="false" aria-label="Toggle navigation"> |
| <span class="navbar-toggler-icon"></span> |
| </button> |
| |
| <div class="collapse navbar-collapse" id="navbarADP"> |
| <ul class="navbar-nav me-auto mb-2 mb-lg-0"> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">About</a> |
| <ul class="dropdown-menu"> |
| <li><a class="dropdown-item" href="/team.html">About the team</a></li> |
| <li><a class="dropdown-item" href="/roundtable.html">The Infrastructure Roundtable</a></li> |
| <li><a class="dropdown-item" href="/blog/">The Infrastructure Blog</a></li> |
| </ul> |
| </li> |
| <li class="nav-item"> |
| <a class="nav-link" href="/policies.html">Policies</a> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">Services and Tools</a> |
| <ul class="dropdown-menu"> |
| <li><a class="dropdown-item" href="/services.html">Services and Tools</a></li> |
| <li><a class="dropdown-item" href="/machines.html">Machines and Fingerprints</a></li> |
| <li><a class="dropdown-item" href="https://blocky.apache.org/">Blocky</a></li> |
| <li><a class="dropdown-item" href="https://app.datadoghq.com/account/login?next=%2Finfrastructure">DataDog</a></li> |
| <li><a class="dropdown-item" href="https://whimsy.apache.org/roster/committer/" target="_blank">Committer Search</a></li> |
| </ul> |
| </li> |
| <li class="nav-item dropdown"> |
| <a class="nav-link dropdown-toggle" href="#" data-bs-toggle="dropdown" aria-expanded="false">Documentation</a> |
| <ul class="dropdown-menu"> |
| <li><a class="dropdown-item" href="/doc.html">Contribute</a></li> |
| <li><a class="dropdown-item" href="/infra-volunteer.html">Volunteer with Infra</a></li> |
| <li><a class="dropdown-item" href="/how-to-mirror.html">Become an ASF download mirror</a></li> |
| <li><a class="dropdown-item" href="/hosting-external-agent.html">Host a Jenkins or Buildbot agent</a></li> |
| |
| </ul> |
| </li> |
| <li class="nav-item"> |
| <a class="nav-link" href="/stats.html">Status</a> |
| </li> |
| <li class="nav-item"> |
| <a class="nav-link" href="/contact.html">Contact Us</a> |
| </li> |
| </ul> |
| </div> |
| </div> |
| </nav> |
| |
| |
| <!-- page contents --> |
| <div id="contents"> |
| <div class="bg-white p-5 rounded"> |
| <div class="col-sm-8 mx-auto"> |
| <h1> |
| Application upgrades policy and workflow |
| </h1> |
| <p>This policy encompasses Infra's approach to upgrades of Jenkins, Confluence and Jira and their respective plugins.</p> |
| <h1>Upgrades</h1> |
| <h3>Jenkins</h3> |
| <p><strong>Main Jenkins instance</strong> |
| <em>Upgrades once a quarter</em></p> |
| <p>Infra follows the <a href="https://jenkins.io/download/lts/" target="_blank">LTS line of releases</a>, which the Jenkins Project releases on a 12 week cycle. Once every three months, on the last Saturday or Sunday of the month following the Jenkins LTS release, ASF Infra upgrades the main instance. </p> |
| <p><strong>Jenkins plugins</strong> |
| <em>Upgrades once a month</em></p> |
| <p>We upgrade all plugins (there are more than 200!) before and after the main instance upgrade, as appropriate, and at the end of each month when there is no main instance upgrade to perform.</p> |
| <h3>Jira</h3> |
| <p><strong>Main Jira instance</strong> |
| <em>Upgrades every six months</em></p> |
| <p>Jira gets a new release every two to six weeks, far too often (and unpredictable) for us to upgrade every release they make. Infra upgrades our Jira instance to whatever the latest release is every six months.</p> |
| <p><strong>Jira plugins</strong> |
| <em>Upgrades every two months</em></p> |
| <p>We upgrade Jira plugins before or after each main instance upgrade, as appropriate, and once every two months between main instance upgrades. </p> |
| <h3>Confluence</h3> |
| <p><strong>Main Confluence instance</strong> |
| <em>Upgrades every six months</em></p> |
| <p>Our goal is to upgrade Confluence to the latest version twice a year.</p> |
| <p><strong>Confluence plugins</strong> |
| <em>Upgrades every two months</em> </p> |
| <p>Every two months we perform upgrades to plugins that are compatible with the version of the main Confluence instance we are running.</p> |
| <h1>Documentation</h1> |
| <p>Infra documents what we upgraded and when, from what version to what version, on these pages:</p> |
| <ul> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Jenkins+Upgrades" target="_blank">Jenkins upgrades</a></li> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Jenkins+Plugin+Upgrades" target="_blank">Jenkins plugin upgrades</a></li> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Jira+Upgrades" target="_blank">Jira upgrades</a></li> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Jira+Plugin+Upgrades" target="_blank">Jira plugin upgrades</a></li> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Confluence+Upgrades" target="_blank">Confluence upgrades</a></li> |
| <li><a href="https://cwiki.apache.org/confluence/display/INFRA/Confluence+Plugin+Upgrades" target="_blank">Confluence plugin upgrades</a></li> |
| </ul> |
| <h1>Notifications</h1> |
| <p>Since Jenkins, Jira and Confluence are <strong>Core Services</strong>, Infra issues a notice of a planned upgrade at least 72 hours ahead of the event on the wiki or a web page and by emails to the <code>builds@apache.org</code> and <code>users@infra.apache.org</code> mailing lists. We add a Twitter notification by <code>ASF Infrabot</code> one hour before upgrades begin.</p> |
| <h1>In case of emergencies</h1> |
| <p>Occasionally things go wrong with a main or plugin upgrade, and security issues may arise. If we determine that there is an issue, we will work on it immediately until we resolve it. We will send an email to the relevant list and a notice on X (the former Twitter) about any unexpected downtime.</p> |
| </div> |
| </div> |
| </div> |
| <!-- footer --> |
| <div class="row"> |
| <div class="large-12 medium-12 columns"> |
| <p style="font-style: italic; font-size: 0.8rem; text-align: center;"> |
| Copyright 2024, <a href="https://www.apache.org/">The Apache Software Foundation</a>, Licensed under the <a href="https://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.<br/> |
| Apache® and the Apache feather logo are trademarks of The Apache Software Foundation... |
| </p> |
| </div> |
| </div> |
| <script type="application/ecmascript" src="/js/bootstrap.bundle.min.js" integrity="sha384-OERcA2EqjJCMA+/3y+gxIOqMEjwtxJY7qPCqsdltbNJuaOe923+mo//f6V8Qbsw3"></script> </div> |
| </main> |
| <script>hljs.initHighlightingOnLoad();</script> |
| </body> |
| </html> |
