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

Slide 1

Slide 1 text

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

Slide 2

Slide 2 text

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

Slide 3

Slide 3 text

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

Slide 4

Slide 4 text

Documentar é preciso! Existe documentação? NÃO É difícil entender o que foi feito? ....

Slide 5

Slide 5 text

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?

Slide 6

Slide 6 text

O que é IaC? E qual a relação com documentação? https://www.quora.com/What-is-infrastructure-as-a-code

Slide 7

Slide 7 text

IaC https://www.quora.com/What-is-infrastructure-as-a-code

Slide 8

Slide 8 text

IaC https://www.plutora.com/blog/configuration-management

Slide 9

Slide 9 text

Documentação x IaC

Slide 10

Slide 10 text

IaC X Documentação

Slide 11

Slide 11 text

IaC X Documentação

Slide 12

Slide 12 text

IaC X Documentação

Slide 13

Slide 13 text

IaC é Documentação Viva Consistência/ Idenpotência Infra Imutável Keep updated Human readable Stop Documenting Machine readable Simplicidade Versionamento

Slide 14

Slide 14 text

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/

Slide 15

Slide 15 text

No content

Slide 16

Slide 16 text

16 • www.linkedin.com/in/igor-macedo • igor@ilem.me • blog.ilem.me