Tencent Cloud

HPC

Last updated: 2024-02-01 10:16:40

Overview
Add-on description
HorizontalPodCronscaler (HPC) is an add-on to modify the number of replicas of K8S workload. Used in conjunction with HPC CRD resources, it can support scheduled actions in seconds.
Add-on features
Configures "Pod Range" (when the associated object is HPA) or "Desired Number of Pods" (when the associated object is Deployment or StatefulSet).
Sets an “Exceptional Time”. The smallest granularity of the setting is Day. Multiple exceptional times are allowed.
Specifies whether the scheduled task runs only once.
Kubernetes objects deployed in a cluster
Deploying HPC Add-on in a cluster will deploy the following Kubernetes objects in the cluster:
Kubernetes Object
Type
Required Resources
Namespaces
horizontalpodcronscalers.autoscaling.cloud.tencent.com
CustomResourceDefinition
-
-
hpc-leader-election-role
Role
-
kube-system
hpc-leader-election-rolebinding
RoleBinding
-
kube-system
hpc-manager-role
ClusterRole
-
-
hpc-manager-rolebinding
ClusterRoleBinding
-
-
cronhpa-controller-manager-metrics-service
Service
-
kube-system
hpc-manager
ServiceAccount
-
kube-system
tke-hpc-controller
Deployment
100mCPU, 100Mi/pod
kube-system
Limits
Environment requirements
Note: 
If you create a cluster of version 1.12.4 or later, you can use the cluster directly without any parameter changes.
This add-on is supported only by Kubernetes 1.12 or later versions.
The launch parameters of kube-apiserver must be set as follows: --feature-gates=CustomResourceSubresources=true.
Node Requirements
The HPC add-on follows the timezone of the associated server. Please make sure that the /etc/localtime file exists in the node.
By default, two HPC Pods are installed on different nodes. Therefore at least two nodes are required.
Requirement on resource to be controlled
When you create an HPC resource, please make sure that the workload (K8S resource) to be controlled exists in the cluster.
Component Permission Description
Permission Description
The permission of this component is the minimal dependency required for the current feature to operate.
Permission Scenarios
Feature
Involved Object
Involved Operation Permission
Monitoring changes of horizontalpodcronscalers
horizontalpodcronscalers
create/delete/get/list/patch/watch
The replicas of deployments/statefulsets that required modification
deployments/statefulsets
get/list/patch/watch
Modifying the minReplicas/maxReplicas of horizontalpodautoscalers
horizontalpodautoscalers
get/list/patch/watc
Synchronizing the events of HPC scheduled task execution
events
create/patch
Permission Definition
apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  creationTimestamp: null
  name: hpc-manager-role
rules:
- apiGroups:
  - ""
  resources:
  - events
  verbs:
  - create
  - patch
- apiGroups:
  - apps
  resources:
  - deployments
  verbs:
  - get
  - list
  - patch
  - watch
- apiGroups:
  - apps
  resources:
  - statefulsets
  verbs:
  - get
  - list
  - patch
  - watch
- apiGroups:
  - autoscaling
  resources:
  - horizontalpodautoscalers
  verbs:
  - get
  - list
  - patch
  - watch
- apiGroups:
  - autoscaling.cloud.tencent.com
  resources:
  - horizontalpodcronscalers
  verbs:
  - create
  - delete
  - get
  - list
  - patch
  - update
  - watch
- apiGroups:
  - autoscaling.cloud.tencent.com
  resources:
  - horizontalpodcronscalers/status
  verbs:
  - get
  - patch
  - update
- apiGroups:
  - apiextensions.k8s.io
  resources:
  - customresourcedefinitions
  resourceNames:
  - horizontalpodcronscalers.autoscaling.cloud.tencent.com
  verbs:
  - get
  - list
  - delete
  - watch
Directions
Installing HPC
1. Log in to the TKE console and select Cluster in the left sidebar.
2. On the “Cluster Management page, click the ID of the target cluster to go to the cluster details page.
3. In the left sidebar, click Add-on Management to go to the Add-on List page.
4. On the "Add-on List" page, click Create, On the "Create Add-on" page that appears, select HPC.
5. Click Done.
Examples
Creating a scheduled task resource that associated with Deployment
The example is as follows:
apiVersion: autoscaling.cloud.tencent.com/v1
kind: HorizontalPodCronscaler
metadata:
  name: hpc-deployment
  namespace: default 
spec:
  scaleTarget:
    apiVersion: apps/v1
    kind: Deployment
    name: nginx-deployment
    namespace: default 
  crons:
- name: "scale-down"
  excludeDates:
    - "* * * 15 11 *"
    - "* * * * * 5"
  schedule: "30 */1 * * * *"
  targetSize: 1
