Using Tags with MAAS and Juju in Ubuntu Server 14.04 LTS (englanninkielinen)

Tämän artikkelin on kirjoittanut Mark Wenning, kanoninen kenttäinsinööri.

Tunnisteet MAAS- ja Juju-klustereiden tarkempaan hallintaan

MAAS toteuttaa solmujen fyysisiin ominaisuuksiin perustuvan tunnistejärjestelmän. Tunnisteita koskevassa MAAS-dokumentaatiossa käsitellään tätä, lähinnä olemassa olevien laitteistotunnisteiden käytön näkökulmasta, kun kuvausvaihtoehto on –rajoitukset. 

Uusia tunnisteita voidaan luoda myös manuaalisesti, mikä helpottaa MAAS- ja Juju-klustereiden käyttöönottoa ja hallintaa.    

Jos esimerkiksi haluat käynnistää Jujun MAAS-klusterissa ja pakottaa käynnistyssolmun tiettyyn koneeseen, voit merkitä solmun ensin ja sitten käynnistää käyttämällä -tunnistetta rajoituksena.

$ juju bootstrap --constraints "tags=my-juju-bootstrap-node" –debug

Huomaa, että kun olet asettanut tällaisen tagirajoituksen, seuraavat juju-komennot yrittävät käyttää rajoitusta, kunnes peruutat sen:

$ juju set-constraints "tags="

Toinen tunnisteiden käyttö on merkitä useita solmuja samalla tunnisteella ja ottaa sitten käyttöön vain näissä solmuissa:

$ juju deploy mysql –constraints "tags=my-juju-Dell-nodes" --debug

Kirjaudu MAAS-komentoriviliittymään

Ennen kuin voit käyttää näitä komentoja, sinun on kirjauduttava MAAS-aluepalvelimeen:

$ maas login <profile-name> <host-url> <apikey>

