d5448b360e
1) UCP -> Airship 2) readthedocs.org -> readthedocs.io (there is redirect) 3) http -> https 4) attcomdev -> airshipit (repo on quay.io) 5) att-comdev -> openstack/airship-* (repo on github/openstack git) 6) many URLs have been verified and adjusted to be current 7) no need for 'en/latest/' path in URL of the RTD 8) added more info to some setup.cfg and setup.py files 9) ucp-integration docs are now in airship-in-a-bottle 10) various other minor fixes Change-Id: I8fe2ac12a3e104309e818d956313693c3ba6f7cc
132 lines
5.1 KiB
Markdown
132 lines
5.1 KiB
Markdown
[](https://quay.io/repository/airshipit/maas-region) Ubuntu MaaS Region Controller <br>
|
|
[](https://quay.io/repository/airshipit/maas-rack) Ubuntu MaaS Rack Controller
|
|
|
|
Overview
|
|
==================
|
|
|
|
The MaaS project attempts to build highly decoupled metal as a service containers for use on the Kubernetes platform. Today, we only break the MaaS service into the traditional region and rack controllers and breaking it down further is a work in progress.
|
|
|
|
Building Containers
|
|
===================
|
|
|
|
```
|
|
$ make build
|
|
```
|
|
|
|
Launching on Kubernetes
|
|
=======================
|
|
|
|
This will create the bridge necessary for MaaS provisioning (fixed with the name 'maas' rigt now) and launch the region controller
|
|
and rack controller containers on kubernetes using kubectl by leveraging the YAML manifests in maas/deployments.
|
|
|
|
```
|
|
$ make kuber_bridge
|
|
...
|
|
|
|
$ make kuber_deploy
|
|
sudo kubectl create -f deployment/maas-service.yaml
|
|
service "maas-region-ui" created
|
|
sudo kubectl create -f deployment/maas-region-deployment.yaml
|
|
deployment "maas-region" created
|
|
sudo kubectl create -f deployment/maas-rack-deployment.yaml
|
|
deployment "maas-rack" created
|
|
|
|
```
|
|
|
|
The provisioning network is fixed (and configured by kuber_bridge) as 10.7.200.0/24. To connect
|
|
external physical hardware to this network, simply place the network interface into the maas bridge, e.g:
|
|
|
|
```
|
|
brctl addif maas eth1
|
|
```
|
|
|
|
To destroy the kubernetes resources, you can run:
|
|
|
|
```
|
|
$ make kuber_clean
|
|
sudo kubectl delete deployment maas-region
|
|
deployment "maas-region" deleted
|
|
sudo kubectl delete deployment maas-rack
|
|
deployment "maas-rack" deleted
|
|
sudo kubectl delete service maas-region-ui
|
|
service "maas-region-ui" deleted
|
|
|
|
```
|
|
|
|
Once the region controller comes up, and you can login as admin/admin, you must configure a gateway within the UI on the
|
|
10.7.200.0 network, setting that to 10.7.200.1. You must also enable DHCP and set the primary rack controller to the
|
|
maas rack container booted (it will be a drop down choice). This will eventually be automated.
|
|
|
|
Running Containers
|
|
==================
|
|
|
|
```
|
|
$ make run_region
|
|
sudo docker run -d -p 7777:80 -v /sys/fs/cgroup:/sys/fs/cgroup:ro --privileged --name maas-region-controller maas-region:dockerfile
|
|
d7462aabf4d8982621c30d7df36adf6c3e0f634701c0a070f7214301829fa92e
|
|
```
|
|
|
|
```
|
|
$ make run_rack
|
|
sudo docker run -d -v /sys/fs/cgroup:/sys/fs/cgroup:ro --privileged --name maas-rack-controller maas-rack:dockerfile
|
|
fb36837cd68e56356cad2ad853ae517201ee3349fd1f80039185b71d052c5326
|
|
```
|
|
|
|
Region Bootstrap
|
|
================
|
|
|
|
The `scripts/create-provision-network.sh` script attempts to bootstrap both an admin user (with the password admin) but also creates a maas provisioning network matching the docker default, namely 172.16.86.0/24. Turning this into a more configurable setting and also allowing for a dedicated provisioning network that can be plugged in via bridging to an actual physical network is a work in progress. However, with the calls we do make you should be able to see the rack controller connected with an active dhcpd process running in the UI.
|
|
|
|
Retrieving Region Controller Details
|
|
====================================
|
|
|
|
Note that retrieving the API key may not be possible as MaaS region initialization is
|
|
delayed within the containers init startup. It may take 60 seconds or so in order
|
|
to retrieve the API key, during which you may see the following message:
|
|
|
|
```
|
|
$ make get_region_api_key
|
|
sudo docker exec maas-region-controller maas-region-admin apikey --username maas
|
|
WARNING: The maas-region-admin command is deprecated and will be removed in a future version. From now on please use 'maas-region' instead.
|
|
CommandError: User does not exist.
|
|
make: *** [get_region_api_key] Error 1
|
|
```
|
|
|
|
When the API is up and the admin user registered you will see the following:
|
|
|
|
```
|
|
$ make get_region_api_key
|
|
sudo docker exec maas-region-controller maas-region apikey --username admin
|
|
ksKQbjtTzjZrZy2yP7:jVq2g4x5FYdxDqBQ7P:KGfnURCrYSKmGE6k2SXWk4QVHVSJHBfr
|
|
```
|
|
|
|
You can also retrieve the region secret and IP address, used to initialize the
|
|
rack controller:
|
|
|
|
```
|
|
$ make get_region_secret
|
|
sudo docker exec maas-region-controller cat /var/lib/maas/secret && echo
|
|
2036ba7575697b03d73353fc72a01686
|
|
```
|
|
|
|
```
|
|
$ make get_region_ip_address
|
|
sudo docker inspect --format '{{ .NetworkSettings.Networks.bridge.IPAddress }}' maas-region-controller
|
|
172.16.86.4
|
|
```
|
|
|
|
Link Rack and Region
|
|
====================
|
|
|
|
Finally, with the output above we can link the region controller with the rack controller
|
|
by feeding the rack controller the endpoint and secret it requires. Shortly after MaaS
|
|
will initiate an image sync with the rack.
|
|
|
|
```
|
|
$ make register_rack -e URL=http://172.16.84.4 SECRET=2036ba7575697b03d73353fc72a01686
|
|
sudo docker exec maas-rack-controller maas-rack register --url http://172.16.84.4 --secret 2036ba7575697b03d73353fc72a01686
|
|
alan@hpdesktop:~/Workbench/att/airshipit/dockerfiles/maas$
|
|
```
|
|
|
|
Finally, to access your MaaS UI, visit http://172.0.0.1:7777/MAAS/ and login as admin/admin.
|