autoqube-kubernetes 1.0.2

Kubernetes cluster

Currently the cluster creation is supported only on AWS cloud platform.

For creating a new Kubernetes cluster, the following parameters are needed:

• cloud_provider : The cloud provider on which the cluster needs to be created.

• cluster_config : The configuration details for the cluster.

• env_config : The environment configuration for storage of cloud provider essential keys.

A typical cluster configuration file would be like

config = {
    "cloud_provider": "AWS",
    "cluster_config": {
        'node-count':  2,
        'master-size': 't2.small',
        'master-zones': 'us-west-2a',
        'zones':  'us-west-2a',
        'name': 'aq.autoqube.io',
        'node-size': 't2.small',
        'ssh-public-key': '/Users/autoqube/.ssh/id_rsa.pub',
        'dns-zone': 'aq.autoqube.io',
    },
    "env_config": {
        'AWS_ACCESS_KEY_ID': '*********************',
        'AWS_SECRET_ACCESS_KEY': '***********************',
        'AWS_REGION': 'us-west-2',
        'KUBECONFIG': '/Users/autoqube/kubernetes/aq.autoqube.io/kubeconfig',
        'KOPS_STATE_STORE': 's3://agent-kops-store'
    },
}

For better understanding or debugging of various processes running behind, setup a logging functionality.

from autoqube_kubernetes import KubernetesHandler
import config
import logging

root_logger = logging.getLogger()
console_handler = logging.StreamHandler()

root_logger.setLevel(logging.INFO)
root_logger.addHandler(console_handler)

kubernetes_handler = KubernetesHandler(config)
kubernetes_handler.create_cluster() # Creation of cluster with the above configuration.
# kubeconfig will be stored in the path specified in the configuration.
kubernetes_handler.delete_cluster() # Deletion of cluster with the above configuration.

Load Testing

• Currently only ‘jmeter’ load testing is supported on kubernetes cluster.

• Load testing using jmeter on a kubernetes cluster has been inspired from the following blog.

• The results of the load test can be visually seen on grafana service dashboards.

• The templates for deployment of various kubernetes objects required for jmeter load testing can be downloaded from Jmeter Load Test Templates.

• Extract the downloaded templates and place them in location accessible by python.

• The following parameters are needed for load testing

  • load_config - The configuration details about type of load test and the templates for kubernetes objects.

  • test_file_config - The configuration details about the test files for load test.

A sample configuration would be like

load_config = {
     'test_type': 'jmeter',
     'templates_path': '/Users/autoqube/kubernetes/load_testing/k8s_templates/jmeter/'
 }
 test_file_config = {
     'test_files': ['./tmp/sample.jmx', './tmp/sample.csv']
 }

KubernetesHandler will create the necessary objects on cluster and run load tests.

 # After creation of kubernetes cluster using 'kubernetes_handler'.
 kubernetes_handler.create_load_test(load_config)
 # Creates pods, deployments, services and other objects required for
 # load testing on cluster.

 kubernetes_handler.run_load_test(test_file_config)
 # Run load tests using the test files provided in the configuration

 kubernetes_handler.destroy_load_test(load_config)
# Once the tests are complete, all the resources created can be destroyed
# and only empty cluster will remain.