...
| Section | ||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
ECMWF
...
Bitbucket git repository
ECMWF provide a web interface (called 'stash') to git repositories that hold OpenIFS. This is used to browse the sources, branches and create pull requests. It works much like other web interfaces for git, such as github or bitbucket.
To connect to Stash, go to: https://software.ecmwf.int/stash/ and find the OpenIFS project.
Access to
...
Bitbucket web interface
Access to Stash requires that you can login to the main ECMWF page: http://www.ecmwf.int/. This is normally the case if you have an account on ECMWF systems. Use your normal userid and secureid password.
...
| Info |
|---|
After successfully logging in to the main ECMWF website (www.ecmwf.int), you will probably find you still cannot see the OpenIFS git repository. To be granted access, please contact openifs-support@ecmwf.int. |
Access to git repository
To clone the OpenIFS git repository at your local site requires setting a further password to correctly authenticate with the Stash server.
Make sure you can successfully log in to the main ECMWF website before following the procedure below.
Authentication
The procedure to get a password to download the OpenIFS git repository is:
- Log out from www.ecmwf.int
- Go to https://software.ecmwf.int/issues/login.jsp. Choose "Can't access your account"
- Write your user id.
- Now you should get an email from JIRA offering you a link to reset your JIRA password. Follow this link and type in the new password (it doesn't matter if you don't already have one).
- This password should be available in Stash in some minutes. You can test it in Stash's web interface https://software.ecmwf.int/stash/login as long as you are still logged out from www.ecmwf.int
Cloning and branching
To clone the repository at the remote site follow these steps. This will prompt for your username and the password created as described in the previous section:
...
| Info | ||
|---|---|---|
| ||
Please ensure you checkout the release branch from the repositories for use. These mirror the versions available on the ftp site and will be tested. |
Branching model
OpenIFS has a small number of developers and a small number of releases. In this scenario, a single 'develop' branch with multiple release branches works well. The branching strategy is similar to the "gitflow" model but with modifications for multiple supported releases, which gitflow does not support.
| Gliffy Diagram | ||||
|---|---|---|---|---|
|
Possible problems
git commands return error code 501; cannot clone
This is a problem with the version of git you are using.
Versions of git greater than 1.7.1 are required to work correctly with Atlassian Bitbucket software we use. There is more information on this error provided by Atlassian but note the advice to use version 1.6 is incorrect, and versions of git greater than 1.7.1 must be used.
Getting CAPTCHA problems when trying to login at 'git clone', 'git push' or 'git pull'?
In some situations you may get an error like the following
...
- Log off the ECMWF Single Sign On system www.ecmwf.int
- Log in manually into Stash, filling the CAPTCHA field (you will be asked for it after you try a first time). https://software.ecmwf.int/stash/login
- The password is the same password you use with git, that you can change or recover in JIRA (but do allow some minutes for synchronization from JIRA to Stash
Acknowledgement
Portions of this page written by ECMWF user support: Daniel Santoalla.
...