Skip to content

Repository files navigation

SPIFFEBook — Traduções de Solving the Bottom Turtle

Traduções do livro Solving the Bottom Turtle — a SPIFFE Way to Establish Trust in Your Infrastructure via Universal Identity, a principal obra de referência sobre SPIFFE e SPIRE, em:

  • 🇧🇷 Português brasileiro (pt-BR) — idioma padrão do site;
  • 🌎 Espanhol latino-americano (es)español latinoamericano.

Cada idioma é um site independente, ligados como traduções nativas do ReadTheDocs — use o seletor de idioma do RTD para alternar entre eles.

⚠️ Projeto de tradução não oficial. Esta é uma obra derivada, traduzida de forma independente. Não é endossada nem revisada pelos autores originais, pela SPIFFE/SPIRE, pela CNCF ou pela HPE.

📖 Ler online

As traduções estão publicadas para leitura online, capítulo a capítulo, via ReadTheDocs:

➡️ https://spiffebook.readthedocs.io/pt-br/ (pt-BR) · https://spiffebook.readthedocs.io/es/ (español)

Capítulos (fonte em português — docs/pt/livro/):

  1. História e Motivação para o SPIFFE
  2. Benefícios
  3. Conceitos Gerais de Identidade
  4. Introdução aos Conceitos SPIFFE e SPIRE
  5. Antes de Começar
  6. Projetando uma Implantação SPIRE
  7. Integrando com Outros
  8. Usando Identidades SPIFFE para Informar a Autorização
  9. Comparando SPIFFE com Outras Tecnologias
  10. Histórias de Profissionais

Complementos: Notas de Tradução · Sobre Zero, a Tartaruga · Glossário do livro · Epílogo

🌎 Versão em espanhol (es): os mesmos capítulos estão em docs/es/livro/ e publicados em https://spiffebook.readthedocs.io/es/.

📖 Sobre a obra

Obra original Solving the Bottom Turtle (2020), ISBN 978-0-578-77737-5
Autores originais Daniel Feldman, Emily Fox, Evan Gilman, Ian Haken, Frederick Kautz, Umair Khan, Max Lambrecht, Agustín Martínez Fayó, Eli Nesterov, Andrés Vega, Michael Wardrop, Brandon Lum
Original em https://spiffe.io/book/
Licença Creative Commons Attribution 4.0 International (CC BY 4.0)
Idiomas desta tradução Português (pt-BR, padrão) · Español latino-americano (es)
Tradução Aslan Carlos M. Ramos
Status 🚧 Em andamento

🛠️ Como é construído o site

A documentação é gerada com MkDocs (tema Material) e publicada pelo ReadTheDocs usando traduções nativas: cada idioma é um site independente, com sua própria árvore de conteúdo e config.

Estrutura por idioma:

Idioma Conteúdo Config MkDocs URL
🇧🇷 pt-BR docs/pt/ mkdocs.yml /pt-br/
🌎 es docs/es/ mkdocs.es.yml /es/
  • No ReadTheDocs há dois projetos ligados: o principal (pt-br) e a tradução (es). O RTD adiciona o seletor de idioma nativo entre eles.
  • Ambos os projetos compartilham o mesmo .readthedocs.yml, que escolhe qual site construir pela variável READTHEDOCS_LANGUAGE definida pelo RTD em cada projeto (esmkdocs.es.yml; caso contrário → mkdocs.yml).
  • As imagens ficam versionadas apenas em docs/pt/livro/media/; o build do espanhol as copia no próprio .readthedocs.yml, evitando duplicá-las no Git.

Para visualizar localmente:

pip install -r docs_requirements.txt

# pt-BR
mkdocs serve -f mkdocs.yml            # http://127.0.0.1:8000

# es (copie as imagens uma vez, como faz o build do RTD)
cp -r docs/pt/livro/media docs/es/livro/media
mkdocs serve -f mkdocs.es.yml         # http://127.0.0.1:8000

A fonte editável original (texto/diagramação) não é distribuída neste repositório; o conteúdo publicado é o de docs/.

⚖️ Licença e atribuição

Tanto a obra original quanto esta tradução estão sob CC BY 4.0. Você pode compartilhar e adaptar, inclusive comercialmente, desde que dê o crédito apropriado e indique se fez alterações.

Os detalhes de atribuição e a declaração de modificações (esta é uma tradução) estão em NOTICE.md — leitura obrigatória ao reutilizar.

🤝 Contribuindo

Correções de tradução, revisão e padronização de terminologia são bem-vindas. Veja CONTRIBUTING.md e os glossários de terminologia: GLOSSARIO.md (EN → pt-BR) e GLOSSARIO_ES.md (EN → es).

📚 Recursos sobre SPIFFE/SPIRE

About

Tradução não oficial (pt-BR + espanhol latino) do livro 'Solving the Bottom Turtle', a obra de referência sobre SPIFFE/SPIRE. Site bilíngue. Licenciado sob CC BY 4.0.

Topics

Resources

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors