{"id":31656544,"url":"https://github.com/kubex-ecosystem/shellscript_template","last_synced_at":"2026-05-18T04:47:56.515Z","repository":{"id":294082930,"uuid":"985924582","full_name":"kubex-ecosystem/shellscript_template","owner":"kubex-ecosystem","description":"This repository provides a robust template for writing secure, maintainable, and modular Bash scripts. It includes best practices for error handling, logging, colorized output, and safe environment setup. The structure is designed to help you avoid common pitfalls in shell scripting, such as accidental root execution, function name collisions, etc.","archived":false,"fork":false,"pushed_at":"2025-06-07T00:57:38.000Z","size":52,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-07T14:27:22.606Z","etag":null,"topics":["linux","security","shell","templates"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kubex-ecosystem.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-18T19:57:05.000Z","updated_at":"2025-06-07T00:57:42.000Z","dependencies_parsed_at":"2025-06-01T18:00:01.246Z","dependency_job_id":"31c520aa-db4e-4590-a308-156770e5164e","html_url":"https://github.com/kubex-ecosystem/shellscript_template","commit_stats":null,"previous_names":["faelmori/shellscript_template","rafa-mori/shellscript_template","kubex-ecosystem/shellscript_template"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/kubex-ecosystem/shellscript_template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fshellscript_template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fshellscript_template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fshellscript_template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fshellscript_template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kubex-ecosystem","download_url":"https://codeload.github.com/kubex-ecosystem/shellscript_template/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kubex-ecosystem%2Fshellscript_template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33044329,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-13T13:14:54.681Z","status":"online","status_checked_at":"2026-05-14T02:00:06.663Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["linux","security","shell","templates"],"created_at":"2025-10-07T14:15:02.046Z","updated_at":"2026-05-14T21:36:16.029Z","avatar_url":"https://github.com/kubex-ecosystem.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Secure and Modular Bash Script Template\n\n\u003e **License:** MIT  \n\u003e **Copyright (C) 2025 Rafael Mori**  \n\u003e **Inspired by Adrelanos' [helper-scripts](https://github.com/Whonix/helper-scripts)**\n\nEste repositório fornece um template robusto para escrever scripts Bash seguros, modulares e fáceis de manter — agora com foco em automação cloud-native, incluindo ambientes Kubernetes em Azure!\n\n---\n\n## Sumário\n\n- [Destaque: Cloud-Native com Azure/Kubernetes](#destaque-cloud-native-com-azurekubernetes)\n- [Principais Características](#principais-características)\n- [Exemplo Clássico de Uso](#exemplo-clássico-de-uso)\n- [Por que usar este template?](#por-que-usar-este-template)\n- [Comparativo Prático](docs/COMPARATIVO.md)\n- [Casos de Uso Detalhados](#casos-de-uso-detalhados)\n- [Como contribuir](#como-contribuir)\n- [Licença](#licença)\n\n## Destaque: Cloud-Native com Azure/Kubernetes\n\nEste template agora inclui exemplos e configurações otimizadas para ambientes cloud-native, especialmente aqueles baseados em Azure Kubernetes Service (AKS). Aproveite os benefícios de escalabilidade, resiliência e gerenciamento simplificado que o Kubernetes oferece.\n\n## Principais Características\n\n- **Segurança em Primeiro Lugar**: Previne execução como root ou via sudo, e impõe opções de shell seguras (`errexit`, `nounset`, `pipefail`).\n- **Design Modular**: Funções são prefixadas e exportadas seletivamente para evitar poluição do namespace global.\n- **Registro e Cores**: Logger embutido com suporte a cores, detecção de fundo e saída em alto contraste para melhor UX.\n- **Exemplo de Wrapper**: Demonstra como criar um ponto de entrada seguro para seus scripts, com roteamento de argumentos e validação de ambiente.\n- **Utilitários Extensíveis**: Inclui utilitários para prompts de usuário, entrada de segredos e gerenciamento de buffer de terminal.\n\n## Exemplo Clássico de Uso\n\n```bash\n# Uso do wrapper seguro\n./examples/secure_wrapper.sh 2 arg1 arg2\n```\n\nIsso roteará a execução de forma segura para o script e função apropriados, garantindo que todas as verificações de ambiente e registro estejam em vigor.\n\n## Por que usar este template?\n\n- Evita erros comuns de script shell.\n- Facilita a manutenção e extensão dos seus scripts.\n- Fornece uma base profissional para automação, DevOps e tarefas de CI/CD.\n\n## Casos de Uso Detalhados\n\nPara uma compreensão mais profunda de como este template pode ser utilizado, consulte os casos de uso detalhados incluídos na documentação. Eles fornecem exemplos práticos e explicações sobre como tirar o máximo proveito das funcionalidades oferecidas.\n\n## Como contribuir\n\nContribuições são bem-vindas! Sinta-se à vontade para enviar pull requests ou relatar problemas. Juntos, podemos melhorar ainda mais este template e ajudar a comunidade a criar scripts Bash seguros e eficientes.\n\n## Licença\n\nEste projeto está licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.\n\n---\n\n### Compartilhe com a Comunidade\n\nSinta-se à vontade para usar este template como base para seus próprios scripts e compartilhar melhorias ou casos de uso com a comunidade via Gist, DEV.to ou outras plataformas!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubex-ecosystem%2Fshellscript_template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkubex-ecosystem%2Fshellscript_template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkubex-ecosystem%2Fshellscript_template/lists"}