StackPractices
beginner Por Mathias Paulenko

Plantilla de Politica de Etiquetado de Recursos Cloud

Una plantilla de politica para aplicar etiquetas consistentes en recursos cloud y mejorar la asignacion de costos, la seguridad y las operaciones.

Descripcion General

El Etiquetado de Recursos Cloud es la practica de aplicar etiquetas de metadatos a recursos cloud como maquinas virtuales, buckets de almacenamiento, bases de datos y componentes de red. Las etiquetas consistentes permiten la asignacion de costos, el control de acceso, las operaciones automatizadas y la auditoria de seguridad. Esta plantilla de politica define etiquetas requeridas, convenciones de nombres, mecanismos de cumplimiento y controles de gobernanza. Para la parte de costes, mira la plantilla de asignación de costes de infraestructura; para el lado de alertas, la plantilla de política de monitorización y alertas; y para el tooling de automatización, la receta de scripts de AWS CLI.

Cuando Usar

  • Configurar una nueva cuenta cloud o landing zone.
  • Incorporar un equipo o carga de trabajo a la plataforma cloud.
  • Preparar reportes de costos o auditorias de seguridad que requieran propiedad de recursos.
  • Automatizar operaciones como backups, apagados o parches por etiqueta.
  • Limpiar recursos sin etiquetar o etiquetados inconsistentemente.

Prerequisitos

  • Un proveedor cloud o entorno multi-cloud como AWS, Azure o GCP.
  • Un dueno de la politica de etiquetado, tipicamente ingenieria de plataforma o gobernanza cloud.
  • Una lista de etiquetas requeridas acordada con finanzas, seguridad y operaciones.
  • Herramientas de policy-as-code o gobernanza de etiquetado nativas como AWS Organizations tag policies, Azure Policy o GCP Organization Policy.
  • Un mecanismo para reportar y remediar recursos no conformes.

Solucion

Plantilla de Politica

1. Etiquetas Requeridas

EtiquetaRequeridaFormatoEjemploProposito
ownerSiemail o ID de equipocheckout-team@example.comResponsabilidad
teamSiminusculas, sin espaciosplatformPropiedad del equipo
productSiminusculas, sin espaciosapi-gatewayMapeo de producto
environmentSiminusculasproduction, staging, developmentSeparacion de entornos
cost-centerSialfanumericocc-12345Asignacion financiera
budget-codeNoalfanumericobudget-2026-q3Seguimiento de presupuesto
data-classificationSipredefinidopublic, internal, confidential, restrictedClasificacion de seguridad
compliance-scopeNopredefinidopci, gdpr, soc2, noneAlcance de cumplimiento
auto-shutdownNotrue / falsetrueAutomatizacion operacional
backup-policyNopredefinidostandard, critical, noneAsignacion de backup

2. Convenciones de Nombres de Etiquetas

ReglaDescripcionEjemplo
MinusculasTodas las claves y valores de etiquetas en minusculasenvironment: production
Sin espaciosUsar guiones en lugar de espacioscost-center: cc-12345
Usar guiones, no guiones bajosSeparador consistente en claves y valoresbudget-code: budget-2026-q3
Sin caracteres especialesEvitar !@#$%^&* excepto guionesproduct: api-gateway
Significativas y cortasUsar abreviaturas clarasteam: sre
Valores controlados para etiquetas restringidasUsar valores permitidos para environment, clasificacion de datos, etc.environment: production

3. Matriz de Cobertura de Etiquetado

Tipo de RecursoEtiquetas RequeridasSoporte de Automatizacion
Instancias de computoowner, team, product, environment, cost-center, data-classificationSi
Buckets de almacenamientoowner, team, product, environment, cost-center, data-classificationSi
Bases de datosowner, team, product, environment, cost-center, data-classification, backup-policySi
Recursos de redowner, team, environment, cost-centerParcial
Load balancersowner, team, product, environment, cost-centerSi
Clusters Kubernetesowner, team, product, environment, cost-centerSi
Contenedores y podsteam, product, environmentVia labels
Funciones serverlessowner, team, product, environment, cost-centerSi
Roles y politicas IAMowner, team, environment, compliance-scopeSi

4. Mecanismos de Cumplimiento de Etiquetas

MecanismoAlcanceAccion ante No ConformidadHerramienta de Ejemplo
Linting de IaCPull requestBloquear mergeTerraform policy, Checkov, tfsec
Politica de despliegueCreacion de recursoBloquear o advertirAWS Organizations, Azure Policy, GCP Organization Policy
Remediacion automaticaRecursos existentesAgregar etiquetas por defecto o notificar duenoCloud Custodian, Azure Policy remediation
Escaneo de cumplimientoTodos los recursosGenerar reporte y ticketProwler, Cloud Custodian, herramientas nativas
Filtrado de reportes de costoFacturacionCostos sin etiquetar asignados a presupuesto centralAWS Cost Explorer, Azure Cost Management

5. Manejo de Excepciones

EscenarioProcesoDuenoVencimiento
Recurso legacy sin etiquetasAgregar etiquetas durante proxima ventana de mantenimiento o via remediacion automaticaDueno del recurso30 dias
Recurso gestionado por tercerosAplicar etiquetas a nivel de cuenta o proyecto si el etiquetado directo no es soportadoEquipo de plataforma90 dias
Recurso compartidoEtiquetar con dueno primario y agregar metadata de division de costos compartidosEquipo de plataforma90 dias
Recurso temporalRequerir etiquetas minimas al crear; auto-limpieza despues del vencimientoDueno del recursoVida util del recurso
Aprobacion de excepcionEnviar solicitud de excepcion con aceptacion de riesgo y fecha de revisionEquipo de gobernanza6 meses

6. Checklist de Gobernanza

  • Las etiquetas requeridas estan definidas y documentadas.
  • Las claves y valores de etiquetas siguen las convenciones de nombres.
  • Las plantillas de IaC exigen etiquetas al crear recursos.
  • La politica cloud impide la creacion de recursos sin etiquetas cuando sea posible.
  • El escaneo automatico reporta recursos no conformes semanalmente.
  • Los recursos sin etiquetar se asignan a un centro de costos por defecto y se remedian.
  • Los valores de etiquetas se mantienen en un registro central o lista de valores permitidos.
  • La politica se revisa trimestralmente y se actualiza para nuevos servicios.
  • El cumplimiento de etiquetas se incluye en revisiones de seguridad y costos.

Explicacion

Las etiquetas son metadatos que potencian la asignacion de costos, seguridad, operaciones y cumplimiento. Una politica de etiquetado asegura que cada recurso tenga etiquetas consistentes y significativas desde la creacion hasta la retirada. Sin gobernanza, las etiquetas se vuelven inconsistentes, haciendo que la automatizacion y los reportes sean poco confiables. La combinacion de etiquetas requeridas, convenciones de nombres y herramientas de cumplimiento crea un modelo de operacion cloud preparado para crecer.

Decidir Qué Etiquetas Exigir

Cada etiqueta obligatoria tiene un coste: alguien tiene que rellenarla, algo tiene que validarla, y un informe tiene que usarla — o es solo ruido. Trabaja hacia atrás desde los consumidores. Finanzas necesita cost-center y environment para atribuir el gasto. Seguridad necesita data-classification para acotar las revisiones. Operaciones necesita owner para encontrar a una persona a las 3 de la mañana. Si no existe un consumidor, no exijas la etiqueta.

Empieza con el conjunto mínimo que responde “de quién es esto, qué es, y quién lo paga” — normalmente owner, team, product, environment y cost-center. Añade data-classification en cuanto manejes datos regulados, y etiquetas operativas (auto-shutdown, backup-policy) solo donde la automatización las lee de verdad; etiquetar una VM de desarrollo para auto-apagado ahorra dinero real, etiquetar una base de datos de producción para lo mismo es un riesgo.

