THIS PAGE IS OUT OF DATE AND BEING UPDATED. FABRIC AND ITS REPOSITORIES HAVE MIGRATED TO GITHUB FOR SCM AND AZURE PIPELINES FOR CI
Contributors
| Name | |
|---|---|
| Jessica Wagantall | jwagantall@linuxfoundation.org |
| Ramesh Thoomu | rameshbabu.thoomu@gmail.com |
| Scott Zwierzynski | scottz@us.ibm.com |
| Vijay Punugubati | Vijay.Punugubati@ibm.com |
| Brett T Logan | brett.t.logan@ibm.com |
Summary
The Hyperledger Fabric (and associated) projects utilize various tools and workflows for continuous project development. This documentation will assist you in getting started with using these tools and understanding the workflow(s) our contributors use while working with the Fabric CI infrastructure.
...
CI jobs listen to the below comment phrases for each fabric project:
fabric:
| Verify Jobs | Comment | Merge Jobs | Comment |
|---|---|---|---|
| fabric-verify-build-checks-x86_64 | Run VerifyBuild/VerifyBuild | fabric-merge-x86_64 | remerge-x |
| fabric-verify-unit-tests-x86_64. | Run UnitTest | fabric-merge-end-2-end-x86_64 | remerge-e2e |
| fabric-verify-integration-tests-x86_64 | Run IntegrationTest | For all merge jobs | remerge |
| fabric-docs-build-x86_64 | Run DocsBuild |
fabric-ca:
| Verify Jobs | Comment | Merge Jobs | Comment |
|---|---|---|---|
| fabric-ca-verify-x86_64 | reverify-x | fabric-ca-merge-x86_64 | remerge-x |
| fabric-ca-verify-fvt-x86_64 | reverify-fvt | fabric-ca-merge-fvt-x86_64 | remerge-fvt |
| fabric-rtd-verify-job | recheck | fabric-merge-end-2-end-x86_64 | remerge-e2e |
| For all verify jobs | reverify | For all merge jobs | remerge |
fabric-sdk-nodejava:
| Verify Jobs | Comment | Merge Jobs | Comment |
|---|---|---|---|
| fabric-sdk- |
| java-master-verify-x86_64 | reverify-x |
| fabric-sdk-java- |
| master-merge-x86_64 | remerge-x |
| fabric-sdk-java |
...
reverify-x – triggers fabric-sdk-java-verify-x86_64 job on x86_64
| -master-verify-1.4-x86_64 | reverify-1. |
...
| 4 | fabric-sdk-java- |
...
| master-merge-1. |
...
| 4-x86_64 |
...
| remerge-1.4 | |
| fabric-sdk-java |
...
| -release-1.4-verify-x86_64 | reverify-x |
...
| fabric- |
...
| sdk-java-release-1.4-merge-x86_64 |
...
...
reverify-z – triggers fabric-chaincode-node-verify-x86_64 job on s390x
| remerge-x | |||
| For all verify jobs | reverify | For all merge jobs | remerge |
fabric-chaincode-node
...
All other repositories use any of the below comment phrases
...
:
fabric-baseimage:
| Verify Jobs | Comment | Merge Jobs | Comment |
|---|---|---|---|
| {project}-verify-x86_64 | reverify-x | {project}-merge-x86_64 | remerge-x |
| {project}-verify-s390x | reverify-z | {project}-merge-s390x | remerge-z |
| For all verify jobs | reverify | For all merge jobs | remerge |
All other repositories use any of the below comment phrases
fabric-samples fabric-chaincode-java fabric-sdk-go
fabric-sdk-node fabric-chaincode-evm fabric-sdk-py
fabric-gateway-java fabric-test
| Verify Jobs | Comment | Merge Jobs | Comment |
|---|---|---|---|
| {project}-verify-x86_64 | reverify or reverify-x | {project}-merge-x86_64 | remerge or remerge-x |
Troubleshooting - Failing CI Jobs
...
Take a look at why your patchset is failing verification. If it seems unrelated to your patchset changes, then…
Examine console logs for other patchsets build failures occurring in Fabric Project builds. Confirm if any others are seeing build failures with the same symptoms. If so, then…
Find out if a bug exists already for your problem. The first place to look is the list of open CI_Failure bugs. Next, SEARCH Fabric Issues for your error strings symptoms. If no bug exists for your problem, then…
CREATE a bug with severity = 'Highest' and label = 'ci_failure', and set the appropriate component for triage. Squads regularly review their components bug lists.
Alert the community by reaching out to #fabric-ci channel (or #infra-support channel, if the issue pertains to network latency issues, such as FAB-7971), where you may find help and discussions of similar topics. For more info, see the CI FAQs, below.
CI Weekly
Frequently Asked Questions
...
| Question | Resource |
|---|---|
| Which Fabric projects are currently using CI? | hyperledger_fabric_projects_on_ci |
| What is the process used to build, test, and release Fabric projects? | https://github.com/hyperledger/ci-management/blob/master/docs/fabric_ci_process.mddocs.readthedocs.io/en/latest/ |
| Where is the Jenkins CI for Hyperledger Fabric? | https://jenkins.hyperledger.org/ |
| Where is the sandbox installation of Jenkins CI for Hyperledger Fabric? | https://jenkins.hyperledger.org/sandbox |
| Where can I found out more about each of the Jenkins jobs used to build, test, and release Hyperledger Fabric projects? | https://github.com/hyperledger/ci-management |
| How do I write Jenkins job definitions for use with Hyperledger Fabric projects? | https://docs.openstack.org/infra/jenkins-job-builder/definition.html |
| How should I test my Jenkins job definitions for use by the Fabric CI process? | https://github.com/hyperledger/ci-management/blob/master/Sandbox_Setup.md |
| I want to find Fabric CI related tasks to work on. Where should I go? | https://jira.hyperledger.org/issues/?filter=11500 |
| I have questions about Fabric CI. Where should I go for help? | https://chat.hyperledger.org/channel/ci-pipeline |
...