Profile

Profiles provide a way to group multiple endpoints so that they inherit a shared set of labels. For historic reasons, Profiles can also include policy rules, but that feature is deprecated in favor of the much more flexible NetworkPolicy and GlobalNetworkPolicy resources.

Each Calico endpoint or host endpoint can be assigned to zero or more profiles.

Sample YAML

The following sample profile applies the label stage: development to any endpoint that includes dev-apps in its list of profiles.

apiVersion: projectcalico.org/v3
kind: Profile
metadata:
  name: dev-apps
spec:
  labelsToApply:
    stage: development

Definition

Metadata

Field	Description	Accepted Values	Schema	Default
name	The name of the profile. Required.	Alphanumeric string with optional ., _, or -.	string
labels	A set of labels for this profile.		map of string key to string values

Spec

Field	Description	Accepted Values	Schema	Default
ingress (deprecated)	The ingress rules belonging to this profile.		List of Rule
egress (deprecated)	The egress rules belonging to this profile.		List of Rule
labelsToApply	An optional set of labels to apply to each endpoint in this profile (in addition to the endpoint's own labels)		map

For Rule details please see the NetworkPolicy or GlobalNetworkPolicy resource.

Supported operations

Datastore type	Create/Delete	Update	Get/List	Notes
etcdv3	Yes	Yes	Yes
Kubernetes API server	No	No	Yes	Calico profiles are pre-assigned for each Namespace and Service Account.