Asigna un dueño a la política — normalmente platform engineering — y una cadencia de revisión. Trimestral funciona para la mayoría: poda las claves que nadie consulta, promueve los valores que aparecieron orgánicamente y revisa la cobertura. Un registro de valores permitidos para etiquetas controladas (environment, data-classification) vive junto a la política, porque una convención que solo existe en una diapositiva dura como mucho un ciclo de onboarding.

Enforcement por Proveedor

La política es portable; la mecánica no. Las tag policies de AWS Organizations validan nombres de clave, mayúsculas y valores permitidos entre cuentas — imponen la ortografía de las etiquetas, mientras que los SCPs o las Config rules hacen el bloqueo de recursos sin etiquetar. Las cost allocation tags además hay que activarlas aparte en la consola de Billing para que aparezcan en los informes CUR — un paso que la gente descubre ausente meses después.

Azure sigue otro camino: tags de Resource Manager más definiciones de Azure Policy. Policy puede denegar la creación, añadir etiquetas automáticamente o solo auditar. El patrón inherit tags from resource group ahorra esfuerzo real — pero solo se aplica a recursos creados después de la política, así que los existentes siguen necesitando una tarea de remediación.

GCP los llama labels y los labels son más estrictos: solo minúsculas, sin números iniciales, 64 por recurso. La aplicación a nivel de proyecto pasa por Organization Policy y la herencia de labels es limitada, así que un enfoque de etiquetar el proyecto y escanear los recursos que se desvían suele funcionar mejor que la aplicación por recurso. En multi-cloud, mantén la convención canónica en minúsculas con guiones; es el único estilo que los tres proveedores aceptan sin traducción.

Remediar Recursos Sin Etiquetar

Mermaid flowchart LR diagram

El etiquetado retroactivo es un ciclo de vida, no un script de una sola vez. Escanea a diario, agrupa los hallazgos por equipo dueño en lugar de por recurso — un informe que aterriza en el backlog de un equipo se arregla; uno que aterriza en un buzón compartido, no. Da a los dueños un plazo de gracia para etiquetar correctamente (ellos conocen los valores reales de product y cost-center), y después aplica defaults conservadores o cuarentena.

Dos trampas a evitar. Primero, no auto-etiquetes owner ni cost-center a ojo — un valor incorrecto es peor que uno ausente porque esconde gasto real. Aplica defaults solo a etiquetas derivables objetivamente (environment desde la cuenta, managed-by: "automation"). Segundo, sigue la tendencia, no el número absoluto: un conteo decreciente de recursos sin etiquetar significa que la adopción funciona; uno plano significa que se crean recursos más rápido de lo que la política alcanza — mira la ruta de creación, no el backlog.

Politica de Etiquetas con Terraform

variable "required_tags" {
  type = map(string)
  default = {
    team        = ""
    environment = ""
    product     = ""
    cost-center = ""
    owner       = ""
  }
}

locals {
  default_tags = {
    team        = var.required_tags["team"]
    environment = var.required_tags["environment"]
    product     = var.required_tags["product"]
    cost-center = var.required_tags["cost-center"]
    owner       = var.required_tags["owner"]
    managed-by  = "terraform"
  }
}

resource "aws_instance" "app" {
  ami           = data.aws_ami.app.id
  instance_type = var.instance_type
  tags          = local.default_tags
}

resource "aws_s3_bucket" "data" {
  bucket = var.bucket_name
  tags   = local.default_tags
}

resource "aws_db_instance" "database" {
  engine         = "postgres"
  instance_class = var.db_class
  tags           = local.default_tags
}

Script de Deteccion de Recursos Sin Etiquetar

#!/usr/bin/env python3
"""Detect untagged resources in AWS."""
import boto3
import json
from botocore.exceptions import ClientError
from datetime import datetime

