Merge "[FABC-131] Change fabric-ca sample to build images"

fabric-ca/.gitignore

@@ -1,2 +1,5 @@
 docker-compose.yml
+fabric-ca-orderer.dockerfile
+fabric-ca-peer.dockerfile
+fabric-ca-tools.dockerfile
 data

fabric-ca/README.md

@@ -18,23 +18,31 @@ The Hyperledger Fabric CA sample demonstrates the following:
 
 ## Running this sample
 
-1. The following images are required to run this sample:
-*hyperledger/fabric-ca-orderer*, *hyperledger/fabric-ca-peer*, and *hyperledger/fabric-ca-tools*
+1. To run this sample, simply run the *start.sh* script.  You may do this
+multiple times in a row as needed since the *start.sh* script cleans up before
+starting each time.  This sample can be run with the latest released version,
+an older released version, or from locally built docker images as follows:
 
-    #### install the images
-    Run the *bootstrap.sh* script provided with this sample to download the
-    required images for fabric-ca sample. For the v1.2.0-rc1 release, you
-    will need to specify the version as follows:
+    a. By default, the sample is run with the latest released version of Fabric
+    and Fabric CA.
 
-    ```
-    bootstrap.sh 1.2.0-rc1
-    ```
+    b. Older versions of Fabric and Fabric CA can be used by setting the
+    `FABRIC_TAG` environment variable. For example, `export FABRIC_TAG=1.2.0`
+    will run the sample with 1.2.0 version of Fabric and Fabric CA.
 
-2. To run this sample, simply run the *start.sh* script.  You may do this
-multiple times in a row as needed since the *start.sh* script cleans up before
-starting each time.
+    c. The sample can also be run with locally built Fabric and Fabric CA
+    docker images. Fabric and Fabric CA repositories must be cloned with following
+    commands:
+
+    `git clone https://github.com/hyperledger/fabric.git`
+    `git clone https://github.com/hyperledger/fabric-ca.git`
+
+    Then execute the `make docker-all` command from the fabric-ca repository. This will
+    build the necessary images based on the local source code. Before executing the
+    *start.sh* script, set the `FABRIC_TAG` environment variable to 'local' as follows:
+    `export FABRIC_TAG=local`.
 
-3. To stop the containers which are started by the *start.sh* script, you may run the *stop.sh* script.
+2. To stop the containers which are started by the *start.sh* script, you may run the *stop.sh* script.
 
 ## Understanding this sample
 

fabric-ca/makeDocker.sh

@@ -9,11 +9,24 @@
 # This script builds the docker compose file needed to run this sample.
 #
 
