Getting Started on Kubernetes

AppFormix provides resource control and visibility for hosts, pods, containers, services, and more in a Kubernetes cluster.

This guide explains how to install AppFormix for a Kubernetes cluster. See the Overview for general requirements before reading this guide.

Requirements

Easy Installation

Installation consists of the following steps:

  1. Install AppFormix
  2. Configure AppFormix

1. Install AppFormix

Ansible is used to deploy the software to the compute node(s) and Controller host.

An Ansible inventory file describes groups of hosts in your cluster. AppFormix requires two groups "compute" and "appformix_controller". For example:

    [appformix_controller]
    appformix01

    [compute]
    compute01
    compute02
    compute03

Additional options may be specified to configure how to login to a host. For more information, refer to Ansible inventory documentation.

The following commands may be executed on the Controller host, or any host that has Ansible and can access the compute node(s) and Controller host via ssh.

  1. Unpack the tarball, and change to the created directory:

    tar xzf appformix-<version>.tar.gz
    cd appformix-<version>
    
  2. Install components on the Controller host and the compute nodes:

    ansible-playbook -i <inventory_file> appformix_kubernetes.yml
    

2. Configure AppFormix

Initial configuration of AppFormix is performed using a simple, graphical installation wizard. Point your browser at the following URL, and click the "Install AppFormix" button.

http://<Controller_Host>:9000/

AppFormix must be configured to communicate with the OpenStack cluster. On the first page of the installation wizard, input the following settings:

kube-apiservier         URL to the Kubernetes API server

After clicking "Next", the next page will request information about where the AppFormix components are running. For single node AppFormix deployments, the fields will be pre-populated with the IP address of the Controller host on which the Dashboard is running.

Configuration settings for Kubernetes and AppFormix components may be changed after initial configuration by choosing 'Settings' from the User icon drop-down menu when logged in as an administrator.

Uninstall

If you want to uninstall AppFormix, complete the following:

  1. Uninstall Agent from compute node(s):

    ansible-playbook -i <inventory_file> compute_uninstall.yml
    
  2. Uninstall components from Controller host:

    ansible-playbook -i <inventory_file> -e 'appformix_state=absent' appformix_kubernetes.yml