REQUIRED_TAGS = ['team', 'environment', 'product', 'cost-center', 'owner']
REGIONS = ['us-east-1', 'eu-west-1', 'ap-southeast-1']

def check_ec2_instances(region):
    ec2 = boto3.client('ec2', region_name=region)
    untagged = []
    response = ec2.describe_instances()
    for res in response['Reservations']:
        for inst in res['Instances']:
            tags = {t['Key'].lower(): t['Value'] for t in inst.get('Tags', [])}
            missing = [t for t in REQUIRED_TAGS if t not in tags]
            if missing:
                untagged.append({
                    'resource_id': inst['InstanceId'],
                    'type': 'EC2',
                    'region': region,
                    'missing_tags': missing,
                    'launch_time': inst['LaunchTime'].isoformat()
                })
    return untagged

def check_s3_buckets(region):
    s3 = boto3.client('s3')
    untagged = []
    for bucket in s3.list_buckets()['Buckets']:
        # get_bucket_tagging raises NoSuchTagSet on untagged buckets
        try:
            tags = s3.get_bucket_tagging(Bucket=bucket['Name']).get('TagSet', [])
        except ClientError as e:
            if e.response['Error']['Code'] == 'NoSuchTagSet':
                tags = []
            else:
                raise
        tag_keys = [t['Key'].lower() for t in tags]
        missing = [t for t in REQUIRED_TAGS if t not in tag_keys]
        if missing:
            untagged.append({
                'resource_id': bucket['Name'],
                'type': 'S3',
                'region': region,
                'missing_tags': missing
            })
    return untagged

def check_rds_instances(region):
    rds = boto3.client('rds', region_name=region)
    untagged = []
    for db in rds.describe_db_instances()['DBInstances']:
        arn = db['DBInstanceArn']
        tags = rds.list_tags_for_resource(ResourceName=arn).get('TagList', [])
        tag_keys = [t['Key'].lower() for t in tags]
        missing = [t for t in REQUIRED_TAGS if t not in tag_keys]
        if missing:
            untagged.append({
                'resource_id': db['DBInstanceIdentifier'],
                'type': 'RDS',
                'region': region,
                'missing_tags': missing
            })
    return untagged

def main():
    all_untagged = []
    for region in REGIONS:
        all_untagged.extend(check_ec2_instances(region))
        all_untagged.extend(check_s3_buckets(region))
        all_untagged.extend(check_rds_instances(region))

    report = {
        'timestamp': datetime.now().isoformat(),
        'total_untagged': len(all_untagged),
        'resources': all_untagged
    }
    print(json.dumps(report, indent=2))

    if all_untagged:
        print(f'\\nUntagged resources: {len(all_untagged)}')
        for r in all_untagged:
            print(f"  {r['type']} {r['resource_id']} ({r['region']}): missing {', '.join(r['missing_tags'])}")

if __name__ == '__main__':
    main()

Operar la Política

Una política de etiquetado falla en silencio. Nadie recibe un aviso cuando un recurso sale sin etiquetar; el fallo aparece meses después como un informe de costes que no cuadra o una incidencia donde nadie sabe de quién es la base de datos afectada. Tratar la política como un sistema operativo — no como un documento — es lo que evita que se degrade en papel sin usar.

La capa de enforcement bloquea, pero la capa de feedback logra la adopción. Publica un score de cumplimiento por equipo: un número, el porcentaje de recursos con el conjunto completo de etiquetas requeridas, actualizado semanalmente y visible en un dashboard o en un mensaje recurrente al canal de ingeniería. Los equipos corrigen sus propios huecos cuando el número es público y atribuible — sin necesidad de tickets en la mayoría de los casos. Mantén la métrica honesta excluyendo las excepciones que la propia política concede (recursos gestionados por terceros, cuentas sandbox) o los equipos la manipularán de inmediato.

