Skip to content

Commit

Permalink
[FAB-14988] Release fabric v2.0.0-alpha
Browse files Browse the repository at this point in the history
Change-Id: I4f2233a657a7d3480a1d237fc1c43ca3c29076ee
Signed-off-by: David Enyeart <enyeart@us.ibm.com>
  • Loading branch information
denyeart committed Apr 9, 2019
1 parent e6e1c12 commit be235fd
Show file tree
Hide file tree
Showing 6 changed files with 994 additions and 16 deletions.
882 changes: 882 additions & 0 deletions CHANGELOG.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion Makefile
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@
# - help-docs - generate the command reference docs

ALPINE_VER ?= 3.9
BASE_VERSION = 2.0.0
BASE_VERSION = 2.0.0-alpha
PREV_VERSION = 1.4.0
BASEIMAGE_RELEASE = 0.4.15

Expand Down
7 changes: 4 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ open source architecture; Hyperledger Fabric is your starting point.

## Releases

- [v2.0.0-alpha - April 9, 2019](https://github.com/hyperledger/fabric/releases/tag/v2.0.0-alpha)
- [v1.4.1-rc1 - March 29, 2019](https://github.com/hyperledger/fabric/releases/tag/v1.4.1-rc1)
- [v1.4.0 - January 9, 2019](https://github.com/hyperledger/fabric/releases/tag/v1.4.0)
- [v1.4.0-rc2 - December 20, 2018](https://github.com/hyperledger/fabric/releases/tag/v1.4.0-rc2)
Expand Down Expand Up @@ -89,13 +90,13 @@ Check [the documentation](testingInfo.rst) for information on the testing struct

[Hyperledger Fabric Issue Tracking (JIRA)](https://jira.hyperledger.org/secure/Dashboard.jspa?selectPageId=10104)

[Hyperledger Fabric Wiki](https://wiki.hyperledger.org/projects/Fabric)
[Hyperledger Fabric Wiki](https://wiki.hyperledger.org/display/Fabric)

[Hyperledger Wiki](https://wiki.hyperledger.org/)

[Hyperledger Code of Conduct](https://wiki.hyperledger.org/community/hyperledger-project-code-of-conduct)
[Hyperledger Code of Conduct](https://wiki.hyperledger.org/display/HYP/Hyperledger+Code+of+Conduct)

[Community Calendar](https://wiki.hyperledger.org/community/calendar-public-meetings)
[Community Calendar](https://wiki.hyperledger.org/display/HYP/Calendar+of+Public+Meetings)

## License <a name="license"></a>

Expand Down
23 changes: 12 additions & 11 deletions docs/source/install.rst
Original file line number Diff line number Diff line change
Expand Up @@ -37,19 +37,23 @@ command that follows will perform the following steps:
#. Download the Hyperledger Fabric docker images for the version specified

Once you are ready, and in the directory into which you will install the
Fabric Samples and binaries, go ahead and execute the following command:
Fabric Samples and binaries, go ahead and execute the command to pull down
the binaries and images.

.. note:: If you want the latest production release, omit all version identifiers.

.. code:: bash
curl -sSL http://bit.ly/2ysbOFE | bash -s -- 1.4.0
curl -sSL http://bit.ly/2ysbOFE | bash -s
.. note:: If you want to download different versions for Fabric, Fabric-ca and thirdparty
Docker images, you must pass the version identifier for each.
.. note:: If you want a specific release, pass a version identifier for Fabric,
Fabric-ca and thirdparty Docker images.
The command below demonstrates how to download **Fabric v2.0.0 Alpha release v2.0.0-alpha**

.. code:: bash
curl -sSL http://bit.ly/2ysbOFE | bash -s -- <fabric> <fabric-ca> <thirdparty>
curl -sSL http://bit.ly/2ysbOFE | bash -s -- 1.4.0 1.4.0 0.4.15
curl -sSL http://bit.ly/2ysbOFE | bash -s -- <fabric_version> <fabric-ca_version> <thirdparty_version>
curl -sSL http://bit.ly/2ysbOFE | bash -s -- 2.0.0-alpha 2.0.0-alpha 0.4.15
.. note:: If you get an error running the above curl command, you may
have too old a version of curl that does not handle
Expand All @@ -61,10 +65,6 @@ Fabric Samples and binaries, go ahead and execute the following command:
the un-shortened URL:
https://raw.githubusercontent.com/hyperledger/fabric/master/scripts/bootstrap.sh

.. note:: You can use the command above for any published version of Hyperledger
Fabric. Simply replace `1.4.0` with the version identifier
of the version you wish to install.

The command above downloads and executes a bash script
that will download and extract all of the platform-specific binaries you
will need to set up your network and place them into the cloned repo you
Expand All @@ -76,7 +76,8 @@ created above. It retrieves the following platform-specific binaries:
* ``discover``,
* ``idemixgen``
* ``orderer``,
* ``peer``, and
* ``peer``,
* ``token``, and
* ``fabric-ca-client``

and places them in the ``bin`` sub-directory of the current working
Expand Down
91 changes: 91 additions & 0 deletions release_notes/v2.0.0-alpha.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
v2.0.0-alpha Release Notes - April 9, 2019
------------------------------------------

What's New in Hyperledger Fabric v2.0
-------------------------------------

The following major features are included in the v2.0.0 Alpha release:

FAB-11237 - Improved chaincode lifecycle
The Fabric 2.0 Alpha introduces decentralized governance for chaincode, with a
new process for installing a chaincode on your peers and starting it on a
channel. The new Fabric chaincode lifecycle allows multiple organizations to
come to agreement on the parameters of a chaincode, such as the chaincode
endorsement policy, before it can be used to interact with the ledger.

FAB-11144 - Native token support
The Fabric 2.0 Alpha provides users the ability to easily represent assets
as tokens on Fabric channels. FabToken is a token management system that uses
an Unspent Transaction Output (UTXO) model to issue, transfer, and redeem tokens
using the identity and membership infrastructure provided by Hyperledger Fabric.
A new 'token' command line interface is included as a way to drive token transactions
without an application.

FAB-6135 - Raft Consensus
Introduced in v1.4.1 and v2.0.0 Alpha, the ordering service now provides
an option to use the Raft Consensus algorithm. Raft is a crash fault tolerant
(CFT) ordering service based on an implementation of Raft protocol in etcd.

FAB-11096 - Docker images with Alpine Linux
Hyperledger Fabric Docker images will now use Alpine Linux,
a security-oriented, lightweight Linux distribution.

New operational metrics and health checks
FAB-13088 Endorser metrics
FAB-14077 Orderer communication metrics
FAB-11937 Raft metrics
FAB-13237 Metrics for log records
FAB-12727 Gossip metrics
FAB-13341 Kafka health check
FAB-12908 CouchDB health check

Changes, Known Issues, and Workarounds
--------------------------------------

FAB-11237 - Improved chaincode lifecycle
The new Fabric chaincode lifecycle in the v2.0.0 Alpha release is not yet feature
complete. Specifically, be aware of the following limitations in the Alpha release:
- CouchDB indexes are not yet supported
- Chaincodes defined with the new lifecycle are not yet discoverable via service discovery
These limitations will be resolved after the Alpha release.


FAB-11096 - Docker images with Alpine Linux
Bash is no longer available in Fabric images. Utilize Alpine's built-in
sh or ash instead.

FAB-12075 - Duplicate Go Client identity library removed
If vendoring the Client identity library (CID) in chaincode, import
github.com/hyperledger/fabric/core/chaincode/shim/ext/cid
rather than
github.com/hyperledger/fabriccore/chaincode/lib/cid/cid.go

FAB-12088 - Java chaincode support on s390x architecture
Java chaincode support is not yet available on s390x architecture.

FAB-12134 Same chaincode source receiving fingerprint mismatch error
Chaincode installed in different ways may result in "chaincode fingerprint
mismatch data mismatch" error upon instantiation. This may happen when
installing chaincode by using different SDKs. To workaround the problem,
package the chaincode prior to installation and instantiation, by using
the "peer chaincode package" command.

Known Vulnerabilities
---------------------
FAB-8664 - Peer should detect and react when its org has been removed
This is a relatively low severity problem, because it requires a significant
conspiracy of network admins, but it will be addressed in a future release.

Resolved Vulnerabilities
------------------------
None.

Other improvements and fixes
----------------------------
FAB-13471 - Fix for multiple chaincode upgrades in a single block
FAB-14687 - Fix memory leak in gossip message store
Updated to Go version 1.11.5
Updated baseimage version to 0.4.15 for third party dependencies.

For the full list of improvements and fixes, refer to the release change log:
https://github.com/hyperledger/fabric/blob/master/CHANGELOG.md#v200-alpha
5 changes: 4 additions & 1 deletion scripts/bootstrap.sh
Original file line number Diff line number Diff line change
Expand Up @@ -27,9 +27,12 @@ printHelp() {
echo "would download docker images and binaries for version 1.4.0"
}

# dockerFabricPull() pulls docker images from fabric and chaincode repositories
# note, if a docker image doesn't exist for a requested release, it will simply
# be skipped, since this script doesn't terminate upon errors.
dockerFabricPull() {
local FABRIC_TAG=$1
for IMAGES in peer orderer ccenv javaenv tools; do
for IMAGES in peer orderer ccenv tools baseos nodeenv javaenv; do
echo "==> FABRIC IMAGE: $IMAGES"
echo
docker pull hyperledger/fabric-$IMAGES:$FABRIC_TAG
Expand Down

0 comments on commit be235fd

Please sign in to comment.