📝 Best Practice from the Smart Home Industry: Migration from Docker Swarm to Kubernetes. Explore this journey → close
  • English
    • English
    • 简体中文
    1. 1.Experience account: demo1 / Demo123
    2. 2.This account is only allowed to view parts of UI
    3. 3.It's recommended that install KubeSphere in your environment

You are viewing documentation for KubeSphere version:v3.0.0

KubeSphere v3.0.0 documentation is no longer actively maintained. The version you are currently viewing is a static snapshot. For up-to-date documentation, see the latest version.

  1. Documentation / 
  2. Project User Guide / 
  3. Application Workloads / 
  4. Kubernetes HPA (Horizontal Pod Autoscaling) on KubeSphere

Project User Guide

Last updated:
    Edit

    Kubernetes HPA (Horizontal Pod Autoscaling) on KubeSphere

    This document describes how to configure Horizontal Pod Autoscaling (HPA) on KubeSphere.

    The Kubernetes HPA feature automatically adjusts the number of Pods to maintain average resource usage (CPU and memory) of Pods around preset values. For details about how HPA functions, see the official Kubernetes document.

    This document uses HPA based on CPU usage as an example. Operations for HPA based on memory usage are similar.

    Prerequisites

    Create a Service

    1. Log in to the KubeSphere web console as project-regular and go to your project.

    2. Choose Services in Application Workloads on the left navigation bar and click Create on the right.

      create-service

    3. In the Create Service dialog box, click Stateless Service.

      stateless-service

    4. Set the Service name (for example, hpa) and click Next.

      service-name

    5. Click Add Container Image, set Image to mirrorgooglecontainers/hpa-example and click Use Default Ports.

      add-container-image

    6. Set the CPU request (for example, 0.15 cores) for each container, click √, and click Next.

      Note

      • To use HPA based on CPU usage, you must set the CPU request for each container, which is the minimum CPU resource reserved for each container (for details, see the official Kubernetes document). The HPA feature compares the average Pod CPU usage with a target percentage of the average Pod CPU request.
      • For HPA based on memory usage, you do not need to configure the memory request.

      cpu-request

    7. Click Next on the Mount Volumes tab and click Create on the Advanced Settings tab.

    Configure Kubernetes HPA

    1. Choose Deployments in Workloads on the left navigation bar and click the HPA Deployment (for example, hpa-v1) on the right.

      hpa-deployment

    2. Click More and choose Horizontal Pod Autoscaling from the drop-down list.

      horizontal-pod-autoscaling

    3. In the Horizontal Pod Autoscaling dialog box, configure the HPA parameters and click OK.

      • CPU Target Utilization: Target percentage of the average Pod CPU request.
      • Memory Target Usage: Target average Pod memory usage in MiB.
      • Min Replicas Number: Minimum number of Pods.
      • Max Replicas Number: Maximum number of Pods.

      In this example, CPU Target Utilization is set to 60, Min Replicas Number is set to 1, and Max Replicas Number is set to 10.

      Note

      Ensure that the cluster can provide sufficient resources for all Pods when the number of Pods reaches the maximum. Otherwise, the creation of some Pods will fail.

      hpa-parameters

    Verify HPA

    This section uses a Deployment that sends requests to the HPA Service to verify that HPA automatically adjusts the number of Pods to meet the resource usage target.

    Create a load generator Deployment

    1. Choose Workloads in Application Workloads on the left navigation bar and click Create on the right.

      create-deployment

    2. In the Create Deployment dialog box, set the Deployment name (for example, load-generator) and click Next.

      deployment-name

    3. Click Add Container Image and set Image to busybox.

      busybox

    4. Scroll down in the dialog box, select Start Command, and set Run Command to sh,-c and Parameters to while true; do wget -q -O- http://<Target Service>.<Target project>.svc.cluster.local; done (for example, while true; do wget -q -O- http://hpa.demo-project.svc.cluster.local; done).

      start-command

    5. Click √ and click Next.

    6. Click Next on the Mount Volumes tab and click Create on the Advanced Settings tab.

    View the HPA Deployment status

    1. After the load generator Deployment is created, choose Workloads in Application Workloads on the left navigation bar and click the HPA Deployment (for example, hpa-v1) on the right.

      The number of Pods automatically increases to meet the resource usage target.

      target-cpu-utilization

      pods-increase

    2. Choose Workloads in Application Workloads on the left navigation bar, click the three dots on the right of the load generator Deployment (for example, load-generator-v1), and choose Delete from the drop-down list. After the load-generator Deployment is deleted, check the status of the HPA Deployment again.

      The number of Pods decreases to the minimum.

      pods-decrease

    Note

    The system may require a few minutes to adjust the number of Pods and collect data.

    Edit HPA Configuration

    You can repeat steps in Configure HPA to edit the HPA configuration.

    Cancel HPA

    1. Choose Workloads in Application Workloads on the left navigation bar and click the HPA Deployment (for example, hpa-v1) on the right.

    2. Click the three dots on the right of Horizontal Pod Autoscaling and choose Cancel from the drop-down list.

      cancel-hpa

    Previous Previous : Container Image Settings
    What’s on this Page