Los servicios cloud nuevos necesitan una decisión de etiquetado explícita antes de su disponibilidad general. La matriz cubre los tipos de recurso de hoy, pero los proveedores lanzan servicios constantemente y cada lanzamiento es un hueco nuevo de cumplimiento. Haz de “¿se puede etiquetar, y aplica el conjunto requerido?” una línea del checklist de evaluación de servicios. Si un servicio no admite etiquetas, o no se aprueba o recibe una entrada de excepción — no se incorpora en silencio.

Los valores de etiqueta derivan igual que la configuración. production, prod y Production aparecerán todos si la lista de valores permitidos no se aplica, y cada variante multiplica la complejidad de los informes. La revisión trimestral debería comparar los valores observados con el registro, no solo comprobar cobertura: una etiqueta presente en el 100% de recursos pero escrita de cinco formas es un fallo disfrazado. Corrige los valores en la capa de validación y luego rellena las variantes antiguas para que los informes sigan siendo consultables.

Por último, elimina etiquetas. Las claves se acumulan — la etiqueta project-phoenix del año pasado sobrevive en recursos mucho después de que el proyecto terminara, y las claves obsoletas ensucian los informes y complican el onboarding. La misma revisión trimestral que añade claves debería retirarlas: anuncia la deprecación, ejecuta la antigua y la nueva durante un ciclo de informe, y luego elimina la clave del registro y del enforcement. Una política que solo crece acaba convirtiéndose en el desorden que fue escrita para prevenir.

Variantes

  • Politica de etiquetado AWS: Usa AWS Organizations tag policies, AWS Config rules y Cost Allocation Tags.
  • Politica de etiquetado Azure: Usa Azure Policy, resource tags y cost management tags.
  • Politica de etiquetado GCP: Usa GCP labels, Organization Policy y Resource Manager labels.
  • Politica de etiquetado multi-cloud: Estandariza un conjunto comun de etiquetas en AWS, Azure y GCP con implementacion especifica por proveedor.
  • Politica de etiquetado de contenedores: Se enfoca en labels y annotations de Kubernetes para pods, namespaces y nodos.
  • Politica de etiquetado centrada en seguridad: Enfatiza clasificacion de datos, alcance de cumplimiento y etiquetas de segmentacion de red.

Lo que funciona

  • Exige etiquetas minimas requeridas al momento de crear recursos.
  • Usa policy-as-code para validar etiquetas en pipelines de CI/CD e IaC.
  • Aplica etiquetas consistentemente en computo, almacenamiento, red e IAM.
  • Manten los valores de etiquetas en un vocabulario controlado para evitar duplicados y errores tipograficos.
  • Usa automatizacion para remediar recursos sin etiquetar en lugar de depender de correcciones manuales.
  • Incluye el cumplimiento de etiquetas en revisiones de costos y seguridad.
  • Documenta la razon de cada etiqueta requerida para que los equipos entiendan el valor.
  • Revisa los valores permitidos trimestralmente a medida que cambian equipos y productos.

Errores Comunes

  • Permitir valores de texto libre para etiquetas que deberian ser controladas.
  • Etiquetar solo algunos tipos de recursos y omitir red o IAM.
  • Depender del etiquetado manual despues de crear recursos.
  • Usar convenciones de nombres diferentes en diferentes equipos o cuentas.
  • No actualizar etiquetas cuando cambia la propiedad o el entorno.
  • Tratar las etiquetas como metadata opcional en lugar de datos operativos.
  • No reportar recursos sin etiquetar o asignar propiedad de remediacion.

