Pular para o conteúdo

Convenções de Nomenclatura

Os nomes de recursos de exemplo e demonstração utilizam o prefixo example- em kebab-case. Isso mantém a documentação, especificações de API, amostras de código e configurações geradas consistentes em todo o ecossistema.

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

Utilize example- — e não my-, test-, foo-, demo-, sample- ou substitutos semelhantes a nomes de empresas como mycompany — para qualquer nome de recurso de exemplo. Isso se aplica a:

  • campos name de recursos em exemplos,
  • valores example: em especificações de fluxo de trabalho e parâmetros,
  • valores de exemplo do OpenAPI,
  • arquivos Terraform (.tf) de exemplo.

A convenção se aplica apenas a nomes de recursos de exemplo. Mantenha os seguintes itens sem alteração:

  • nomes de atributos e campos (por exemplo, test_key),
  • código de teste real e diretórios test/,
  • nomes de pacotes e dependências,
  • domínios e e-mails de exemplo, que já seguem a convenção (app.example.com, user@example.com).
Em vez deUtilize
my-origin-poolexample-origin-pool
test-namespaceexample-namespace
demo-appexample-app
mycompanyexample-company