Skip to main content

4 min read

How to implement a Staging to Production process in Jira

How to implement a Staging to Production process in Jira

The Learn for Jira team is committed to helping Jira users get more from their product. We're releasing a series of tips, tricks and insights to shine a light on the kinds of information you'll find in Learn for Jira training modules. Today, we're showing you how to use Project Configurator to implement a Staging to Production process in Jira.

Making configuration changes to a Jira environment is not always simple, and can even be a risky undertaking. If you make a change and something goes wrong, then you can quickly find yourself with a lot of unhappy Jira users. Promoting configuration changes from staging to production doesn’t have to be a difficult process, however. The Learn for Jira team is sharing their know-how from a course explaining exactly that! Read on for a full overview on why and how staging to production is so important.

Reduce risk by using a Staging to Production process

To avoid unsettling your Jira environment - and your users - it’s highly recommended you first test any Jira configuration changes you plan to make in a test or Staging Jira environment. As a result, you can check they will work as planned and not crash your system. 

There is, however, a drawback to this approach. Your efforts are doubled as you need to make the changes twice, first in a Development environment before making the same changes again in your live Production Jira instance. This can be done manually but if you are making a significant number of changes a lot of your time can be eaten up. In addition, it’s very easy to miss something or make an error when repeating the changes for a second time. 

Project Configurator for Jira: giving you the best of both worlds 

With Project Configurator for Jira you can test your configuration changes in your Development environment before easily implementing them in Production. Crucially, by using Project Configurator you can copy these changes across to your Production environment significantly quicker and with a reduced chance of errors. 

It's not uncommon for Jira Admins to be making configuration changes on a daily basis, therefore the accumulated time savings can be huge. With this repeatable, reliable and streamlined process in place, you can rest easy knowing your Jira configuration changes are not going to crash or break your live Production Jira instance. Plus it won't have taken you all day!

Discover how to get started using Project Configurator with our course from Learn for Jira

Learn for Jira’s Project Configurator course will teach you how to implement a staging to production process in Jira, along with showing you everything else you need to know about this powerful tool. Here’s an introduction:

Did you know?

Jira Data Center users can also use Project Configurator for their Staging to Production process, often with even greater benefits. This is because the chances are your Jira will have more ‘moving parts’ in need of regular updates or alterations, increasing the volume and frequency of these changes.

4 simple steps to get started from the Learn for Jira team

1. Set up your second Jira instance

To implement this process you’ll need at least two instances of Jira. The first should be  your main Production instance - this is the one all your users will interact with on a daily basis. The second is a Testing or Staging instance. An optional third environment can be used if you want an additional Testing environment in which to perform testing, perhaps one you would give access to regular Jira users to experiment with. 

Did you know?

You can get your (additional) Jira instance for free! If you have a commercial and academic server license (not available for cloud or server starter products), then you are also entitled to additional test or Development Jira licenses. This guide by Atlassian will help you access these licenses

With your additional licenses, you can set up your Staging and/or Testing Jira environments. For detailed information on how to do this please see this guide from Atlassian.

2. Use Project Configurator to streamline the Staging to Production process

Once you have this architecture in place you can begin making changes in Staging. To “promote” (also known as “copy”), these changes across to your live Production instance, you’ll need to install Project Configurator on both of these Jira instances. Don't worry though, you only need a commercial license for the Production instance. 

Install Project Configurator

3. Start promoting changes into Production

You’re now ready to begin promoting changes between Staging and Production. To see how this process works in action take a look at this demo video.

Pro tip from Learn for Jira:

For those looking for a more comprehensive process for recording changes: It is possible to retain the details of any imports performed with Project Configurator. Use the 'Download' button on the final import screen to download a record of the import.

Configuration only import results.
Configuration only import results.

This allows Jira Admins to treat Jira configuration ‘as code’. ‘Configuration as code’ is a concept that letsAdmins store a record of configuration changes in a similar fashion that a software developer would store their code edits in a Version Control System (VCS), such as Atlassian’s Bitbucket. This extra step is great for storing backups, for rolling back changes, or for auditing purposes.

4. Take your knowledge further with Learn for Jira

Learn for Jira provides accessible, easy-to-understand training on Project Configurator and generally on Jira user and admin techniques for all levels. Upskill your team with unlimited, up-to-date training designed and created  by Jira experts. Read our blog for more reasons why you should choose Learn for Jira. If you're ready to get started, you can try out Learn for Jira for free here, or read more about our Atlassian Training solutions.

We also suggest reading through this step-by-step guide to help you with your first Staging to Production configuration promotion using Project Configurator.

View Documentation Guide

As always, if you run into any problems using Project Configurator while implementing this process, please reach out to us via our support portal and one of the team will help you out.