| Joey Armstrong | 34f1840 | 2023-07-21 18:58:10 -0400 | [diff] [blame] | 1 | .. _pull-request--commit-message: |
| 2 | |
| 3 | Repository commit message |
| 4 | ========================= |
| 5 | |
| 6 | - First line in a commit message is special. |
| 7 | - 50 cpl max to avoid complaints about length. |
| 8 | - Mention a jira ticket (VOL-xxxx) and the ticket will receive status updates from jenkins. |
| Joey Armstrong | 3980d70 | 2023-08-23 10:57:18 -0400 | [diff] [blame^] | 9 | - Additional jira ticket dependencies can be listed on line 3+ |
| Joey Armstrong | 34f1840 | 2023-07-21 18:58:10 -0400 | [diff] [blame] | 10 | |
| 11 | .. code:: bash |
| 12 | |
| 13 | [VOL-5048] - Build and deploy for VOLTHA v2.12 release. |
| 14 | |
| Joey Armstrong | 3980d70 | 2023-08-23 10:57:18 -0400 | [diff] [blame^] | 15 | [VOL-5049] |
| 16 | [VOL-5050] |
| 17 | |
| Joey Armstrong | 34f1840 | 2023-07-21 18:58:10 -0400 | [diff] [blame] | 18 | api/pom.xml |
| 19 | app/pom.xml |
| 20 | pom.xml |
| 21 | ----------- |
| 22 | o Update copyright notice to span CCYY. |
| 23 | o Update maven plugins spotbugs and findsecbugs. |
| 24 | o Update sadis component to vX.Y.Z |
| 25 | |
| 26 | pkg/* |
| 27 | Makefile |
| 28 | ---------- |
| 29 | o Update copyright notice. |
| 30 | o Run gofmt -s -w on all golang sources. |
| 31 | |
| 32 | VERSION |
| 33 | ------- |
| 34 | o Increment version string to non-dev for release. |
| 35 | |
| 36 | Job Directives |
| 37 | -------------- |
| 38 | verify_{project}_licensed |
| 39 | verify_{project}_tag-collision |
| 40 | verify_{project}_unit-test |
| 41 | verify_{project}_sanity-test |
| 42 | |
| 43 | hardware test functional tests |
| 44 | voltha test openonu multiolt |
| 45 | voltha 2.8 test openonu multiolt |
| 46 | |
| 47 | git commit ... |
| 48 | -------------- |
| 49 | |
| 50 | - A commit message can be constructed using either |
| 51 | |
| 52 | - -F <file> |
| 53 | - --message="inlined text" |
| 54 | |
| 55 | .. code:: bash |
| 56 | |
| 57 | $ vi commit.txt |
| 58 | $ git add *stuff* |
| 59 | $ git commit --F ./commit.txt |
| 60 | # appropriate git rebase command |
| 61 | $ git review --reviewers tux@onf.org foo@onf.org bar@onf.org |
| 62 | |
| 63 | Commit Message: extra credit |
| 64 | ++++++++++++++++++++++++++++ |
| 65 | |
| 66 | Additional commit message directives are available that will augment tasks |
| 67 | performed by a job. Additional test suites can be requested for a job run |
| 68 | by including tokens found here. |
| 69 | |
| 70 | `Tokens |
| 71 | <https://docs.voltha.org/master/testing/voltha_test_automation.html#per-patchset-verification-jobs>`_ can be embedded within a commit message to enable running additional test suites as part of jenkins validation. |
| 72 | |
| 73 | Troubleshooting: |
| 74 | ++++++++++++++++ |
| 75 | |
| 76 | There have been a few reports of additional testing not beeing initiated |
| 77 | by a commit. If you encounter this behavior visit the |
| 78 | `VOLTHA jira site <https://jira.opencord.org/secure/Dashboard.jspa>`_ |
| 79 | and open a trouble ticket detailing the changeset URL or a repository |
| 80 | and commit message text. |
| 81 | |
| 82 | Commit hooks can be repository specific and may need to be |
| 83 | deployed/enabled/updated to support requestd functionality. |