Organize o código para projetos de grande escala - AWS Orientação prescritiva

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Organize o código para projetos de grande escala

Por que a organização do código é importante

É fundamental que AWS CDK projetos de grande escala tenham uma estrutura bem definida e de alta qualidade. À medida que um projeto cresce e seu número de recursos e estruturas compatíveis aumenta, a navegação pelo código se torna mais difícil. Essa dificuldade pode afetar a produtividade e retardar a integração do desenvolvedor.

Como organizar seu código para escalar

Para alcançar um alto nível de flexibilidade e legibilidade do código, recomendamos dividir o código em partes lógicas com base na funcionalidade. Essa divisão reflete o fato de que a maioria das suas estruturas é usada em diferentes domínios de negócios. Por exemplo, seus aplicativos de front-end e back-end podem exigir uma AWS Lambda função e consumir o mesmo código-fonte. As fábricas podem criar objetos sem expor a lógica de criação ao cliente e usar uma interface comum para se referir aos objetos recém-criados. Você pode usar uma fábrica como um padrão eficaz para criar um comportamento consistente em sua base de código. Além disso, uma fábrica pode servir como uma única fonte confiável para ajudar a evitar códigos repetitivos e facilitar a solução de problemas.

Para entender melhor como as fábricas funcionam, considere o exemplo de um fabricante de automóveis. Um fabricante de automóveis não precisa ter o conhecimento e a infraestrutura necessários para fabricar pneus. Em vez disso, o fabricante do carro terceiriza essa experiência para um fabricante especializado de pneus e, em seguida, simplesmente encomenda os pneus desse fabricante conforme necessário. O mesmo princípio se aplica ao código. Por exemplo, é possível criar uma fábrica do Lambda capaz de criar funções do Lambda de alta qualidade e, em seguida, chamar a fábrica do Lambda em seu código sempre que precisar criar uma função do Lambda. Da mesma forma, é possível usar esse mesmo processo de terceirização para desacoplar sua aplicação e criar componentes modulares.

Exemplo de organização de código

O projeto de TypeScript amostra a seguir, conforme mostrado na imagem a seguir, inclui uma pasta comum na qual você pode manter todas as suas construções ou funcionalidades comuns.

Pasta comum

Por exemplo, a pasta computar (localizada na pasta common) contém toda a lógica para diferentes estruturas de computação. Novos desenvolvedores podem adicionar facilmente novas estruturas de computação sem afetar os outros recursos. Todas as outras construções não precisarão criar novos recursos internamente. Em vez disso, essas estruturas simplesmente chamam a fábrica de estruturas comuns. Você pode organizar outras estruturas, como armazenamento, da mesma forma.

As configurações contêm dados baseados no ambiente que você deve desacoplar da pasta common em que você guarda a lógica. Recomendamos colocar seus dados de configuração comuns em uma pasta compartilhada. Também recomendamos usar a pasta utilities para servir todas as funções auxiliares e limpar scripts.