Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

This document provides concepts and procedures for deploying an NFVi with Airship 1 Installer in a bare metal infrastructure.

...

  • Introduction to the upstream tool set used by the Airship Installer, for example, Airship Projectairshipctl, OpenStack Helm, Treasuremaptreasuremap, and so on.
  • Instructions for preparing a site manifest in declarative YAML, including hardware profile and software stack, according to the hardware infrastructure and software component model specified in the NFVi reference model and reference architecture.
  • Instructions for customizing the settings in the site manifest.
  • Instructions for running the deployment script.
  • Instructions for setting up a CI/CD pipeline for automating deployment and testing.

Intel Pod 17 Air-pod01 in the LaaS lab is used to deploy reference NFVi. Therefore, the examples in this document are based on the hardware profile of Intel Pod 17air-pod01. Instructions are either referenced (to the upstream document) or provided (in this document) so that the reader can modify the settings of the hardware profile and/or software stack accordingly.

Airship

Airship is a collection of loosely coupled and interoperable open source tools that declaratively automate cloud provisioning.

...

For more information, see https://www.airshipit.org/.

OpenStack Helm

OpenStack-Helm is a set of Helm charts that enable deployment, maintenance, and upgrading of loosely coupled OpenStack services and their dependencies individually or as part of complex environments.

For more information, see https://wiki.openstack.org/wiki/Openstack-helm/.

Airshipctl

TBD

Treasuremap

Treasuremap is a deployment reference as well as CI/CD project for Airship.

...

For more information, see https://airship-treasuremap.readthedocs.io/ .

Site Setup

Follow the System Requirements and Setup in the Airship 2 "Deploy a Bare Metal Cluster" cookbook to ensure the system requirements are met, networks and disks are properly configured, and install the airshipctl executable and required third party library and tools.

In the air-pod01, the jumphost is used as the build node. It is recommended to install the Apache server on the jump host for the hosting the ephemeral node ISO image to be generated during the Airship deployment.

Airship requires internet access on the OAM network for downloading images and packages unless the user has created downstream repositories for the same purpose.  In the LaaS Lab, the only network that has internet access is the lab management network (refer to the air-pod01 network architecture).  Addition steps must be followed to create a gateway/router on the jumphost to enable internet access on the OAM network.

  1.  Create the lab management and OAM network on the jump host.  Below is an example of netplan cofniguration:
Code Block
languageyml
title/etc/netplan/50-cloud-init.

...

yaml
network:
    version: 2
    renderer: networkd
    ethernets:
        # Lab management network
        eno49:
          dhcp4: yes
        # PXE network
        eno50:
           addresses:
            - 10.200.212.20/24
        ens1f0:
            match:
                macaddress: 3c:fd:fe:ef:10:29
            mtu: 9100
            set-name: ens1f0
        ens1f1:
            match:
                macaddress: 3c:fd:fe:ef:10:29
            mtu: 9100
            set-name: ens1f1
        ens4f0:
            match:
                macaddress: 3c:fd:fe:ef:0e:b9
            mtu: 9100
            set-name: ens4f0
        ens4f1:
            match:
                macaddress: 3c:fd:fe:ef:0e:b9
            mtu: 9100
            set-name: ens4f1
    bonds:
        bond0:
            interfaces:
            - ens1f1
            - ens4f0
            mtu: 9214
            parameters:
                lacp-rate: fast
                mode: 802.3ad
                transmit-hash-policy: layer3+4
    vlans:
        # oam network
        bond0.201:
            addresses:
            - 10.200.201.1/24
            id: 201
            link: bond0
            mtu: 9100
            nameservers:
                addresses:
                - 8.8.8.8
                - 8.8.4.4

2.  Enable IP forwarding by editing /etc/sysctl.conf to add or ubcomment the following line:

Code Block
languagebash
net.ipv4.ip_forward=1


3. Enable IP masquerading

Code Block
languagebash
sudo iptables -t nat -A POSTROUTING -o eth1 -j MASQUERADE
sudo iptables -A FORWARD -i eth1 -o eth0 -m state --state RELATED,ESTABLISHED -j ACCEPT
sudo iptables -A FORWARD -i eth0 -o eth1 -j ACCEPT


To save settings to iptables either by installing iptables-persistent:

Code Block
languagebash
sudo apt-get install iptables-persistent

if it was already installed please update setting by running:

Code Block
languagebash
sudo dpkg-reconfigure iptables-persistent

or execute the following command:
Code Block
languagebash
sudo iptables-save > /etc/iptables/rules.v4


Manifest

TBD


Airship is a declarative way of automating the deployment of a site. Therefore, all the deployment details are defined in the manifests.

...

Global

Global manifests, defined in Airship Treasuremap, contain base configurations common to all sites. The versions of all Helm charts and Docker images, for example, are specified in versions.yaml.

Type

The type cntt will eventually support specifications published by the CNTT community. See CNTT type.

Site

The site documents reside under the site folder. While the folder already contains some sites, and will contain more in the future, the intel-pod17 site shall be considered the Airship OPNFV reference site. See more at POD17 manifests.

...

  data:
site_type: cntt

repositories:
global:
revision: v1.7
url: https://opendev.org/airship/treasuremap.git

Deployment

As Airship is tooling to declaratively automate site deployment, the automation from the installer side is light. See deploy.sh.

...

  $ tools/deploy.sh
Usage: deploy.sh <deploy_site|update_site>

CI/CD

TODO: Describe pipelines and approach

https://build.opnfv.org/ci/view/airship/

OpenStack

The treasuremap repository contains a wrapper script for running OpenStack clients tools/openstack. The wrapper uses heat image that already has openstack client installed.

...