• <Profiilinimi> voi olla mikä tahansa, normaalisti tämä on "Maas"
• <host-url> on MAAS:n alueellisen ohjaimen URL-osoite sekä API ja versio (elihttps://192.168.0.2/MAAS/api/1.0).
• <apikey> on MAAS-ohjelmointirajapinta tai oauth-avain, joka luotiin, kun MAAS-alueellinen ohjain rakennettiin.

Lisätietoja on https://maas.io/docs/ .

Kun olet valmis, kirjaudu ulos MAA:n komentoriviliittymän ympäristöstä suorittamalla komento- ja loppusijoitus

$ maas logout maas

Tunnisteiden luominen "kuvaus" -vaihtoehdolla

Kuten tunnisteita koskevassa MAAS-dokumentaatiossa on käsitelty, tunnisteita voidaan luoda ja määrittää XPath-lausekkeiden avulla solmuun liittyvien lshw-tietojen (XML-muotoon muotoiltuna) perusteella.   Pääset tietoihin kunkin solmun verkkosivun alaosasta napsauttamalla Näytä löydetyt tiedot -linkkiä Raakaetsintätiedot-kohdassa.   Osa yhden solmuni lshw-tiedoista on seuraava:

...

<lshw:node id="t410" claimed="true" class="system" handle="DMI:0100">
<lshw:description>System</lshw:description>
<lshw:product>PowerEdge T410 ()</lshw:product>
<lshw:vendor>Dell Inc.</lshw:vendor>
<lshw:serial>RHXT410</lshw:serial>
<lshw:width units="bits">64</lshw:width>
<lshw:configuration>
<lshw:setting id="boot" value="normal"/>
<lshw:setting id="chassis" value="server"/>
<lshw:setting id="uuid" value="44454C4C-4800-1058-8054-D2C04F343130"/>
</lshw:configuration>
<lshw:capabilities>
...

Voit lisätä kuvaavia tunnisteita järjestelmän solmuihin suorittamalla seuraavat toimet:

$ maas maas tags new name="Dell_Machine" definition='//node[@class="system"]/vendor = "Dell Inc."'
$ maas maas tags new name="Intel_Machine" definition='//node[@class="system"]/vendor = "Intel Corp."'
$ maas maas tags new name="Virtual_Machine" definition='//node[@class="system"]/vendor = "QEMU"'
$ maas maas tags new name="Laptop" definition='//node[@class="system"]/description = "Laptop"'
$ maas maas tags new name="Rack_Mount" definition='//node[@class="system"]/description = "Rack Mount Chassis"'
$ maas maas tags new name="Mini_Tower" definition='//node[@class="system"]/description = "Mini Tower Computer"'
$ maas maas tags new name="System" definition='//node[@class="system"]/description = "System"'
$ maas maas tags new name="Desktop" definition='//node[@class="system"]/description = "Desktop Computer"'
$ maas maas tags new name="Blade" definition='//node[@class="system"]/description = "Multi-system"'
$ maas maas tags new name="Intel_CPU" definition='//node[@class="processor"]/vendor = "Intel Corp."'
$ maas maas tags new name="AMD_CPU" definition='//node[@class="processor"]/vendor = "Advanced Micro Devices [AMD]"'
$ maas maas tags new name="64bit" definition='//node[@class="system"]/width="64"'
$ maas maas tags new name="32bit" definition='//node[@class="system"]/width="32"'

Nämä merkitsevät yhteensopivat solmut tunnisteilla Dell_Machine, Intel_Machine, Virtual_Machine, Rack_Mount, System, Desktop, Laptop, Rack_Mount, Multi-system, 64bit ja/tai 32bit, ja niitä käytetään myös kaikkiin solmuihin, jotka lisätään myöhemmin.

Tunnisteiden luominen manuaalisesti

Uusi raakatunniste luodaan MAS-komentoriviliittymäkomennolla

$ maas <profile> tag new name="<tag-name>" [comment="<comment>"]

• <Profiili> on profiilin nimi, joka määritettiin kirjautumiskomennolla, yleensä "MAAS"
• <tag-name> on tunnisteen nimi
• <Kommentti> on valinnainen, mutta hyvä idea.

Huomaa, että emme käytä kuvausvaihtoehtoa tässä.   Niin:

$ maas maas tag new name="my-juju-node" comment="my new juju node"

Tämä tunnus voidaan määrittää manuaalisesti yhdelle tai useammalle järjestelmän solmulle.

Tunnisteiden määrittäminen

Voit määrittää tunnisteen solmulle tai solmuille suorittamalla komennon:

$ maas <profile> tag update-nodes <raw-tag-name> add="<system-id>"

• <Profiili> on kirjautumisen yhteydessä määritetty profiilin nimi.
• <raw-tag-name> on aiemmin luodun tunnisteen nimi
• <system-id> on solmun järjestelmätunnus.

<Järjestelmän tunnus>?  Mikä tuo on?

Miten solmun järjestelmätunnus löytyy?   Yksi tapa on luetella solmun tiedot ja poimia ne rakenteesta.  Maas CLI -komento

$ maas <profile> nodes list

• <Profiili> on kirjautumisen yhteydessä määritetty profiilin nimi.

tyhjentää JSON-muotoillun objektin (rakenneluettelon), joka sisältää kaikki solmujen tiedot.  Esimerkki:

$ maas maas nodes list

[
{
"status": 4,
"macaddress_set": [
{
"resource_uri": "/MAAS/api/1.0/nodes/node-2349c038-d792-11e3-8df4-0c54a5f0ce34/macs/bc%3A30%3A5b%3Ae3%3A21%3A15/",
"mac_address": "bc:30:5b:e3:21:15"
}
],
"hostname": "T110ii.maas",
"zone": {
"resource_uri": "/MAAS/api/1.0/zones/default/",
"name": "default",
"description": ""
},
"routers": [],
"netboot": true,
"cpu_count": 8,
"storage": 239825,
"owner": null,
"system_id": "node-2349c038-d792-11e3-8df4-0c54a5f0ce34",
"architecture": "amd64/generic",
"memory": 8192,
"power_type": "ipmi",
"tag_names": [
"use-fastpath-installer",
"my-juju-boostrap-node"
],
"ip_addresses": [
"192.168.0.53"
],
"resource_uri": "/MAAS/api/1.0/nodes/node-2349c038-d792-11e3-8df4-0c54a5f0ce34/"
},
]

Lähdön dekoodaus

Luettelon ensimmäisen solmun isäntänimimäärite on T110ii.maas. Olemme myös kiinnostuneita tämän solmun system-id-määritteestä: "system_id": "solmu-2349C038-D792-11E3-8DF4-0C54A5F0CE34"

Nyt voimme määrittää uuden tunnisteen tälle solmulle:

$ maas maas tag update-nodes my-juju-bootstap-node add=node-2349c038-d792-11e3-8df4-0c54a5f0ce34

Kuvan 1 tag-names-määritteessä luetellaan kaikki tälle solmulle määritetyt tunnisteet, mukaan lukien uusi.

Komentosarjat, joiden avulla voit lisätä tunnisteita

Options:

• --login : kirjaudu sisään ennen tunnisteiden määrittämistä solmuille. Tämä vaihtoehto edellyttää myös:
  • –oauth : API / OAUTH-avain, jota käytetään kirjautumiseen yllä ja mahdollisesti asetuksistasi riippuen,
  • –host_url : isännän URL-osoite, jota käytetään kirjautumiseen yllä
  • –profiili : profiilin nimi, jota käytetään yllä olevaan kirjautumiseen
• --remove_tags : poista tämän komentosarjan aiemmin määrittämät tunnisteet.
• --add_tags: lisää tunniste jokaiseen solmuun sen nimen perusteella

Viitteet

Komentoriviliittymä MAAS 1.6 -dokumentaatio:

https://maas.io/docs/maas-cli

Juju-dokumentaatio (rajoitteet) 

https://juju.ubuntu.com/docs/charms-constraints.html

https://juju.ubuntu.com/docs/reference-constraints.html