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
Tweet

More Decks by Igor Macedo

Other Decks in Technology

Transcript

  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/