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.
- Supported Kubernetes versions: 1.2
Installation consists of the following steps:
- Install AppFormix
- 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.
Unpack the tarball, and change to the created directory:
tar xzf appformix-<version>.tar.gz cd appformix-<version>
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.
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.
If you want to uninstall AppFormix, complete the following:
Uninstall Agent from compute node(s):
ansible-playbook -i <inventory_file> compute_uninstall.yml
Uninstall components from Controller host:
ansible-playbook -i <inventory_file> -e 'appformix_state=absent' appformix_kubernetes.yml