dcae-platform-documentation

Contains the public facing technical documentation for the dcae platform whose audiences include:

• Architects
• Component developers
• Operations

Usage

Local dev

This is a Mkdocs project. To serve a local version of the documentation to view your changes:

1. Install mkdocs and mkdocs-material:

   pip install mkdocs
   pip install mkdocs-material
   

2. Clone this repo

3. Run the following at the root of the cloned repo:

   mkdocs serve
   

4. View the page at http://127.0.0.1:8000/

Publish

1. Generate the site:

   mkdocs build
   

2. Build the Docker image, tag as desired - eg dcae-platform-documentation:YYYYMMDD

   docker build -t dcae-platform-documentation:20171002 .
   

3. Run the Docker container:

   export DOCKER_HOST=tcp://<target docker host>
   docker stop dpd
   docker rm -f dpd
   docker run -d --name dpd -p 80:80 dcae-platform-documentation:YYYYMMDD