Package: autoqube-kubernetes
This library contains:Objects forCreating, updating and deleting a Kubernetes cluster.Deploying various objects on Kubernetes cluster.Running Jmeter Load tests on Kubernetes cluster.Table of ContentsInstallationPrerequisitesKubernetesHandlerKubernetes clusterLoad TestingKubernetesClientInstallationpython-autoqube_kubernetes is compatible with Python 3.x. It is listed onPyPi as ‘autoqube_kubernetes’. The recommended way to install is viapip:pip install autoqube_kubernetesPrerequisiteskops:  kops is a command line utility tool required to manage kubernetes cluster. The installation information is available atkops installation.kubectl: kubectl is a command line utility tool required to manage various objects on existing kubernetes cluster. The installation information is available atkubectl installation.dns-zone: A public hosted zone should be created for AWS which would be the same as the name of the cluster. Please refercreating dns-zone.KubernetesHandlerKubernetesHandler object will create, delete cluster and run load tests.Kubernetes clusterCurrently 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 likeconfig={"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.fromautoqube_kubernetesimportKubernetesHandlerimportconfigimportloggingroot_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 TestingCurrently only ‘jmeter’ load testing is supported on kubernetes cluster.Load testing using jmeter on a kubernetes cluster has been inspired from the followingblog.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 fromJmeter Load Test Templates.Extract the downloaded templates and place them in location accessible by python.The following parameters are needed for load testingload_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 likeload_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 configurationkubernetes_handler.destroy_load_test(load_config)# Once the tests are complete, all the resources created can be destroyed# and only empty cluster will remain.KubernetesClientKubernetesClient can be used to perform various actions on existing cluster like:Creating objects from yaml filesDestroying resources on clusterListing all the pods and services on clusterExecuting commands on a specific podCopy files to a specific podkubeconfig of a cluster is required.fromautoqube_kubernetesimportKubernetesClientkubernetes_client=KubernetesClient('/path/to/kubeconfig')namespace='autoqube'# Namespace on which the operations are to be performed.kubernetes_client.create_object('/path/to/yaml',namespace)# Creates object from yaml file.kubernetes_client.get_pod_list(namespace)# Lists all the pods.kubernetes_client.get_service_list(namespace)# Lists all the services.podname='autoqube-jmeter'commands_list=['cd ~','ls']kubernetes_client.execute_commands(podname,commands_list,namespace)# Executes the commands on a specific pod.kubernetes_client.destroy_all_resources(namespace)# Destroys all resources in a given namespace.