CORD Guide

This is a curated set of documents that describe how to install, operate, test, and develop CORD. The material is organized in two parts:

  • Guides: Outlines the process of installing, operating, testing and developing for CORD as a whole.

  • References: Definitions and specifications about individual components that make up CORD.

CORD is a community-based open source project. In addition to this guide, you can find information about this community, its projects, and its governance on the CORD wiki. This includes early white papers and design notes that have shaped CORD's architecture.

Navigating the Guides

The guides are organized around the major stages in the lifecycle of CORD:

  • Installation: Installing (and later upgrading) CORD.
  • Operations: Operating an already installed CORD deployment.
  • Development: Developing new functionality to be included in CORD.
  • Testing: Testing functionality to be included in CORD.

These are all fairly obvious. What's less obvious is the relationship among these stages, which is helpful in Navigating CORD.

Navigating the References

CORD is built from components and the aggregation of components into a composite solution. The References are organized accordingly:

  • Profile Reference: Installation and configuation details for specific solutions built using CORD components.
  • Service Reference: Configuration (TOSCA) and modeling (xproto) definitions for individual CORD components.
  • Helm Refernce: Helm charts used to install individual CORD components.

For more information on the relationship between Profiles and Services, see Navigating CORD.

Making Changes to this Document

The http://guide.opencord.org website is built using the GitBook Toolchain, with the documentation root in [docs](https://github.com/opencord/docs/blob/{{ book.branch }}) in a checked out source tree. It is build with make, and requires that gitbook, python, and a few other tools are installed.

Source for individual guides is available in the CORD code repository; look in the docs directory of each project, with the documentation rooted in the top-level /docs directory. Updates and improvements to this documentation can be submitted through Gerrit.