How to deploy files to service.un.org

Table of Contants

This how-to describes process of getting files from your local PC to service.unece.org using Repositories and Pipelines. Should be reffered to typically when a new version of UN/EDIFACT, UN/LOCODE or other deliverable hosted on service.unece.org is produced and needs to be published.

Diagram

Simplified diagram of the whole process:

Resources

Repository Web interface

• UNECE Bitbucket - https://bitbucket.unece.org
• Trade Repositories - https://bitbucket.unece.org/projects/TRADE
  • UN/CEFACT (BRS, CCL, Codelists, Recommendations, RSM, XML Schemas, etc. ) - https://bitbucket.unece.org/projects/TRADE/repos/uncefactservice/browse
  • UN/LOCODE - https://bitbucket.unece.org/projects/TRADE/repos/locodeservice/browse
  • UNTDID (UN/EDIFACT) - https://bitbucket.unece.org/projects/TRADE/repos/untdidservice/browse

Repository GUI

• Sourcetree - https://www.sourcetreeapp.com/ or local SourceTreeSetup-2.6.9.exe
• Prerequisit to install Sourcetree is MS .NET Framework 7.4.1
  • Web Installer - https://www.microsoft.com/en-us/download/details.aspx?id=56115 or local NDP471-KB4033344-Web.exe
  • Offline Installer - https://www.microsoft.com/en-us/download/details.aspx?id=56116

Pipeline Web interface

• UNECE Bamboo - https://bamboo.unece.org
• Trade Pipelines - https://bamboo.unece.org/browse/TRADE
  • UN/CEFACT Pipeline - https://bamboo.unece.org/browse/TRADE-SU2
  • UN/LOCODE Pipeline - https://bamboo.unece.org/browse/TRADE-SL
  • UNTDID (UN/EDIFACT) Pipeline - https://bamboo.unece.org/browse/TRADE-SU

Working with Git

Official Sourcetree documentation

• Install Sourcetree https://confluence.atlassian.com/get-started-with-sourcetree/install-sourcetree-847359094.html
• Connect your Bitbucket or Github account https://confluence.atlassian.com/get-started-with-sourcetree/connect-your-bitbucket-or-github-account-847359096.html
• Clone a remote repository https://confluence.atlassian.com/get-started-with-sourcetree/clone-a-remote-repository-847359098.html
• Commit and push a change (Git) https://confluence.atlassian.com/get-started-with-sourcetree/commit-and-push-a-change-git-847359114.html
• Pull changes from a remote repository (Git) https://confluence.atlassian.com/get-started-with-sourcetree/pull-changes-from-a-remote-repository-git-847359111.html

Step-by-step guide

Installing and Configuring tools

Sourcetree Initial configuration 

• Download and install Sourcetree, if needed install also MS .NET Framework 7.4.1, as this requires Administrator privilegies, ask ISU for assistance
• After Installation run Sourcetree application

• As part of initial execution, configure Sourcetree - useraccount and tools

  1. Login to remote Repository 
     1. 
  2. Authenticate user (using Windows / Active Directory credentials)
     1. 
  3. If Credentials are correct, you should see confirmation
     1. 
  4. Select modules for installation (we need only Git)
     1. 
  5. Module installation - progress
     1. 
  6. Module installation - confirmation
     1. 
  7. SSH key configuration (can be skipped)
     1. 

Cloning Repository

• After Initial setup we configure and clone repositories
  
  1. Add a new repository
     1. 
  2. On remote server, click "Clone in SourceTree" for easy configuration, or click on "Clone" and copy repository link (for Git repositories the link ends with .git)
     1. 
  3. Review Cloning configuration, select local folder where files shoud be stored
     1. 
  4. Run Clone and wait for process to finish
     1. 
     2. 
     3. 

Making a change in files

• Local repo without a change (local repo in sync with the remote repo)

• Local repo in windows explorer
• New files (selected) to be transferred to local repo in windows explorer
• Transfer to local repo running
• We have a new files (we updated the current files) in our local repo (this is considedred as a change, another type of change is adding and removing files/folders) 
  1. New files in local repo - file status
  2. New files in local repo - Commit Log
  3. Diff - one line change example
  4. Diff - new lines example
  5. Diff - Line change example (- removed, + added)
  6. Files Staged
  7. Adding commit message
  8. Commit user info
  9. Adding mail
  10. Commit is linked to user account
  11. After commit - back in sync a Push is available
  12. After commit - Log - Push prepared
  13. Push branch selection
  14. Push running
  15. Push completed
  16. Bitbucket - Remote repo - Commits
  17. Bitbucket - Remote repo - Sources

Running Pipelines

• Go to Trade Division pipelines - https://bamboo.unece.org/browse/TRADE
  

  1. Select desired Pipeline (in our case, as we are deploying new LOCODE Directory version - Service LOCODE)

  2. Select job (plan) to run

From Local Repository to Stage

1. Deploy to Stage - start

2. Deploy to Stage - running

3. Deploy to Stage - completed

4. Changes appear on Stage for validation (service-qa.unece.org) 

   1. Page
   2. Source

From Stage to Prod

1. Deploy to production - run option 1
2. Deploy to production - run option 2
3. Deploy to production - running
4. Deploy to production - completed
5. Changes appear on Production (service.unece.org)
6. Changes appear on Production (service.unece.org) - source view
7. Link files to Production

86 this section

Prerequisities

Step-by-step guide

Related articles