"Add a component to a System" tutorial

Aim

• Show how to add a new open source component to a Baserock base system
• Introduce the related help and reference documentation

Task(s) to be completed

• make the necessary changes in baserock:baserock/morphs
• make the necessary changes in upstream:bonnie
• build the system
• deploy and run the system

Start state

The end state of the "Change an existing component" tutorial

• a functioning development environment
• a populated Trove
• a populated artifact cache
• a feature branch containing
  • a built system based on one of the X86 templates

End state

• A deployed system running the new component

Steps

• Outline the process
• Get the source
• Build outside of Baserock
• Build in a Baserock system branch
  • Add a new stratum to the system .morph file
    • copy base system to new-system-system.morph
    • edit the system name
    • add the following lines
  • Create a stratum morphology
  • Create the morphology in a new feature branch in the 'bonnie' repo
  • Successfully Build the system
  • Lists some of the errors that we may encounter
    • Not committing the stratum .morph file
    • Not committing the .morph file in the bonnie repo
    • Not doing initial building without --no-git-update