Go Live Steps

Note:

Certain steps are skippable; as such, they are not mentioned in the Tl;dr version. Reference the detailed steps to see them.

Tl;dr

Jira

  •  For New or Existing Projects
    1.  Create a ticket for the project / requested changes for a project
    2.  Move ticket from "Backlog" to "In Progress" workflow stage
    3.  When done, notify customer / Move ticket to "Under Review"
    4.  Log work & add a closing comment with pertinent details (e.g. go-live approved by name/date/time etc.)


Stash

  •  For New Projects:
    1.  Create a new repository in FNF project
    2.  Clone repository to local (using Sourcetree)
    3.  Add the nitro file from Leap TEST environment
    4.  Commit and push to master branch,
    5.  Create a tag and notify Jason Card  for it to be released to PROD
  •  For Existing Projects:
    •  Do Steps 3 - 5, above


Confluence

  •  For New Projects:
    1.  Add a project requirements page
    2.  Add all the pertinent information related to this project
    3.  When ready to go live, update the Document Properties box and and any other sections as necessary
  •  For Existing Projects:
    1.  Update the project's requirements page
      1.  Update the "Post Production Enhancement List" section
    2.  After the changes have gone live:
      1.  Add release date to the "Post Production Enhancement List" section


Customer Notification

  •  For New or Existing Projects: 
    1.  Copy links for Form(s) and View Responses page from Leap PROD environment
    2.  Notify customer/team that the latest changes have gone live and provide the links




Note:

Skippable steps are indicated by "(Optional)". You may choose to skip these steps, depending on your work-style — Use your best judgement!

  •  The steps outlined for Jira, Stash, and Confluence SDLC tools are not in a strict order
    •  Example: Do Jira Step 4 after Step 6 etc.
  •  Even the SDLC tools can be done in an order that suits your work style
    •  Example: Doing confluence steps first documenting the customer request, and then Stash, and finally Jira, etc.

Jira


Tip

It is prudent to do these steps throughout  the life-cycle of the ticket (vs. doing them when closing the ticket), as it helps with accurately logging the work / time spent / updates from the customer with respect to changes in the scope of (intial) requested changes etc,


For New or Existing Projects

Step #Description
1

If new project:

  •  Create a ticket in Jira for the project if one does not exist


If existing project:

  •  Create a ticket in Jira for the requested changes to a project


2

(Optional) Log the estimated effort


3

If the ticket is in the "Backlog", move it to "In Progress" when you start working on the changes


4

(Optional) If existing project:

  • Link to the Project's parent ticket (v1.0) and provide a comment as to why you are linking to it...

FYI

I usually do a "relates to" linking between Parent and post go-live enhancements

5

(Optional) As you progress, through the requested change(s)—

a. Add comments as necessary

b. Log work / time spent

6

(Optional) If scope change occurs (i.e. additional changes are requested by the customer), you may create a Smart Checklist. Markdown syntax is used for adding items and it is pretty simple and straight-forward.

Note

Normally, the proper way to handle scope change would be to create sub-tasks — i.e. child tickets.

However, for FEB tickets it has been recommended to not do sub-tasks (as it "messes-up" (or was it "fudges" Thinking Face on Google Android 10.0 March 2020 Feature Drop) the reporting of Michael Oatley )

7

When all requested changes are complete, notify customer and move the ticket into "Under Review" workflow stage


8

Upon receiving confirmation from the customer that all changes have been tested, verified, and confirmed, provide the following details in comments:

a. Who approved the go-live and when.

i. (Optional) Attach the confirmation email from customer to the comments

b. Log work / time spent



Stash

Brand New Project

Step #Description
1

Login to stash: https://stash.uconn.edu/


2

Navigate to FEB Nitro Files (FNF) project


3

Provided you have the necessary privileges, click on the "Create repository" button, top-right


4

Provide an appropriate name and then click on the "Create repository" button


5

 Clone repository to local — this is your local repository

Tip

Establish clean directory structure for all your Leap apps; directory within this structure is where you will create a local repository 

a. Create a project directory for this Leap application

b. Use git/bash command:

Make sure you are inside the project folder of where you want to clone and then execute the following command:

Clone Remote Repository
git clone REPOSITORY_URL



6

Open up Sourcetree software


7
 Add a new repository, by clicking on the "+" at the top:



a. Click on Add at the top:



b. Click on "Browse"



c. Navigate to where you cloned locally (Step 5.a., above)

d. And click on "Select Folder" — DO NOT click on the .git folder... merely ensure that the folder you select has a .git folder (this is a hidden folder — so you might not see it, based on your settings), as shown below



e. Finally, click "Add"





8

Go to Leap TEST environment and export the project (if you have not done it already) and save it locally

Heads-up!

Unless you have been told otherwise: Make sure that the "Include submission data?" checkbox is  not checked!

9

Locate the *.nitro_s file that you downloaded from Leap TEST environment and move it to the directory of your project's local repository (same folder as 5.a., above)


10

 Sourcetree automatically detects a change in your local repository; it's time to stage your project's nitro file — Reference the screenshot below for steps 10.a & 10.b:

a. Your project's nitro file will be listed under "Unstaged files" section

b. Click on


Note:

You should only see your project's nitro file... if you see more than one file, reach out to our Leap group and troubleshoot as to why that is the case

11
 Select "File Status" tab (if it is not selected)
12

 Committing to remote repository — Reference the screenshot below for steps 12.a — 12.c:
 


a. Under comments, use the following format — the first comment line & its format is mandatory!

JIRA XXX-###
YOUR COMMENTS