Solución de Problemas

  • Los informes de coste muestran gasto sin etiquetar aunque el etiquetado sea obligatorio. Las etiquetas de un padre no siempre llegan a los hijos — los volúmenes EC2 creados junto a instancias, los recursos lanzados por autoscaling y los gestionados por el proveedor (objetos S3, snapshots RDS) suelen saltarse el etiquetado en creación. Escanealos aparte y añádelos a la matriz de cobertura.
  • Las tag policies bloquean despliegues con errores crípticos. Las denegaciones de AWS tag policy y Azure Policy aparecen como fallos genéricos de autorización. Prueba las políticas en modo audit primero, mantén el mapeo de errores en el runbook y da a los desarrolladores un lint que falle rápido con el nombre de la etiqueta, no un 403.
  • Las etiquetas existen pero la automatización no encuentra los recursos. Normalmente un desajuste de mayúsculas — las claves de AWS distinguen case y los labels de GCP son solo minúsculas. Normaliza a minúsculas en tu tooling (como hace el script) y aplica la convención en CI, no solo en un documento.
  • Se renombró una etiqueta y los informes se rompieron. Renombrar team a owner-team hace huérfano a todo dashboard que filtraba por la clave antigua. Trata las claves como una API pública: versiona los cambios, mantén ambas claves durante la migración y actualiza el registro antes que la regla de enforcement.
  • Un recurso llegó al límite de etiquetas del proveedor. AWS permite 50 por recurso, Azure 50 y GCP 64 labels. Si las etiquetas generadas (timestamps, IDs de despliegue) consumen el presupuesto, mueve las etiquetas de herramientas a una clave dedicada o a un store de metadatos externo.

Lecturas Adicionales

Preguntas frecuentes

¿Qué pasa si un recurso lo comparten varios equipos?

Etiquétalo con el dueño principal — el equipo que lo opera — y añade un marcador shared: "true" para que los informes de coste lo marquen para revisión manual. Reparte los costes reales en el export de facturación o en un cost-center compartido documentado en la política; no intentes codificar porcentajes dentro de las etiquetas.

¿Cómo aplicamos las etiquetas sin ralentizar el desarrollo?

Valida en CI, no en la revisión. Un lint de terraform plan que falle rápido ante un team o environment ausente tarda segundos y enseña la convención. Combínalo con módulos que inyecten managed-by y defaults para que los desarrolladores solo aporten las etiquetas que tienen significado.

¿Se pueden etiquetar recursos existentes retroactivamente?

Sí. Escanea primero (el script de arriba o Cloud Custodian), avisa a los dueños con fecha límite y luego remedia automáticamente — Cloud Custodian, tareas de remediación de Azure Policy o un script programado. Reserva el apagado o la cuarentena para los recursos que sigan sin etiquetar pasado el plazo; etiquetarlos a ciegas solo reubica el problema.

¿Cómo implementamos el enforcement en CI/CD?

Que falle el pipeline, no la auditoría. En Terraform, valida que cada recurso etiquetable del plan lleve las claves requeridas — un check personalizado de Checkov o un script corto que parsea terraform plan -json funciona. Para recursos creados fuera de IaC, ejecuta el script de detección o Cloud Custodian programado y abre tickets contra el equipo dueño.

¿Qué es Cloud Custodian y cómo ayuda?

Cloud Custodian es una herramienta open-source de policy-as-code de Capital One. Escribes políticas YAML tipo "encuentra instancias EC2 sin environment y etiquétalas o páralas a los 7 días" y las ejecutas contra AWS, Azure o GCP de forma programada. Cubre el ciclo de escanear-y-remediar que esta política necesita sin construir tooling propio.

¿Con qué frecuencia auditamos el cumplimiento de etiquetas?

Escanea a diario, informa semanalmente, revisa trimestralmente. Los escaneos diarios pillan el drift cuando es barato de arreglar. La revisión trimestral es donde podas claves muertas, actualizas la lista de valores permitidos y compruebas si se cumplen los objetivos de cobertura — el cumplimiento de etiquetas es una métrica, no un proyecto puntual.

¿Cómo evitamos valores de etiqueta inválidos?

Mantén un registro central de valores permitidos para etiquetas controladas (environment, data-classification, compliance-scope) y aplícalo a dos niveles: el motor de políticas del proveedor (AWS tag policies, Azure Policy) rechaza valores no listados en creación, y la validación de variables en Terraform falla el pipeline antes. Los valores de texto libre solo pertenecen a etiquetas que no se pueden enumerar.