Skip to main content

Platform Tags Reference

info

Feature status: planned

This page lists all tags that Entigo Platform and its components apply to cloud resources.

Platform System Tags

Tags managed by the Entigo Platform. Do not modify these manually.

K8s LabelAWS TagAzure TagGCP LabelPurposeWhen Present
entigo.com/workspaceentigo:workspaceentigo.workspaceentigo_workspaceWorkspace isolation via ABACAlways
entigo.com/zoneentigo:zoneentigo.zoneentigo_zoneZone scoping via ABACZone-scoped resources
NameHuman-readable name in AWS ConsoleAlways (AWS only)

Notes

  • entigo:workspace is the only universally required tag. Its presence signals that the resource is within platform scope.
  • entigo:zone is omitted for workspace-scoped resources not associated with a specific zone.
  • Management policy is not propagated to cloud tags. The entigo.com/management-policy label is a Kubernetes-only concept that controls syncer behavior. See Kubernetes-Only Labels below.
  • Name follows AWS naming conventions for console readability.

Crossplane System Tags

Tags added by Crossplane (the cloud resource provisioning engine). These cannot be renamed or suppressed.

AWS TagPurposeExample Value
crossplane-kindKubernetes managed resource type (GVK)instance.rds.aws.upbound.io
crossplane-nameKubernetes managed resource namemy-database-abc12
crossplane-providerconfigProviderConfig used for provisioningdefault

Customer Passthrough Tags

Tags defined by users via the tags.entigo.com/ prefix on Organization, Workspace, or Zone objects. The prefix is stripped before applying to cloud resources.

SourceCloud Tag
Label tags.entigo.com/cost-center: CC-12345cost-center: CC-12345
Annotation tags.entigo.com/project-description: My projectproject-description: My project

See the Custom Resource Tags guide for usage details.

Kubernetes-Only Labels

These labels exist within the platform (control plane and workspace clusters) and are not propagated to cloud resources:

LabelPurposeSet By
entigo.com/management-policyLifecycle management (full vs. observed)Platform / Syncer
app.kubernetes.io/managed-byIdentifies creating tool (argocd, helm, entigo-web)Creating tool

Tag Key Format Per Cloud Provider

The platform translates Kubernetes label prefixes to provider-appropriate formats:

Cloud ProviderPrefix FormatSeparatorExample
Kubernetesentigo.com//entigo.com/workspace
AWSentigo::entigo:workspace
Azureentigo..entigo.workspace
GCPentigo__entigo_workspace

Provider-Specific Limitations

ConstraintAWSAzureGCP
Max tags per resource505064 (labels)
Key max length128512 (128 for storage)63
Value max length25625663
Case sensitive (keys)YesNoLowercase only
Case sensitive (values)YesYesLowercase only

Example: Complete Tag Set on an AWS Resource

A fully managed RDS database in zone-1:

entigo:workspace          = ws-prod-001
entigo:zone = zone-1
Name = my-production-database
crossplane-kind = instance.rds.aws.upbound.io
crossplane-name = my-production-database-x7k2m
crossplane-providerconfig = default
cost-center = CC-12345 (passthrough from Zone)
environment = production (passthrough from Workspace)
company = acme-corp (passthrough from Organization)

An observed S3 bucket:

entigo:workspace          = ws-prod-001
entigo:zone = zone-1
Name = legacy-data-bucket
crossplane-kind = bucket.s3.aws.upbound.io
crossplane-name = legacy-data-bucket-m3p9q
crossplane-providerconfig = default
cost-center = CC-12345 (passthrough from Zone)