Convenções e guia a configuração dos serviços online (servers) oferecidos pelo Condomínio CidadeAmarela.
Este guia tem como objetivo:
- registrar decisões técnicas e de infraestrutura da CidadeAmarela.
- estabelecer instruções e especificações técnicas para a equipe técnica responsável pela infraestrutura da CidadeAmarela.
- servir de Termo de Referência em contratos da CidadeAmarela.
- garantir a transparência e a participação coletiva dos grupos de interesse envolvidos.
- servir de referencial para a auditoria dos serviços e da metodologia empregados, para equipe de auditores externos ou endossadores do termo de referência.
Neste git são mantidos apenas documentos públicos oficiais da CidadeAmarela. Alguns deles são ou serão complementados por documentos restritos (classificados como "restrito" ou "sigiloso").
Ilustrações originais são armazenadas na pasta assets; tabelas e demais datasets, formatos CSV ou JSON, na pasta data e descritos no arquivo padrão datapackage.json na raiz; conteúdos, por hora, na Wiki.
Para ajudar ou acompanhar demandas, usar issues.
-
SPEC1: Requisitos gerais
-
SPEC2: Instalação e configuração
-
SPEC3: Backups
-
SPEC4: Testes de restauro dos backups
-
SPEC5: Referências normativas e de apoio
Os scripts resumem e facilitam o refazer do passo-a-passo descrito... e com _check.sh compare-se com o feito anteriormente.
sh step1.sh
# se tudo ok...
sh step1_check.sh | diff step1_check.dump -
Exemplo: quando rodamos no shell o step3.sh, ele roda tudo o que é necessário para o "step-3"; quando rodamos o step3_check.sh, ele roda as verificações e mensagens que atestam que está tudo no lugar e rodando... Isso fica gravado em dumps/step3.txt como referência (o dia que homologamos num Droplet de teste): assim quando rodar sh scripts/step3_check.sh | diff dumps/step3.txt - o estado do Droplet corrente será comparado com o estado homologado, se tudo ok não retorna nenhuma diferença.
