Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Documentação Viva! Como IaC pode te ajudar nisso!

Documentação Viva! Como IaC pode te ajudar nisso!

Igor Macedo

May 20, 2020

Transcript

16 slides
  1. Quem sou eu? • Mais de 5 anos no BANESE

    • SysAdmin • Servidores, Armazenamento e Virtualização • Mais de 16 anos trabalhando com TI • Desenvolvimento ~= 3 anos • Infraestrutura de TI > 10 anos • Entusiasta de: • Software livre • Automação e automatização de rotinas • Armazenamento definido por software – SDS • Tecnologia em geral • Organizador do DevOpsDays Aracaju EU Igor Leonardo Eloy Macedo Mestre em Sistemas e Computação
  2. Documentar! Por que? Definição de escopo Espírito de colaboração Compreender

    o que foi construído Consistência dos processos Manutenção do conhecimento Melhoria/Definição do processo Organização Definição de patentes
  3. Documentar é preciso! É continuada? SIM NÃO ... É versionada?

    SIM Não Está atualizada? Se software, tem sync com o infra? E vice-versa? ... Documentar o que?
  4. O que é IaC? E qual a relação com documentação?

    https://www.quora.com/What-is-infrastructure-as-a-code
  5. IaC é Documentação Viva Consistência/ Idenpotência Infra Imutável Keep updated

    Human readable Stop Documenting Machine readable Simplicidade Versionamento
  6. E Docs As Code? • Documentation as Code (Docs as

    Code) refers to a philosophy that you should be writing documentation with the same tools as code https://www.writethedocs.org/guide/docs-as-code/

More Decks by Igor Macedo

Other Decks in Technology