Introdução

Em construção

Esta página está em construção. O conteúdo pode mudar ou estar incompleto.

No trimestre passado, os seus arquitetos desenharam a plataforma de crédito numa ferramenta de diagramas. Estava certo. Desde então, um agente adicionou o billing-service, e ninguém reparou que ele lê direto do credit-db, um padrão que a sua empresa proíbe. O diagrama continua parecendo ok. A regra mora numa wiki que ninguém confere.

O ASL, a Architecture Specification Language, é como a sua empresa impede que isso aconteça de novo. Você descreve aplicações, bancos e as relações entre eles em arquivos YAML pequenos. O comando asl confere tudo, em milissegundos, contra as regras que importam para você.

asl ./architecture

O que você ganha

• Manifests validados. Cada kind (Application, Database, Relationship...) tem uma definição. Um manifest com erro de digitação ou campo faltando é rejeitado com uma mensagem clara.
• Um grafo de dependências de verdade. Os relacionamentos ligam seus manifests. Uma referência para algo que não existe é um erro, não uma surpresa em produção.
• Policies. Regras built-in mais as suas, como "um banco pertence a uma única aplicação".
• Saída pronta para CI. Diagnósticos legíveis e um exit code que o seu pipeline entende.

Um primeiro manifest

architecture/credit.asl.yaml

apiVersion: asl/v1
kind: Application
metadata:
  name: credit-service
  labels:
    owner: team-payments
spec:
  providers:
    aws: EKS
  language: Go

Todo manifest tem apiVersion, kind e metadata. O resto vai em spec, e o que é permitido ali depende do kind.

Rode asl ./architecture e você recebe ok. Adicione uma segunda aplicação que divide o banco com a primeira, junto da regra que proíbe isso, e o resultado vira um erro. É exatamente isso que você vai fazer em Custom policies.

Para onde ir agora

• CLI: rode a checagem na sua máquina e no CI.
• Custom policies: escreva suas próprias regras.
• Custom schemas: ensine ao ASL os seus próprios kinds.
• Por que arquitetura como código e como ela difere de diagrama como código.
• Como o ASL funciona: o que acontece entre o seu YAML e o veredito.