(where XXX-### is the Jira ticket; you can provide your comments after that)

Tip

If you have a prior commit, you may click on the  icon and select an applicable comment. If you select a comment from history, be sure to change the ticket number (and the comment, if applicable)!

b. Click on

c. Click on the  button

13
Create a tag

 a. Click on "master" under "BRANCHES" on the left; notice that middle pane



 b. Right-click on the commit that you did in (Step 12, above) and select "Tag..."



c. In the resulting dialog box, under "Add Tag" tab

i. Provide a name for the tag (this convention should work: "NAME_OF_REPO_v#.#", where #.# is your version number e.g. 1.0, 1.1, etc.)

ii. Select/check the  checkbox

iii. Click the  button


14

 Notify Jason Card that the tag "TAG_NAME" (from #13.c.i) has been created and it's ready to go live.


Here's my notification template... feel free to use it, if it helps!

Note:

Change the  [PLACEHOLDERS] and in order to ensure the accuracy: the verbiage, as necessary!


TemplateExample

[SALUTATION]


At your earliest convenience / release-to-prod window, please release the following tag to PROD.

[MyTagName_v#.#]

Details:

The new set of changes requested by  [DEPARTMENT_NAME] for their  [LEAP_APPLICATION_NAME] form have been addressed.

It has gone through UAT and the customer has confirmed & approved the changes and has requested for it to go live!

All Confluence, Jira, & Stash steps have been completed.


[CLOSING/SIGNATURE]

Hello Jason,

At your earliest convenience / release-to-prod window, please release the following tag to PROD.

TaxAndCompliance-ForeignNationalInformation_v1.1

Details:

The new set of changes requested by the Tax and Compliance Department for their Foreign National Information form have been addressed.

It has gone through UAT and the customer has confirmed & approved the changes and has requested for it to go live!

All Confluence, Jira, & Stash steps have been completed.

Best,

Rush

Existing Project

Step #Description
1

On local machine, navigate to the project's directory where you have established your local repository

Note:

You should only see the .git folder and the previously exported nitro file:

2Delete the nitro_s file from this directory
3Continue from Step 8 of "Brand New Project"


Confluence

For a Project's Initial Release

Step #Description
1

If the project requirements page does not have a Pre Go-Live Log section, add it:

Pre Go-Live Log

Go-Live DateDate of Last Deploy in TESTCustomer/Designee Sign-off & Date/TimeVersionDeveloperJIRA TicketRelease to PROD Date/TimeReleased By





@DEVELOPER NAME

  • JavaScript files: using minified versions?
  • Confirm Security/Access Control (as reflected on THIS page)
  • Update Jira Ticket
  • Stash component
  • Queued for Go-Live! / Notify Jason Card
  • Update project's requirements page on Confluence
  • Notify customer/team post deployment with relevant link(s)











2Follow/go through the developer's checklist, as listed within the Pre Go-Live Log
3

Update the  Document Properties  box

  • "Document Status" should state PRODUCTION
4

If you have done detailed documentation for your project, add a link to it right after the Document Properties box by:

a. Adding an Info macro, with the following verbiage

This is a high-level requirements document ONLY. If you are maintaining this application, are performing a maintenance, or just interested in the details, please reference the detailed documentation.

b. Format the text as: Heading 2

c. Add a link back to the high-level requirements document on your detailed documentation page, with the following verbiage

This is a detailed documentation for this project. If you would like to get a birds-eye view (Tl;dr) version, please reference the high-level documentation.

d. Optional: if you have Table of Contents (ToC) macro on either the Detailed Documentation page or the High-Level Requirements Document page, edit the ToC macro and add the following RegEx so that it is excluded from it:

This is a detailed.*
High-Level Requirements PageDetailed Documentation Page


5

Update any other details as necessary

6

Verify & confirm the accuracy of:

  • User Interaction & Design Diagram
  • Security / Access Control

For a Project's Subsequent Releases

Step #Description
1

Update the "Post Production Enhancement List" section—

a. List the enhancements made at a high level

i. (Optional) Provide a link to detailed documentation page where these enhancements are captured in detail

b. Add customer name with Day/Date/Time of when it was approved to go live

i. (Optional) Include the confirmation email

c. Link the Jira issue

d. Provide information for the other columns, which are self-explanatory


Tip

You may start adding information to the Post Production Enhancement List log, from the day you receive a request for changes from the customer, and then update the log over time...

I do this myself and shown below are several screenshots of this log over time...







Customer Notification

Step #Description
1

Login into Leap PROD environment: https://hclleap-prod2.its.uconn.edu/apps/login/org/index.html


2

Search for your project


3

Copy PROD links:

a. Click on "Launch" and copy the link from the resulting page

b. Click on "View Responses" and copy the link from the resulting page


Note:

Click on the down arrow for "Launch", if your project has multiple forms, in order to copy each form's links

4

Notify customer/team that the latest changes have gone live and provide the links


Here's my notification template... feel free to use it, if it helps!

Note:

Change the  [PLACEHOLDERS] and in order to ensure the accuracy: the verbiage, as necessary!


TemplateExample

[SALUTATION]


The form has gone live and here are the two links, as promised:

  1.  Live form:  [FORM_LINK]
  2.  View Responses: [VIEW_RESPONSES_LINK]

If you have any questions or if I can be of further assistance, please do not hesitate to reach out.

[CLOSING/SIGNATURE]

Good afternoon [Name],

The form has gone live and here are the two links, as promised:

  1.  Live form: [FORM_LINK]
  2.  View Responses: [VIEW_RESPONSES_LINK]

If you have any questions or if I can be of further assistance, please do not hesitate to reach out.

Best,
Rush