From 523f644b909d5699fbd992a011e7ed6031e96a9a Mon Sep 17 00:00:00 2001 From: David Enyeart Date: Thu, 15 Mar 2018 13:44:47 -0400 Subject: [PATCH] [FAB-8883] Prepare for Fabric v1.1.0 release Prepare for Fabric v1.1.0 release. Change-Id: I7b70197a5604c0771dbffdbd01169f605709a9b0 Signed-off-by: David Enyeart --- CHANGELOG.md | 23 ++++++++++ Makefile | 4 +- docs/source/releases.rst | 40 +++++++++++++++++ docs/source/samples.rst | 6 +-- docs/source/tutorials.rst | 5 ++- .../upgrading_your_network_tutorial.rst | 7 ++- release_notes/v1.1.0.txt | 44 +++++++++++++++++++ 7 files changed, 119 insertions(+), 10 deletions(-) create mode 100644 release_notes/v1.1.0.txt diff --git a/CHANGELOG.md b/CHANGELOG.md index 4ad7d85c935..4904040e937 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,3 +1,26 @@ +## v1.1.0 +Thu Mar 15 13:49:03 EDT 2018 + +* [2112633](https://github.com/hyperledger/fabric/commit/2112633) [FAB-8883](https://jira.hyperledger.org/browse/FAB-8883) Prepare for Fabric v1.1.0 release +* [a495a88](https://github.com/hyperledger/fabric/commit/a495a88) [FAB-7895](https://jira.hyperledger.org/browse/FAB-7895): New topic (Concept) : Peers +* [27fd3e5](https://github.com/hyperledger/fabric/commit/27fd3e5) [FAB-8854](https://jira.hyperledger.org/browse/FAB-8854) Fix link in fabric ca commands page +* [d16ce12](https://github.com/hyperledger/fabric/commit/d16ce12) [FAB-8844](https://jira.hyperledger.org/browse/FAB-8844) correct handling of launch errors +* [bf53291](https://github.com/hyperledger/fabric/commit/bf53291) [FAB-8728](https://jira.hyperledger.org/browse/FAB-8728) Typo in peerchannel.md +* [e7ed520](https://github.com/hyperledger/fabric/commit/e7ed520) [FAB-8748](https://jira.hyperledger.org/browse/FAB-8748) Get fabric-ca-client binary from bootstrap.sh +* [4bf4f24](https://github.com/hyperledger/fabric/commit/4bf4f24) [FAB-8763](https://jira.hyperledger.org/browse/FAB-8763) Clarify CLI cc package doc for node cc +* [15ec7d1](https://github.com/hyperledger/fabric/commit/15ec7d1) [FAB-8666](https://jira.hyperledger.org/browse/FAB-8666) refactor fabric docs TOC +* [08d817c](https://github.com/hyperledger/fabric/commit/08d817c) [FAB-8731](https://jira.hyperledger.org/browse/FAB-8731) Clarify CLI cc install doc for node cc +* [5533049](https://github.com/hyperledger/fabric/commit/5533049) [FAB-8738](https://jira.hyperledger.org/browse/FAB-8738) Document Reserved Field Names in CouchDB +* [fdff463](https://github.com/hyperledger/fabric/commit/fdff463) [FAB-8700](https://jira.hyperledger.org/browse/FAB-8700) Clarify channel update tutorial leader elec +* [9105134](https://github.com/hyperledger/fabric/commit/9105134) [FAB-8698](https://jira.hyperledger.org/browse/FAB-8698) - Fix broken link +* [8292ed4](https://github.com/hyperledger/fabric/commit/8292ed4) [FAB-8688](https://jira.hyperledger.org/browse/FAB-8688) Gossip onConnect() references wrong field +* [8793c73](https://github.com/hyperledger/fabric/commit/8793c73) [FAB-8240](https://jira.hyperledger.org/browse/FAB-8240) Document Orderer.Addresses config setting +* [7a5a16e](https://github.com/hyperledger/fabric/commit/7a5a16e) [FAB-8647](https://jira.hyperledger.org/browse/FAB-8647): explain limitation of adding new org +* [f78e0ab](https://github.com/hyperledger/fabric/commit/f78e0ab) [FAB-8416](https://jira.hyperledger.org/browse/FAB-8416) add leader election section +* [7ba1ffe](https://github.com/hyperledger/fabric/commit/7ba1ffe) [FAB-8628](https://jira.hyperledger.org/browse/FAB-8628) fix code coverage report issue +* [1334e63](https://github.com/hyperledger/fabric/commit/1334e63) [FAB-8636](https://jira.hyperledger.org/browse/FAB-8636) clarify release tag to use for tutorial +* [5b0a846](https://github.com/hyperledger/fabric/commit/5b0a846) [FAB-8284](https://jira.hyperledger.org/browse/FAB-8284) Prepare Fabric for next release + ## v1.1.0-rc1 Thu Mar 1 12:37:41 EST 2018 diff --git a/Makefile b/Makefile index ea98c42090a..be426d072a5 100755 --- a/Makefile +++ b/Makefile @@ -53,8 +53,8 @@ PROJECT_NAME = $(PROJECT_NAME)/fabric else PROJECT_NAME = hyperledger/fabric endif -IS_RELEASE = false -EXPERIMENTAL ?= true +IS_RELEASE = true +EXPERIMENTAL ?= false ifeq ($(EXPERIMENTAL),true) GO_TAGS += experimental diff --git a/docs/source/releases.rst b/docs/source/releases.rst index faa1e70155c..d40931f4c04 100644 --- a/docs/source/releases.rst +++ b/docs/source/releases.rst @@ -1,6 +1,46 @@ Release Notes ============= +`v1.1.0 `__ - March 15, 2018 +--------------------------------------------------------------------------------------- +The v1.1 release includes all of the features delivered in v1.1.0-preview +and v1.1.0-alpha. + +Additionally, there are feature improvements, bug fixes, documentation and test +coverage improvements, UX improvements based on user feedback and changes to address a +variety of static scan findings (unused code, static security scanning, spelling, +linting and more). + +Updated to Go version 1.9.2. +Updated baseimage version to 0.4.6. + +Known Vulnerabilities +--------------------- +none + +Resolved Vulnerabilities +------------------------ +https://jira.hyperledger.org/browse/FAB-4824 +https://jira.hyperledger.org/browse/FAB-5406 + +Known Issues & Workarounds +-------------------------- +The fabric-ccenv image which is used to build chaincode, currently includes +the github.com/hyperledger/fabric/core/chaincode/shim ("shim") package. +This is convenient, as it provides the ability to package chaincode +without the need to include the "shim". However, this may cause issues in future +releases (and/or when trying to use packages which are included by the "shim"). + +In order to avoid any issues, users are advised to manually vendor the "shim" +package with their chaincode prior to using the peer CLI for packaging and/or +for installing chaincode. + +Please refer to `FAB-5177 `__ for more details, +and kindly be aware that given the above, we may end up changing the +fabric-ccenv in the future. + +`Change Log `__ + `v1.1.0-rc1 `__ - March 1, 2018 ---------------------------------------------------------------------------------------------- The v1.1 release candidate 1 (rc1) includes all of the features delivered in v1.1.0-preview diff --git a/docs/source/samples.rst b/docs/source/samples.rst index ac9a9473e89..ab674a8fa34 100644 --- a/docs/source/samples.rst +++ b/docs/source/samples.rst @@ -30,7 +30,7 @@ execute the following commands: git checkout {TAG}　 .. note:: To ensure the samples are compatible with the version of Fabric binaries you download below, - checkout the samples ``{TAG}`` that matches your Fabric version, for example, v1.1.0-rc1. + checkout the samples ``{TAG}`` that matches your Fabric version, for example, v1.1.0. To see a list of all fabric-samples tags, use command "git tag". .. _binaries: @@ -49,7 +49,7 @@ you will extract the platform-specific binaries: .. code:: bash - curl -sSL https://goo.gl/6wtTN5 | bash -s 1.1.0-rc1 + curl -sSL https://goo.gl/6wtTN5 | bash -s 1.1.0 .. note:: If you get an error running the above curl command, you may have too old a version of curl that does not handle @@ -62,7 +62,7 @@ you will extract the platform-specific binaries: https://github.com/hyperledger/fabric/blob/master/scripts/bootstrap.sh .. note:: You can use the command above for any published version of Hyperledger - Fabric. Simply replace '1.1.0-rc1' with the version identifier + Fabric. Simply replace '1.1.0' with the version identifier of the version you wish to install. The command above downloads and executes a bash script diff --git a/docs/source/tutorials.rst b/docs/source/tutorials.rst index 7d441ba634b..f82d6999468 100644 --- a/docs/source/tutorials.rst +++ b/docs/source/tutorials.rst @@ -1,7 +1,7 @@ Tutorials ========= -We offer four initial tutorials to get you started with Hyperledger Fabric. +We offer tutorials to get you started with Hyperledger Fabric. The first is oriented to the Hyperledger Fabric **application developer**, :doc:`write_first_app`. It takes you through the process of writing your first blockchain application for Hyperledger Fabric using the Hyperledger Fabric @@ -12,6 +12,9 @@ operators, :doc:`build_network`. This one walks you through the process of establishing a blockchain network using Hyperledger Fabric and provides a basic sample application to test it out. +There are also tutorials for updating your channel, :doc:`channel_update_tutorial`, and +upgrading your network to a later version of Hyperledger Fabric, :doc:`upgrading_your_network_tutorial`. + Finally, we offer two chaincode tutorials. One oriented to developers, :doc:`chaincode4ade`, and the other oriented to operators, :doc:`chaincode4noah`. diff --git a/docs/source/upgrading_your_network_tutorial.rst b/docs/source/upgrading_your_network_tutorial.rst index 755dc191490..b0be42691ae 100644 --- a/docs/source/upgrading_your_network_tutorial.rst +++ b/docs/source/upgrading_your_network_tutorial.rst @@ -107,8 +107,7 @@ Get the newest samples .. note:: The instructions below pertain to whatever is the most recently published version of v1.1.x, starting with 1.1.0-rc1. Please substitute '1.1.x' with the version identifier of the published release that - you are testing. e.g. replace '1.1.x' with '1.1.0-rc1' if you are - currently testing the first release candidate. + you are testing. e.g. replace 'v1.1.x' with 'v1.1.0'. Before completing the rest of the tutorial, it's important to get the v1.1.x version of the samples, you can do this by: @@ -130,7 +129,7 @@ To run the script, issue these commands: .. code:: bash - # Note, replace '1.1.x' with a specific version, for example '1.1.0-rc1'. + # Note, replace '1.1.x' with a specific version, for example '1.1.0'. # Don't pass the image flag '-i 1.1.x' if you prefer to default to 'latest' images. ./byfn.sh upgrade -i 1.1.x @@ -187,7 +186,7 @@ Let’s begin the upgrade process by **bringing down the orderer**: export LEDGERS_BACKUP=./ledgers-backup - # Note, replace '1.1.x' with a specific version, for example '1.1.0-rc1'. + # Note, replace '1.1.x' with a specific version, for example '1.1.0'. # Set IMAGE_TAG to 'latest' if you prefer to default to the images tagged 'latest' on your system. export IMAGE_TAG=`uname -m`-1.1.x diff --git a/release_notes/v1.1.0.txt b/release_notes/v1.1.0.txt new file mode 100644 index 00000000000..25d702153ad --- /dev/null +++ b/release_notes/v1.1.0.txt @@ -0,0 +1,44 @@ +v1.1.0 March 15, 2018 +--------------------- + +Release Notes +------------- +The v1.1 release includes all of the features delivered in v1.1.0-preview +and v1.1.0-alpha. + +Additionally, there are feature improvements, bug fixes, documentation and test +coverage improvements, UX improvements based on user feedback and changes to address a +variety of static scan findings (unused code, static security scanning, spelling, +linting and more). + +Updated to Go version 1.9.2. +Updated baseimage version to 0.4.6. + +Known Vulnerabilities +--------------------- +none + +Resolved Vulnerabilities +------------------------ +https://jira.hyperledger.org/browse/FAB-4824 +https://jira.hyperledger.org/browse/FAB-5406 + +Known Issues & Workarounds +-------------------------- +The fabric-ccenv image which is used to build chaincode, currently includes +the github.com/hyperledger/fabric/core/chaincode/shim ("shim") package. +This is convenient, as it provides the ability to package chaincode +without the need to include the "shim". However, this may cause issues in future +releases (and/or when trying to use packages which are included by the "shim"). + +In order to avoid any issues, users are advised to manually vendor the "shim" +package with their chaincode prior to using the peer CLI for packaging and/or +for installing chaincode. + +Please refer to https://jira.hyperledger.org/browse/FAB-5177 for more details, +and kindly be aware that given the above, we may end up changing the +fabric-ccenv in the future. + +Change Log +---------- +https://github.com/hyperledger/fabric/blob/master/CHANGELOG.md#v110