- name: "scale-up"
  excludeDates:
    - "* * * 15 11 *"
    - "* * * * * 5"
  schedule: "0 */1 * * * *"
  targetSize: 3
﻿
Creating a scheduled task resource that associated with StatefulSet
The example is as follows:
apiVersion: autoscaling.cloud.tencent.com/v1
kind: HorizontalPodCronscaler
metadata:
  name: hpc-statefulset
  namespace: default
spec:
  scaleTarget:
    apiVersion: apps/v1
    kind: Statefulset
    name: nginx-statefulset
    namespace: default
  crons:
  - name: "scale-down"
    excludeDates:
      - "* * * 15 11 *"
    schedule: "0 */2 * * * *"
    targetSize: 1
  - name: "scale-up"
    excludeDates:
      - "* * * 15 11 *"
    schedule: "30 */2 * * * *"
    targetSize: 4
﻿
Creating a scheduled task resource that associated with HPA
The example is as follows:
apiVersion: autoscaling.cloud.tencent.com/v1
kind: HorizontalPodCronscaler
metadata:
  labels:
    controller-tools.k8s.io: "1.0"
  name: hpc-hpa
spec:
  scaleTarget:
    apiVersion: autoscaling/v1
    kind: HorizontalPodAutoscaler
    name:  nginx-hpa
    namespace: default
  crons:
  - name: "scale-up"
    schedule: "30 */1 * * * *"
    minSize: 2
    maxSize: 6
  - name: "scale-down"
    schedule: "0 */1 * * * *"
    minSize: 1
    maxSize: 5
﻿
Scheduled duration settings
Field Name
Required
Value Range
Allowed Special Characters
Seconds
Yes
0 - 59
* / , -
Minutes
Yes
0 - 59
* / , -
Hours
Yes
0 - 23
* / , -
Day of month
Yes
1 - 31
* / , - ?
Month
Yes
1 - 12 or JAN - DEC
* / , -
Day of week
Yes
0 - 6 or SUN - SAT
* / , - ?

tencent cloud

Recent Pages

HPC

Overview

Add-on description

Add-on features

Kubernetes objects deployed in a cluster

Limits

Environment requirements

Node Requirements

Requirement on resource to be controlled

Component Permission Description

Permission Description

Permission Scenarios

Permission Definition

Directions

Installing HPC

Examples

Creating a scheduled task resource that associated with Deployment

Creating a scheduled task resource that associated with StatefulSet

Creating a scheduled task resource that associated with HPA

Scheduled duration settings

Was this page helpful?

Was this page helpful?

Kubernetes Object	Type	Required Resources	Namespaces
horizontalpodcronscalers.autoscaling.cloud.tencent.com	CustomResourceDefinition	-	-
hpc-leader-election-role	Role	-	kube-system
hpc-leader-election-rolebinding	RoleBinding	-	kube-system
hpc-manager-role	ClusterRole	-	-
hpc-manager-rolebinding	ClusterRoleBinding	-	-
cronhpa-controller-manager-metrics-service	Service	-	kube-system
hpc-manager	ServiceAccount	-	kube-system
tke-hpc-controller	Deployment	100mCPU, 100Mi/pod	kube-system

Feature	Involved Object	Involved Operation Permission
Monitoring changes of horizontalpodcronscalers	horizontalpodcronscalers	create/delete/get/list/patch/watch
The replicas of deployments/statefulsets that required modification	deployments/statefulsets	get/list/patch/watch
Modifying the minReplicas/maxReplicas of horizontalpodautoscalers	horizontalpodautoscalers	get/list/patch/watc
Synchronizing the events of HPC scheduled task execution	events	create/patch

Field Name	Required	Value Range	Allowed Special Characters
Seconds	Yes	0 - 59	* / , -
Minutes	Yes	0 - 59	* / , -
Hours	Yes	0 - 23	* / , -
Day of month	Yes	1 - 31	* / , - ?
Month	Yes	1 - 12 or JAN - DEC	* / , -
Day of week	Yes	0 - 6 or SUN - SAT	* / , - ?

tencent cloud

Sign Up

Log in

Recent Pages

HPC

Overview

Add-on description

Add-on features

Kubernetes objects deployed in a cluster

Limits

Environment requirements

Node Requirements

Requirement on resource to be controlled

Component Permission Description

Permission Description

Permission Scenarios

Permission Definition

Directions

Installing HPC

Examples

Creating a scheduled task resource that associated with Deployment

Creating a scheduled task resource that associated with StatefulSet

Creating a scheduled task resource that associated with HPA

Scheduled duration settings

Was this page helpful?

Was this page helpful?