Canonical MAAS

MAAS from Canonical is an open-source tool, server orchestration tool. It’s designed to allow administrators to build a data center from on-premises, bare-metal servers where large networks of individual units can be discovered, deployed, and reconfigured.

Integrating MAAS and Morpheus

Integrating MAAS with Morpheus is a simple process requiring the MAAS API URL and API Key. We’ll start by gathering what we need from the MAAS UI, then move back into Morpheus to store the required details.

We can gather the API URL by clicking on the username in the upper-right corner of the MAAS UI window. From this preferences page, click on “API keys” as shown in the screenshot:

../../../_images/1prefPage.png

From the API keys page, select the displayed key and copy it. Alternatively, you can click the copy button in the UI to add the full key to your clipboard. Store this key in an accessible location for a later step.

../../../_images/2maasApi.png

In addition to the API key, we need the MAAS API URL. This URL is given in the format http://<maas-hostname-or-ip>:5240/MAAS/api/2.0. Plug the hostname or host IP address into the example shown in the previous sentence and store the complete API URL for use in the next step.

In Morpheus, navigate to the list of integrated Clouds and start a new MAAS Cloud integration:

  1. Infrastructure > Clouds
  2. Click + ADD
  3. Select “MAAS”
  4. Click NEXT

On the “CREATE CLOUD” modal, you must at least give a friendly name for the Cloud in Morpheus, MAAS API URL and API KEY. An example is shown below:

../../../_images/3createCloud.png

Tip

You’ll know the credentials are entered correctly when your list of MAAS resource pools is synced in as you can see in the example screenshot.

Click NEXT and add this new Cloud to an existing Group or create a new Group for it. Once you advanced past the end of the wizard, the Cloud is added and Morpheus begins to inventory (if you’ve opted to inventory when adding the Cloud).

../../../_images/4cloudDetail.png