Adding submodule help

pull/14021/head
Greg DeKoenigsberg 9 years ago
parent e3a6accc1d
commit b900c104b9

@ -81,27 +81,35 @@ and destination repositories. It will look something like this::
Someuser wants to merge 1 commit into ansible:devel from someuser:feature_branch_name Someuser wants to merge 1 commit into ansible:devel from someuser:feature_branch_name
.. note:: .. note::
It is important that the PR request target be ansible:devel, as we do not accept pull requests into any other branch. It is important that the PR request target be ansible:devel, as we do not accept pull requests into any other branch. Dot releases are cherry-picked manually by ansible staff.
Dot releases are cherry-picked manually by ansible staff.
The username and branch at the end are the important parts, which will be turned into git commands as follows:: The username and branch at the end are the important parts, which will be turned into git commands as follows::
git checkout -b testing_PRXXXX devel git checkout -b testing_PRXXXX devel
git pull https://github.com/someuser/ansible.git feature_branch_name git pull https://github.com/someuser/ansible.git feature_branch_name
The first command creates and switches to a new branch named testing_PRXXXX, where the XXXX is the actual issue number associated The first command creates and switches to a new branch named testing_PRXXXX, where the XXXX is the actual issue number associated with the pull request (for example, 1234). This branch is based on the devel branch. The second command pulls the new code from the users feature branch into the newly created branch.
with the pull request (for example, 1234). This branch is based on the devel branch. The second command pulls the new code from the
users feature branch into the newly created branch.
.. note:: .. note::
If the GitHub user interface shows that the pull request will not merge cleanly, we do not recommend proceeding if you If the GitHub user interface shows that the pull request will not merge cleanly, we do not recommend proceeding if you are not somewhat familiar with git and coding, as you will have to resolve a merge conflict. This is the responsibility of the original pull request contributor.
are not somewhat familiar with git and coding, as you will have to resolve a merge conflict. This is the responsibility of
the original pull request contributor.
.. note:: .. note::
Some users do not create feature branches, which can cause problems when they have multiple, un-related commits in Some users do not create feature branches, which can cause problems when they have multiple, un-related commits in their version of `devel`. If the source looks like `someuser:devel`, make sure there is only one commit listed on the pull request.
their version of `devel`. If the source looks like `someuser:devel`, make sure there is only one commit listed on
the pull request. Finding a Pull Request for Ansible Modules
++++++++++++++++++++++++++++++++++++++++++
Ansible modules are in separate repositories, which are managed as Git submodules. Here's a step by step process for checking out a PR for an Ansible extras module, for instance:
1. git clone https://github.com/ansible/ansible.git
2. cd ansible
3. git submodule init
4. git submodule update --recursive
5. cd lib/ansible/modules/extras
6. git fetch origin pull/1234/head:pr/1234
7. git checkout pr/1234
[ DO YOUR TESTING HERE ]
8. cd /path/to/ansible/clone
9. git submodule update --recursive
For Those About To Test, We Salute You For Those About To Test, We Salute You
++++++++++++++++++++++++++++++++++++++ ++++++++++++++++++++++++++++++++++++++

Loading…
Cancel
Save