breqwatr-deployment-tool 1.3

Description:

breqwatrdeploymenttool 1.3

Breqwatr Deployment Tool
The Breqwatr deployment tool is a toolkit for deploying Breqwatr OpenStack and
its accompanying services. The Breqwatr Deployment Tool is accessed from the
command line of an Ubuntu based OS using the command bwdt.
BWDT requires Docker, and either a removable drive provided by Breqwatr for
offline installs or a special key and ID for configuring the tool to pull files
and images from the upstream servers.
Installation
From PyPi
pip install breqwatr-deployment-tool

From GitHub
pip install git+https://github.com/breqwatr/breqwatr-deployment-tool.git

From Offline Media
The offline media will contain a file named bwdt.tar.gz. Unpack it to a
directory off of the removable media, then install with this command:
pip install --no-index --find-links <directory> breqwatr-deployment-tool


Features
Help
bwdt --help

Configuration
Breqwatr deployment tool supports both offline and online installations.
# Online Example
bwdt configure --key-id <key ID> --key <key> --online

# Offline Example
bwdt configure --offline --offline-path <directory of offline files>

Docker Registry
Start Registry
Launch a local Docker registry container
bwdt registry start

Sync Images to Registry
Sync an OpenStack image from Breqwatr's upstream online registry to a locally
hosted registry.
bwdt registry sync-openstack-image <registry url> <image name>

Sync all the required images for an OpenStack deployment to a local registry.
bwdt registry sync-all-openstack-images <registry url>

List Images in Registry
List the images in a local registry and their tags
bwdt registry list-images <registry url>

Ubuntu Apt
BWDT can deploy an optional private Apt service. This allows servers to run the
apt-get command to install software when they don't have an internet
connection.
The Breqwatr Apt container is not a complete mirror, but it does contain all
the required packages to deploy OpenStack along with some other useful ones.
The private Apt service also provides a mechanism to limit
OpenStack servers to the Ubuntu packages which Breqwatr has tested, ensuring
the stability of Breqwatr clouds.
Start Apt Container
bwdt apt start

Python Pip
Similar to the Apt container, BWDT can deploy a private Pip service.
Start Pip Container
bwdt pip start

PXE
BWDT can launch a PXE service based on DNSMasq and Nginx to enable fast,
offline installation of Ubuntu 18.04 on remote servers.
Start PXE Container
bwdt pxe start --interface enp0s25 --dhcp-start 10.1.0.90 --dhcp-end 10.1.0.99

Ansible
The Ansible service is used to deploy OpenStack and supporting tools.
Start Ansible Container
The --kolla-dir path helps to keep the files generated on the host.
mkdir -p /etc/kolla
bwdt ansible start \
--ssh-key-path <path to id_rsa> \
--cloud-yml-path <path to cloud.yml> \
--kolla-dir /etc/kolla

Deploy Openstack
The Ansible container leverages some open source Ansible libraries which often
take a long time to run. For that reason, these bwdt commands print
docker exec commands which need to be ran. Surrounding the commands with the
$() will make them auto-execute.
# generate kolla config
$(bwdt ansible openstack gen-config)

# bootstrap the servers
$(bwdt ansible openstack bootstrap)

# Deploy openstacl
$(bwdt ansible openstack deploy)

# Post-deploy
$(bwdt ansible openstack post-deploy)

Arcus
Arcus is Breqwatr's custom web UI, API, and cloud management daemon. Among
other uses, Arcus is a drop-in replacement of OpenStack Horizon.
Initialize the Datbase
bwdt arcus database-init --host <host> --admin-user root --admin-pass <password> --arcus-pass <password>

Create the Openstack service account
bwdt arcus create-service-account --cloud-fqdn <fqdn or vip> --bootstrap-password <password of bootstrap user> --sa-password <password for arcus SA>

Start the Arcus API service
bwdt arcus api start \
--openstack-fqdn <fqdn or vip for openstack> \
--sql-ip <database IP or FQDN> \
--sql-password <db password for arcus user> \
--rabbit-ip <server ip addr 1> --rabbit-ip <server 2> --rabbit-ip <server 3> \
--rabbit-pass <rabbitmq openstack user password>

Start the Arcus Client
bwdt arcus client start \
--openstack-ip <vip or fqdn to openstack> \
--glance-https \
--api-ip <vip or fqdn of arcus-api> \
--arcus-https \
--cert-path <path to HTTPS certificate file>
--cert-key-path <path to HTTPS certificate private key file>

Start the Arcus Mgr
The Arcus Mgr needs Kolla-Ansible's files to do some things like repairing
Mariadb when it goes down. Distribute those files to the control nodes first.
Also ensure the Arcus Manager has an SSH key which is authorized to each
OpenStack server.
# From the Deployment Server
bwdt ansible transfer-kolla-dir --server-ip <ip address>

# On the OpenStack control node
bwdt arcus mgr start \
--kolla-dir <directory of Kolla files> \
--openstack-ip <vip or fqdn of openstack> \
--rabbit-ip <server ip addr 1> --rabbit-ip <server 2> --rabbit-ip <server 3> \
--rabbit-pass <rabbitmq openstack user password> \
--sql-ip <database IP address> \
--sql-password <arcus user password for database> \
--ssh-key-path <authorized SSH key>


Docker Utilities
Build Offline Installation Media
To build your own offline install media on a USB stick for a dark-site cloud:
bwdt export-offline-media <path>

Download Cloud Config Template
To download a template cloud configuration for use with the Ansible container:
bwdt download cloud-yml <path>