+# IMPORTANT: The following default FABRIC_TAG value should be updated for each
+# release after the fabric-orderer and fabric-peer images have been published
+# for the release.
+export FABRIC_TAG=${FABRIC_TAG:-1.2.0}
+
+export FABRIC_CA_TAG=${FABRIC_CA_TAG:-${FABRIC_TAG}}
+export NS=${NS:-hyperledger}
+
+export ARCH="linux-amd64" # Docker images run on linux
+CA_BINARY_FILE=hyperledger-fabric-ca-${ARCH}-${FABRIC_CA_TAG}.tar.gz
+URL=https://nexus.hyperledger.org/content/repositories/releases/org/hyperledger/fabric-ca/hyperledger-fabric-ca/${ARCH}-${FABRIC_CA_TAG}/${CA_BINARY_FILE}
+
 SDIR=$(dirname "$0")
 source $SDIR/scripts/env.sh
 
 function main {
    {
+   createDockerFiles
    writeHeader
    writeRootFabricCA
    if $USE_INTERMEDIATE_CA; then
@@ -26,6 +39,41 @@ function main {
    log "Created docker-compose.yml"
 }
 
+# Create various dockerfiles used by this sample
+function createDockerFiles {
+   if [ "$FABRIC_TAG" = "local" ]; then
+      ORDERER_BUILD="image: hyperledger/fabric-ca-orderer"
+      PEER_BUILD="image: hyperledger/fabric-ca-peer"
+      TOOLS_BUILD="image: hyperledger/fabric-ca-tools"
+   else
+      createDockerFile orderer
+      ORDERER_BUILD="build:
+      context: .
+      dockerfile: fabric-ca-orderer.dockerfile"
+      createDockerFile peer
+      PEER_BUILD="build:
+      context: .
+      dockerfile: fabric-ca-peer.dockerfile"
+      createDockerFile tools
+      TOOLS_BUILD="build:
+      context: .
+      dockerfile: fabric-ca-tools.dockerfile"
+   fi
+}
+
+# createDockerFile
+function createDockerFile {
+   {
+      echo "FROM ${NS}/fabric-${1}:${FABRIC_TAG}"
+      echo 'RUN apt-get update && apt-get install -y netcat jq && apt-get install -y curl && rm -rf /var/cache/apt'
+      echo "RUN curl -o /tmp/fabric-ca-client.tar.gz $URL && tar -xzvf /tmp/fabric-ca-client.tar.gz -C /tmp && cp /tmp/bin/fabric-ca-client /usr/local/bin"
+      echo 'RUN chmod +x /usr/local/bin/fabric-ca-client'
+      echo 'ARG FABRIC_CA_DYNAMIC_LINK=false'
+      # libraries needed when image is built dynamically
+      echo 'RUN if [ "\$FABRIC_CA_DYNAMIC_LINK" = "true" ]; then apt-get install -y libltdl-dev; fi'
+   } > $SDIR/fabric-ca-${1}.dockerfile
+}
+
 # Write services for the root fabric CA servers
 function writeRootFabricCA {
    for ORG in $ORGS; do
@@ -46,7 +94,7 @@ function writeIntermediateFabricCA {
 function writeSetupFabric {
    echo "  setup:
     container_name: setup
-    image: hyperledger/fabric-ca-tools
+    $TOOLS_BUILD
     command: /bin/bash -c '/scripts/setup-fabric.sh 2>&1 | tee /$SETUP_LOGFILE; sleep 99999'
     volumes:
       - ./scripts:/scripts
@@ -173,7 +221,7 @@ function writeOrderer {
    MYHOME=/etc/hyperledger/orderer
    echo "  $ORDERER_NAME:
     container_name: $ORDERER_NAME
-    image: hyperledger/fabric-ca-orderer
+    $ORDERER_BUILD
     environment:
       - FABRIC_CA_CLIENT_HOME=$MYHOME
       - FABRIC_CA_CLIENT_TLS_CERTFILES=$CA_CHAINFILE
@@ -210,7 +258,7 @@ function writePeer {
    MYHOME=/opt/gopath/src/github.com/hyperledger/fabric/peer
    echo "  $PEER_NAME:
     container_name: $PEER_NAME
-    image: hyperledger/fabric-ca-peer
+    $PEER_BUILD
     environment:
       - FABRIC_CA_CLIENT_HOME=$MYHOME
       - FABRIC_CA_CLIENT_TLS_CERTFILES=$CA_CHAINFILE

fabric-ca/start.sh

@@ -8,6 +8,13 @@
 #
 # This script does everything required to run the fabric CA sample.
 #
+# By default, this test is run with the latest released docker images.
+#
+# To run against a specific fabric/fabric-ca version:
+#    export FABRIC_TAG=1.2.0
+#
+# To run with locally built images:
+#    export FABRIC_TAG=local
 
 set -e
 
@@ -54,7 +61,7 @@ tail -f ${SDIR}/${RUN_SUMFILE}&
 TAIL_PID=$!
 
 # Wait for the run container to complete
-while true; do 
+while true; do
    if [ -f ${SDIR}/${RUN_SUCCESS_FILE} ]; then
       kill -9 $TAIL_PID
       exit 0