Ir al contenido

Convenciones de nomenclatura

Los nombres de recursos de muestra y demostración utilizan el prefijo example- en kebab-case. Esto mantiene la documentación, las especificaciones de API, los ejemplos de código y las configuraciones generadas consistentes en todo el ecosistema.

metadata:
name: example-http-lb
namespace: example-namespace

Utilice example- — no my-, test-, foo-, demo-, sample- ni marcadores de posición similares a nombres de empresa como mycompany — para cualquier nombre de recurso de muestra. Esto aplica a:

  • campos name de recursos en ejemplos,
  • valores example: en especificaciones de flujos de trabajo y parámetros,
  • valores de ejemplo de OpenAPI,
  • archivos de Terraform de muestra (.tf).

La convención aplica únicamente a los nombres de recursos de muestra. Deje lo siguiente sin cambios:

  • nombres de atributos y campos (por ejemplo, test_key),
  • código de prueba real y directorios test/,
  • nombres de paquetes y dependencias,
  • dominios y correos electrónicos de ejemplo, que ya siguen la convención (app.example.com, user@example.com).
En lugar deUtilice
my-origin-poolexample-origin-pool
test-namespaceexample-namespace
demo-appexample-app
mycompanyexample-company