...
- For new projects:
- Create a new repository in FNF project
- Clone repository to local (using Sourcetree)
- Add the nitro file from Leap TEST environment
- Commit and push to master (from local to remote)branch,
- When committing, include the Jira ticket, by using a string "JIRA <TICKET>" (example: "JIRA FEB-530")
- Create a tag and notify Jason Card mention: the tag name, and request for it to be released into PROD
- For existing projects:
- Do the Steps 2 - 45, above
Confluence
Update the project requirements page, under the FEB space:
- For new projects:
- Update the Document Properties box:
- "Document Status" at the top and other sections (such as Pre Go-Live, etc,) as necessary
- For existing projects:
- Update the "Post Production Enhancement List" section
- "Description" to capture enhancement(s) at high-level; provide a link: if you have a detailed documentation page (where this set of enhancements are captured in detail)
- After receiving confirmation/notification for Stash step #18 #14 (that the tag has been deployed in PROD)
- Update Version (in PROD) property (Document Properties box) with the latest version
...
- Provide the following details in comments: Who approved the go-live and when.
- If possible/you'd like to, attach the email confirmation to the comments
- AFTER completing the Stash steps: Move the ticket from "UNDER REVIEW" to "DONE" column; ensure that the ticket's workflow status is "DONE" and not "CANCELLED"
- Notify Jason Card that the "Tag" has been created (Stash step #18#14)
Stash
...
Brand New Project
Step # | Description |
---|
1 | - Login to stash: https://stash.uconn.edu/
- Navigate Navigate to FEB Nitro Files (FNF) project
- Provided Provided you have the necessary privileges, click on the "Create repository" button, top-right
- Provide Provide an appropriate name and then click on the "Create repository" button
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 |
- Create a project directory for this Leap application
- Use git/bash command:
Make sure you are inside the project folder of where you want to clone and then execute the following command:
Code Block |
---|
language | bash |
---|
theme | RDark |
---|
title | Clone Remote Repository |
---|
linenumbers | true |
---|
| git clone REPOSITORY_URL |
Image Modified
- Open Open up Sourcetree software
- Add Add a new repository, by clicking on the "+" at the top:
- Click Click on Add at the top:
- Click Click on "Browse"
- Navigate Navigate to where you cloned locally (Step 5.a., above)
- And And click on "Select Folder" ---- 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
- Finally Finally, click "Add"
Anchor |
---|
| Continue from here |
---|
| Continue from here |
---|
|
Go to Leap TEST environment and export the project (if you have not done it already) and save it locally Info |
---|
| Unless you have been told otherwise: Make sure that the "Include submission data?" checkbox is not checked! |
- Locate 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)
- Sourcetree will notice
Sourcetree automatically detects a change in the your local repository and list it ; it's time to stage your project's nitro file — Reference the screenshot below for steps 10.a & 10.b:
Image Added
Your project's nitro file will be listed under "Unstaged files" section
Image Removed - Select either "Stage All" or "Stage Selected", depending on your circumstance
- Under comments, follow the following format (without quotes):
"JIRA XXX-### YOUR COMMENTS" " (where XXX is the project key, in Jira and ### is the ticket number
Click on Image Added Info |
---|
| 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 |
Select "File Status" tab (if it is not selected)
Image Added
Committing to remote repository — Reference the screenshot below for steps 12.a — 12.c: Image Added
Under comments, use the following format — the first comment line & its format is mandatory! Code Block |
---|
language | text |
---|
theme | RDark |
---|
linenumbers | true |
---|
| JIRA XXX-###
YOUR COMMENTS |
(where XXX-### is the Jira ticket; you can provide your comments after that)
- Next, make sure you select the "Push changes immediately to..." checkbox
- Finally, hit the "Commit" button.
Example of Steps 9 - 11: Image Removed - Next, create a tag, by clicking
Tip |
---|
| If you have a prior commit, you may click on the Image Added 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)! |
- Click on Image Added
- Click on the Image Added button
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! Info |
---|
| Change the [PLACEHOLDERS] and in order to ensure the accuracy: the verbiage, as necessary! |
Template | Example |
---|
[SALUTATION]
At your earliest convenience / release-to-prod window, please release the following tag to PROD and let me know when it's done. [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 and let me know when it's done.
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 |
|
13 Goes HERE | Create a tag
a. Click on "master" under "BRANCHES" on the left; notice that middle pane
| Image RemovedImage Added b. Right-click on the | blue line Give it an appropriate name; generally, commit that you did in (Step 12, above) and select "Tag..." |
Image Removed
Image Added
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.) | Image RemovedNotify that the tag has been created and it's ready to go live. On ii. Select/check the Image Added checkbox iii. Click the button
Image Added |
14 | 14 GOES HERE |
Anchor |
---|
| existingProject |
---|
| existingProject |
---|
|
Existing Project
Step # | Description |
---|
1 | On local machine, navigate to the project's directory where you have established your local repository Info |
---|
| You should only see the .git folder and the previously exported nitro file: Image Modified |
|
Delete |
2 | Delete the nitro_s file from this directory |
Continue , on the LeftConfluence
Pre Go-Live
If the project requirements page does not have a pre go-live log, add it and follow the Developer checklist. Sample Pre Go-Live log, below.
...