Airship utility CLI access
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.


Utility Containers

Utility containers give Operations staff an interface to an Airship environment that enables them to perform routine operations and troubleshooting activities. Utility containers support Airship environments without exposing secrets and credentials while at the same time restricting access to the actual containers.


Deploy OSH-AIO.

System Requirements

The recommended minimum system requirements for a full deployment are:

  • 16 GB RAM
  • 8 Cores
  • 48 GB HDD


  1. Add the below to /etc/sudoers.

     root    ALL=(ALL) NOPASSWD: ALL
     ubuntu  ALL=(ALL) NOPASSWD: ALL
  2. Install the latest versions of Git, CA Certs, and Make if necessary.

     sudo apt-get update
     sudo apt-get dist-upgrade -y
     sudo apt-get install --no-install-recommends -y \
         ca-certificates \
         git \
         make \
         jq \
         nmap \
         curl \
         uuid-runtime \
  3. Clone the OpenStack-Helm repositories.

    git clone
    git clone
  4. Configure proxies.

    In order to deploy OpenStack-Helm behind corporate proxy servers, add the following entries to openstack-helm-infra/tools/gate/devel/local-vars.yaml.

         http: http://username:password@host:port
         https: https://username:password@host:port

    Add the address of the Kubernetes API,, and .svc.cluster.local to your no_proxy and NO_PROXY environment variables.

     export no_proxy=${no_proxy},,.svc.cluster.local
     export NO_PROXY=${NO_PROXY},,.svc.cluster.local
  5. Deploy Kubernetes and Helm.

     cd openstack-helm

    Edit /etc/resolv.conf and remove the DNS nameserver entry (nameserver The Python setup client fails if this nameserver entry is present.

  6. Setup clients on the host, and assemble the charts.


    Re-add DNS nameservers back to /etc/resolv.conf so that the Keystone URLs DNS will resolve.

  7. Deploy the ingress controller.

  8. Deploy Ceph.

  9. Activate the namespace to be able to use Ceph.

  10. Deploy Keystone.

  11. Deploy Heat.

  12. Deploy Horizon.

  13. Deploy Glance.

  14. Deploy Cinder.

  15. Deploy LibVirt.

  16. Deploy the compute kit (Nova and Neutron).

  17. To run further commands from the CLI manually, execute the following to set up authentication credentials.

    export OS_CLOUD=openstack_helm
  18. Clone the Porthole repository to the openstack-helm project.

    git clone

To deploy utility pods

  1. Add and make the chart:

     cd porthole
     helm repo add <chartname> http://localhost:8879/charts
     make all
  2. Deploy Ceph-utility.

  3. Deploy Compute-utility.

  4. Deploy Etcdctl-utility.

  5. Deploy Mysqlclient-utility.

  6. Deploy Openstack-utility.



The PostgreSQL utility container is deployed as a part of Airship-in-a-Bottle (AIAB). To deploy and test postgresql-utility, see the PostgreSQL README.