Use annotations for load balancers

Annotations are a way to add custom, non-identifiable metadata to objects. They are used to configure additional behavior for Load Balancers service in Kubernetes clusters beyond the standard configuration offerings. Learn more about annotations in the official Kubernetes documentation.

You can add annotations via the command line (kubectl) or the Kubernetes service manifest using the annotations field as follows:

metadata: {

 annotations: {

 key: "value"

 }

}

Below, we have compiled annotations that apply to clusters created in Gcore:

​

Examples

Here, several examples of annotations using are presented.

To assign an Advanced DDoS protection profile to your cluster, use the following code in the manifest:

apiVersion: v1

kind: Service

metadata:

  annotations:

    loadbalancer.gcorelabs.com/ddos-profile: |

  {"profile_template":65,"fields":[{"base_field":272,"field_value":40}]}

  labels:

    app: grafana

  name: grafana

  namespace: default

spec:

  ports:

  - port: 80

    protocol: TCP

    targetPort: 80

  selector:

    app: grafana

  type: LoadBalancer

Instead of the sample values (65, 272, and 40), use the appropriate values for your project. The value format is the same as supported by the public DDoS Protection API.

To enable logging for your cluster, use the following one:

apiVersion: v1

kind: Service

metadata:

  annotations:

    loadbalancer.gcorelabs.com/logging-topic-name: test123

    loadbalancer.gcorelabs.com/logging-destination-region-id: 15

  labels:

    app: grafana

  name: grafana

  namespace: default

spec:

  ports:

  - port: 80

    protocol: TCP

    targetPort: 80

  selector:

    app: grafana

  type: LoadBalancer

Instead of the sample values (test123 and 15), use the appropriate values for your project.