How to use availability zones
This article will help you learn:
- How to list availability zones
- How to add an availability zone
- How to edit an existing availability zone
- How to delete an existing availability zone
- How to assign a machine to an availability zone
- How to allocate a machine in a particular zone
You can find more theory about availability zones elsewhere in this documentation set.
How to list availability zones
To see a list of availability zones, select AZs from the top tab bar.
How to add an availability zone
To create a zone:
-
Select AZs.
-
Select Add AZ.
-
Enter a Name for the zone.
-
Optionally enter a Description for the zone.
-
Select Add AZ to register your changes.
How to edit an existing availability zone
To edit a zone:
-
Select AZs.
-
Select an AZ by clicking on its name.
-
Select Edit on the far right.
-
Update the Name for the zone, if desired.
-
Optionally update the Description for the zone, if desired.
-
Select Update AZ to register your changes.
How to delete an existing availability zone
To delete a zone:
-
Select AZs.
-
Select an AZ by clicking on its name.
-
Select Delete AZ in the top right corner.
-
Update the Name for the zone, if desired.
-
Confirm by selecting the red Delete AZ button which appears. Once you make this selection, the AZ will be deleted and no undo is possible.
How to assign a machine to an availability zone
To assign a machine to a zone:
-
Select Machines.
-
Select one or more machines by clicking their checkboxes.
-
Select Categorise >> Set zone*.
-
In the popup dialogue, choose the Zone from the dropdown.
-
Select Set zone for machine to register your changes.
How to allocate a machine in a particular zone
Allocating a machine in a particular zone can only be done via the MAAS CLI.
How to list availability zones
To see a list of availability zones, select AZs from the top tab bar.
How to add an availability zone
To create a zone:
-
Select AZs.
-
Select Add AZ.
-
Enter a Name for the zone.
-
Optionally enter a Description for the zone.
-
Select Add AZ to register your changes.
How to edit an existing availability zone
To edit a zone:
-
Select AZs.
-
Select an AZ by clicking on its name.
-
Select Edit on the far right.
-
Update the Name for the zone, if desired.
-
Optionally update the Description for the zone, if desired.
-
Select Update AZ to register your changes.
How to delete an existing availability zone
To delete a zone:
-
Select AZs.
-
Select an AZ by clicking on its name.
-
Select Delete AZ in the top right corner.
-
Update the Name for the zone, if desired.
-
Confirm by selecting the red Delete AZ button which appears. Once you make this selection, the AZ will be deleted and no undo is possible.
How to assign a machine to an availability zone
To assign a machine to a zone:
-
Select Machines.
-
Select one or more machines by clicking their checkboxes.
-
Select Take action >> Set zone*.
-
In the popup dialogue, choose the Zone from the dropdown.
-
Select Set zone for machine to register your changes.
You can also change the zone for a machine under Machines >> “machine-name” >> Configuration >> Edit.
How to allocate a machine in a particular zone
Allocating a machine in a particular zone can only be done via the MAAS CLI.
How to list availability zones
To see a list of availability zones, enter the following command:
maas $PROFILE zones read \
| jq -r '(["ZONE","NAME","DESCRIPTION"]
| (., map(length*"-"))), (.[] | [.id, .name, .description])
| @tsv' | column -t
which produces output similar to:
ZONE NAME DESCRIPTION
---- ---- -----------
5 BizOffice
1 default
4 Inventory
2 Medications
3 Payroll
6 ProServ
How to add an availability zone
To create a zone, enter the following command:
maas $PROFILE zones create name=$ZONE_NAME description=$ZONE_DESCRIPTION
How to edit an existing availability zone
To edit a zone, enter a command similar to the following:
maas $PROFILE zone update $OLD_ZONE_NAME name=$NEW_ZONE_NAME \
description=$ZONE_DESCRIPTION
How to delete an existing availability zone
To delete a zone, enter a command like this:
maas $PROFILE zone delete $ZONE_NAME
How to assign a machine to an availability zone
To assign a machine to a zone, first retrieve the machine’s system ID like this:
maas PROFILE machines read | jq '.[] | .hostname, .system_id'
Then enter the following command, using the system ID you just retrieved:
maas admin machine update $SYSTEM_ID zone=$ZONE_NAME
How to deploy a machine in a particular zone
To deploy in a particular zone:
- First acquire the machine, assigning it to the particular zone:
maas $PROFILE machines allocate zone=$ZONE_NAME system_id=$SYSTEM_ID
- Then deploy the machine as normal:
maas $PROFILE machine deploy system_id=$SYSTEM_ID
Last updated a month ago.