Uploaded image for project: 'IGB'
  1. IGB
  2. IGBF-1764

On-boarding: Step 2 - fork IGB team repository and set up bitbucket pipelines to build installers

    Details

    • Type: Task
    • Status: Closed (View Workflow)
    • Priority: Blocker
    • Resolution: Done
    • Affects Version/s: None
    • Fix Version/s: None
    • Labels:
    • Story Points:
      2
    • Sprint:
      Fall 5 : 14 Oct to 25 Oct, Fall 6 : 28 Oct to 8 Nov, Spring 9 : 25 May to 8 Jun, Summer 3: 6 Jul - 17 Jul, Summer 4: 14 Jul - 28 Jul, Summer 6: 17 Aug - 28 Aug, Summer 7: 31 Aug - 11 Sep, Winter 4 Feb 8 - Feb 19, Winter 5 Feb 22 - Mar 5, Spring 4 2021 May 3 - May 14, Summer 1 2023 May 15, Summer 2 2023 May 29, Fall 3 2023 Oct 2, Spring 5

      Description

      Read modules 2 and 3 the on-line course "Open source programming with IGB."

      Following the instructions, fork the IGB repository and configure your fork to build IGB platform-specific installers.

      To build IGB installers:

      • Log in to bitbucket using your bitbucket user account.
      • Check your account has been added to the Developers group by confirming that you can open and see private (as denoted by a "padlock" icon) IGB project repositories and their files under
        https://bitbucket.org/account/user/lorainelab/projects/IGB
      • Look for the installers private content repository. Follow the instructions there to create repository variables required to build installers.
      • Next, trigger the master branch pipeline. (See Canvas course module Building IGB for how to do this.)
      • Check that files master.dmg, master-32bit.exe, master.exe, master.sh, and master.jar got copied to the Downloads section of your fork.

      If you do not see the installers, click the Pipelines button to review any error messages. The main problems people have when using pipelines are:

      • You need to run the branch pipeline “branches: IGBF-* ” on Bitbucket to create installers, rather than the “default” pipeline which creates the IGB jar file.
      • Something has gone wrong with the Loraine Lab maven repository which hosts dependencies (jar files) needed for building IGB. Check that https://nexus.bioviz.org is available.
      • Your user account does not have access to the installer private content repository. Make sure that you can see the files in the private repository when logged in to bitbucket.
      • Your repository environment variables are not configured properly. Review the installer private contents repository again to make sure all repository environment variables are properly defined.
      • Your account has run out of Bitbucket pipeline minutes. Create a new bitbucket account using an "edu" domain to get more minutes.
      • Double-check that your Bitbucket username is correct by selecting Settings > Personal Bitbucket settings > Account settings > Username.

      Finally, add a new comment with a link to your fork and move this ticket to Needs First Level Review.

      Reviewers should check that:

      • This ticket has a comment with a link to the developer's fork
      • The master branch installers are present in the fork's Downloads section
      • When you view the commit history on the developer's fork, Jira IGBF issue hyperlinks are present.

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                ann.loraine Ann Loraine
              • Votes:
                0 Vote for this issue
                Watchers:
                12 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: