You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+7-4Lines changed: 7 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -25,6 +25,8 @@ The following [Rush categories](https://rushjs.io/pages/maintainer/add_to_repo/)
25
25
* node v18 => recommend to use [nvm](https://github.com/nvm-sh/nvm)
26
26
* rush => `npm install -g @microsoft/rush`
27
27
28
+
> As an alternative to installing rush on your system, you can also have node install it for executing single commands similar to what is done in CI, for example from the `libraries/fabric-shim` directory you could add or update a dependency by running `node ../../common/scripts/install-run-rush.js add --package @grpc/grpc-js@latest`
29
+
28
30
> Note that npm v6 has some bugs that mean adding new dependencies etc are not properly picked up. Longer term we should consider moving to yarn or pnpm. However in practice this isn't a serious problem and has been possible to be worked around by issuing `rm ./common/config/rush/npm-shrinkwrap.json` and then `rush update`
29
31
30
32
The fv and e2e tests require a set of docker images of Fabric Peers, Orderers and CAs. To ensure you have the correct images ensure these have been dowloaded and tagged. `rush edge-docker` will do this for you.
@@ -35,6 +37,8 @@ They also need to have the `nodeenv` image present - this is build as part of th
35
37
36
38
* Clone the repo, and ensure you are using node v18, and have rush installed
37
39
*`rush update` is needed to ensure everything is correctly linked and updated.
40
+
- For example, after updating dependencies in `libraries/fabric-shim/package.json` run `rush update` which will delegate to `pnpm` to update the appropriate project files.
41
+
- Note - you could also use `rush add` to have rush manage the `package.json` updates.
38
42
*`rush edge-docker` will pull down and tag the very latest docker images for the peers, orderes etc to test against
39
43
40
44
At this point the repo is fully ready for use and running tests, etc. A full sequence of build-test that is equivalent to the CI pipeline is
@@ -60,17 +64,16 @@ To clean up docker
60
64
61
65
## Mechanics of Contributing
62
66
63
-
The codebase is maintained in [github](https://github.com/hyperledger/fabric-chaincode-node), with a CI pipeline run with [Azure Devlops](https://dev.azure.com/Hyperledger/Fabric-Chaincode-Node/_build?definitionId=33&_a=summary). Issues are handling in [Jira](https://jira.hyperledger.org/issues/?jql=project%20%3D%20FAB%20AND%20component%20%3D%20fabric-chaincode-node) (please use the component `fabric-chaincode-node` in jira as this is shared project with other Fabric components).
64
-
67
+
The codebase is maintained in [github](https://github.com/hyperledger/fabric-chaincode-node), with a CI pipeline run with [Github Actions](https://github.com/hyperledger/fabric-chaincode-node/actions). Issues are handled in [Github Issues](https://github.com/hyperledger/fabric-chaincode-node/issues).
65
68
66
69
67
70
68
71
## Code of Conduct Guidelines <aname="conduct"></a>
69
72
70
-
See our [Code of Conduct Guidelines](../blob/main/CODE_OF_CONDUCT.md).
73
+
See our [Code of Conduct Guidelines](https://github.com/hyperledger/fabric-chaincode-node/blob/main/CODE_OF_CONDUCT.md).
71
74
72
75
## Maintainers <aname="maintainers"></a>
73
76
74
-
Should you have any questions or concerns, please reach out to one of the project's [Maintainers](../blob/main/MAINTAINERS.md).
77
+
Should you have any questions or concerns, please reach out to one of the project's [Maintainers](https://github.com/hyperledger/fabric-chaincode-node/blob/main/MAINTAINERS.md).
75
78
76
79
<arel="license"href="http://creativecommons.org/licenses/by/4.0/"><imgalt="Creative Commons License"style="border-width:0"src="https://i.creativecommons.org/l/by/4.0/88x31.png" /></a><br />This work is licensed under a <arel="license"href="http://creativecommons.org/licenses/by/4.0/">Creative Commons Attribution 4.0 International License</a>.
0 commit comments