"Deploy a Baserock system" tutorial

Aim

  • Show how to deploy the system we have built
  • Introduce the related help and reference documentation

Task(s) to be completed

  • Deploy and run a built system

Start state

The end state of the "Build a system and debug a failing build" tutorial

  • a functioning development environment
  • a populated Trove
  • a populated artifact cache
  • a built Baserock system
  • somewhere we can deploy the built system

End state

  • the built system is deployed and running

Steps

  • run morph deploy with the correct arguments

The Build a Baserock System section of the Developing with Baserock page at baserock.org shows how to deploy to a VM. To see how to deploy to a real server deployment node, we need a bit more

# morph help deploy
Usage: morph [options] deploy TYPE SYSTEM LOCATION [KEY=VALUE]

Deploy a built system image.

Command requires a minimum of three arguments:

morph deploy TYPE SYSTEM LOCATION

where
* TYPE is type of deployment
* SYSTEM is name of the system morphology to deploy
* LOCATION is the destination of the deployed system

For more details we can look at the morph deploy section of the Morph Reference Manual.

// To do: we need information about the nfs-boot write extension: how to use it and what it expects from the server

// To do: get the correct content in the command output below

The command we need to run is

bash-4.2# morph deploy --no-git-update nfsboot base-system-armv7-versatile \
          blbg-1 NFSBOOT_CONFIGURE=yes HOSTNAME=SOMEHOST

Show the built system running.