README.md

   1 # DCAE Blueprints and Bootstrap Container
   2 This repository holds the source code needed to build the
   3 Docker image for the DCAE bootstrap container.  The bootstrap
   4 container runs at DCAE deployment time (via a Helm chart) and
   5 does initial setup of the DCAE environment.
   6
   7 This repository also holds Cloudify blueprints for service components.
   8 The Docker build process copies these blueprints into the Docker image
   9 for the bootstrap container.
  10
  11 _Note: Prior to the Frankfurt release (R6), this repository held blueprint templates
  12 for components deployed using Cloudify Manager.   The build process for this
  13 repository expanded the templates and pushed them to the Nexus raw
  14 repository.  The DCAE bootstrap container was hosted in the `dcaegen2.deployments` repository.
  15 The Docker build process for the bootstrap containter image pulled the blueprints it needed from the Nexus raw repository._
  16
  17 ## DCAE Bootstrap Container
  18 This container is responsible for loading blueprints onto the
  19 DCAE inventory component.  It also provides an environment for debugging
  20 any issues related to Cloudify deployments, since it has the Cloudify
  21 "cfy" command line tool available.
  22
  23 The Docker image build process loads blueprints into the
  24 image's file system.   The blueprints are copied from the `blueprints` directory in this repository.
  25 At run time, the main script in the container
  26 (`bootstrap.sh`) uploads the blueprints to the DCAE inventory component.
  27
  28 The container expects to be started with two environment variables:
  29   - `CMADDR` -- the address of the target Cloudify Manager
  30   - `CMPASS` -- the password for Cloudify Manager
  31
  32 The container expects input files to use when deploying the blueprints.
  33 It expects to find them in /inputs.   The normal method for launching
  34 the container is via a Helm Chart launched by OOM.  That chart creates
  35 a Kubernetes ConfigMap containing the input files.  The ConfigMap is
  36 mounted as a volume at /inputs.
  37