This guide assumes that you already have a MaaS environment set up and working with windows images uploaded. If you do not, head over to How to deploy MAAS, finish that and come back when you are finished.

Prerequisites:

• MaaS set up
• At least 5 nodes registered in MaaS
• MaaS API Key (found at http://MAAS_IP/MAAS/account/prefs/)
• Gerrit account
• Upstream port 29418 must be accessible

We are going to go through all the steps required to stand up a new Hyper-V CI. At the end of this guide, you should have:

• one Zuul server
• one jenkins server configured to connect to zuul
• one active directory controller
• various devstack and hyper-v nodes deployed by jenkins jobs

Note, this guide does not cover high availability. That is a topic for a different howto.

First things first. We need a working juju environment to start things off.

We should strive to use the latest stable juju when deploying a new CI environment. However, if any blocking bugs arise, a bug report should be filed against juju-core. Blocking bugs are usually fixed and backported to stable promptly.

• adding the juju stable ppa:

sudo apt-add-repository -y ppa:juju/stable
sudo apt-get update && sudo apt-get install -y juju-core

• create a juju config boilerplate

juju init

• edit the boilerplate located at $HOME/.juju/environments.yaml and set the following configuration:

maas:
      type: maas
      maas-server: 'http://<ip>/MAAS/'
      maas-oauth: '<Key you got from http://<MAAS IP>/MAAS/account/prefs/>'
      bootstrap-timeout: 1800
      enable-os-refresh-update: true
      enable-os-upgrade: true

• switch to MaaS environment

juju switch maas

• bootstrap juju

juju bootstrap --debug --show-log