{"id":13500626,"url":"https://github.com/waltenne/guiadevopsbrasil","last_synced_at":"2025-03-29T07:31:21.605Z","repository":{"id":37296162,"uuid":"466297909","full_name":"waltenne/guiadevopsbrasil","owner":"waltenne","description":"Repositório para compartilhamento de conteúdo Gratuito sobre DevOps","archived":false,"fork":false,"pushed_at":"2024-10-10T23:51:03.000Z","size":8445,"stargazers_count":299,"open_issues_count":0,"forks_count":33,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-31T19:37:15.048Z","etag":null,"topics":["devops","devops-tools","docker","documentation","iac","linux","python","sre","terraform","windows"],"latest_commit_sha":null,"homepage":"https://guiadevopsbrasil.vercel.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/waltenne.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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}},"created_at":"2022-03-04T23:25:02.000Z","updated_at":"2024-10-15T21:54:42.000Z","dependencies_parsed_at":"2024-10-31T19:42:05.677Z","dependency_job_id":null,"html_url":"https://github.com/waltenne/guiadevopsbrasil","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waltenne%2Fguiadevopsbrasil","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waltenne%2Fguiadevopsbrasil/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waltenne%2Fguiadevopsbrasil/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/waltenne%2Fguiadevopsbrasil/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/waltenne","download_url":"https://codeload.github.com/waltenne/guiadevopsbrasil/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246155992,"owners_count":20732355,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["devops","devops-tools","docker","documentation","iac","linux","python","sre","terraform","windows"],"created_at":"2024-07-31T22:01:07.457Z","updated_at":"2025-03-29T07:31:17.117Z","avatar_url":"https://github.com/waltenne.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e Guia DevOps Brasil \u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cimg src=\"./static/img/home/devops.gif\" alt=\"DevOps Gif\" width=\"500\" height=\"200\" class=\"center\"\u003e\u003cbr\u003e\n\n\u003cimg src=\"https://img.shields.io/badge/Markdown-000000?style=for-the-badge\u0026logo=markdown\u0026logoColor=white\" alt=\"Markdown\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Node.js-43853D?style=for-the-badge\u0026logo=node.js\u0026logoColor=white\" alt=\"Node.js\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/-Docussaurus-Green?logo=site\u0026logoColor=white\u0026style=for-the-badge\" alt=\"Docussaurus\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cstrong\u003eContato\u003c/strong\u003e\u003cbr\u003e\n\u003ca href=\"https://github.com/waltenne\"\u003e\u003cimg src = \"https://img.shields.io/badge/GitHub-100000?style=for-the-badge\u0026logo=github\u0026logoColor=white\"\u003e \u003c/a\u003e    \n\u003ca href=\"https://www.linkedin.com/in/waltenne/\"\u003e\u003cimg src=\"https://img.shields.io/badge/linkedin-%230077B5.svg?\u0026style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\"/\u003e\u003c/a\u003e    \n\u003ca href=\"https://twitter.com/waltenne\"\u003e\u003cimg src = \"https://img.shields.io/badge/Twitter-1DA1F2?style=for-the-badge\u0026logo=twitter\u0026logoColor=white\"\u003e\u003c/a\u003e\n\u003cp\u003e\n\nSeja bem vindo ao projeto **Guia DevOps Brasil**, é um projeto Open Source que nasceu em **Março de 2022**.\n\nCom a ideia de ser um facilitador para organização de conteúdos gratuitos e em português sobre DevOps feitos pela comunidade, na maioria das vezes playlists do youtube.\n\nFoi pensado tanto como nas pessoas que querem entrar na carreira DevOps e não sabem por onde começar, mas também para as pessoas que já estão na área para aprimorar os conhecimentos, ajudando outras pessoas.\n\nEncontrou um Bug 🐛, tem uma ideia 💡? É só abrir uma [issue](https://github.com/waltenne/guiadevopsbrasil/issues). \u003cbr\u003e\nQuer contribuir? Envie uma [PR](https://github.com/waltenne/guiadevopsbrasil/pulls), com a sua melhoria. \u003cbr\u003e\n\n**Caso não saiba como contribuir leia a documentação abaixo ou assista esse vídeo.**\n\n1. [COMO CONTRIBUIR COM OPEN SOURCE NO GITHUB - DANIEL BONIFACIO](https://www.youtube.com/watch?v=n0lSrPl9DTc)\n \n## Indice\n\n- [Indice](#indice)\n- [Como Contribuir?](#como-contribuir)\n  - [Fork](#fork)\n  - [Faça o Clone](#faça-o-clone)\n  - [Instale as dependencias](#instale-as-dependencias)\n  - [Buildando o Projeto](#buildando-o-projeto)\n  - [Iniciando o Projeto](#iniciando-o-projeto)\n- [Como incluir novos conteúdos?](#como-incluir-novos-conteúdos)\n  - [Adicionando conteúdo](#adicionando-conteúdo)\n- [Quem já contribuiu?](#quem-já-contribuiu)\n- [Contribuição](#contribuição)\n\n\n## Como Contribuir?\n\nPara executar o projeto localmente você precisa preparar o seu ambiente relizando a instalação do [Node.js](https://nodejs.org/en/download/) versão **16.14** ou superior.\n \n   * Você poderá utilizar o [nvm](https://learn.microsoft.com/pt-br/windows/dev-environment/javascript/nodejs-on-windows) para o gerenciamento das versões do Node.\n     * Ao instalar o Node.js, é recomendável que você marque todas as caixas de seleção relacionadas às dependências.\n  * Precisa do Git instalado e configurado para sua conta do Github,\n    * [Windows](https://www.youtube.com/watch?v=mmcOw2ynWEs)\n    * [Linux](https://www.youtube.com/watch?v=CSyEYiG8sFI)\n\nComo a integração utiliza o Docussaurus, caso tenha interesse em conhecer e com conhecimentos em front [documentação](https://docusaurus.io/docs), você pode sugerir melhorias para o projeto.\n\n### Fork\n\nPrimeiramenta faça um [Fork ou Bifurcação](https://docs.github.com/pt/get-started/quickstart/contributing-to-projects), do repositório, que funcionará como um cópia do repositório para sua conta.\n\nClique no **Fork**\n\n![](https://docs.github.com/assets/cb-23088/mw-1000/images/help/repository/fork_button.webp)\n\nSiga as etapas para fazer a cópia do repositório em sua conta.\n\n### Faça o Clone\n\nApós o fork ser feito, o repositório irá aparecer na sua conta, abra o repositório e clique no botão Code\n\n![](https://docs.github.com/assets/cb-20363/mw-1000/images/help/repository/code-button.webp)\n\nIrá aparecer três opções para clonar, selecione a que deseja e copie o comando\n\nPor exemplo\n```\ngit clone https://github.com/NOME_SEU_USUARIO/guiadevopsbrasil.git\n```\n\nOnde o **NOME_SEU_USUARIO** é seu usuário do github.\n\n\nApós concluido acesse o diretório a abra o repositório com o seu editor favorito, nesse caso estou usando o vscode\n```\ncd guiadevopsbrasil\ncode .\n```\n\nFaça o checkout para uma nova branch para você trabalhar na edição que precisa,você pode seguir os [Padrões e nomeclaturas do git](https://www.brunodulcetti.com/padroes-e-nomenclaturas-no-git/)\n```\ngit checkout -b nome_da_branch\n```\n\n### Instale as dependencias\n \nCom o terminal aberto na pasta do projeto digite\n\n```\nyarn install\n```\n\nou\n\n```\nnpm install\n```\n \nPronto! Os módulos necessários para buildar e rodar os projeto estão instalados.\n \n### Buildando o Projeto\n\n```\nnpm run build\n```\n\n### Iniciando o Projeto\n\nPara iniciar o projeto digite o seguinte comando\n\n```\nnpm run serve\n```\n\nApós isso, acesse via navegador no endereço **http://localhost:3000**\n\n## Como incluir novos conteúdos?\n\nSe você olhar os arquivos dos conteúdos estão no diretório **docs/**, a partir disso organizado de acordo com a sua categoria, todos os arquivos em formato markdown clique [aqui](https://www.markdownguide.org/) para ver uma documentação de referência para edição nessa linguagem, mas você pode se basear os arquivos markdown já existentes.\n\n### Adicionando conteúdo\n\nDecidi embedar / incorporar o player do youtube no markdown.\n\nAcredito que dessa forma quem for acessar terá uma experiência melhor em vez de simplesmente sir lincando os links dos videos, para fazer isso utilizo o código iframe, o próprio código que o youtube disponibilzia ao clicar em incorporar.\n\n**Como no exemplo a seguir**\n\n![youtube](static/img/readme/youtube_md.png)\n\n**1.** O que está em verde é o Título dessa página. \n**2.** O que está em azul são os valores que precisam ser alterados para cada vídeos diferente, seja o título do video com a numeração da quantidade por exemplo video 1. video 25. etc etc e no final o id do video no youtube.\n\nPara tentar facilitar o entendimento mais baixo nível, agora vou descrever passo a passo.\n\nPor exemplo temos a seguinte playlist do youtube do Curso em Video\n\n```\nhttps://www.youtube.com/watch?v=xEKo29OWILE\u0026list=PLHz_AreHm4dm7ZULPAmadvNhH6vk9oNZA\n```\n\nA url é montada da seguinte forma\n\n**URL BASE**\n```\nhttps://www.youtube.com/watch\n```\n\n**ID do video atual** = xEKo29OWILE\n```\n?v=xEKo29OWILE\n```\n**ID da playlist** = PLHz_AreHm4dm7ZULPAmadvNhH6vk9oNZA\n```\n\u0026list=PLHz_AreHm4dm7ZULPAmadvNhH6vk9oNZA\n```\n\nCom base no print acima, precisamos apenas de duas informações o ID do video para montar substituir os itens do código e o titulo do vídeo, se uma playlist for muito grande pode dar um pouco de trabalho para fazer isso na mão por isso eu deixo uma ferramenta para auxiliar o **extract_yt_playlist.sh**, ele via montar o markdown 99% pronto para você, bastando informar qual é o ID da playlist, seguindo o exemplo a seguir vou demonstrar como funciona.\n\nNo terminal basta chamar dessa forma\n\n```bash\n./extract_yt_playlist.sh ID_PLAYLIST_YOUTUBE\n```\nSubstituindo o **ID_PLAYLIST_YOUTUBE** pelo ID correto da playlist, ao executar o script **apenas para linux**, irá gerar um arquivo markdown 99% pronto com o que você precisa **playlist_converted.md**\n\n\n![](./static/img/readme/youtube_extractor.gif)\n\n\nAssim que for gerado renomeie o **playlist_converted.md** para o nome da página que você ache mais interessante, por exemplo.\n\n```bash\nmv playlist_converted.md curso_git_curso_em_video.md\n```\n\nAbra o arquivo renomeado e na primeira linha digite um título, por exemplo\n\n```markdown\n# Curso Git e Github - Curso em Video\n\n- - -\n# 1. O que é Git? O que é versionamento? - Curso de Git e GitHub\n \u003ciframe allowfullscreen='allowfullscreen'\n\t mozallowfullscreen='mozallowfullscreen'\n\t msallowfullscreen='msallowfullscreen'\n\t oallowfullscreen='oallowfullscreen'\n\t webkitallowfullscreen='webkitallowfullscreen'\n\t width='560' height='315'\n\t frameborder='0'\n\t allow='accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture'\n\t src='https://www.youtube.com/embed/xEKo29OWILE'\u003e\n \u003c/iframe\u003e\n```\n\nMova o arquivo md gerado para o diretório que deverá ficar, por exemplo esse curso ficará no nível avançado então ficando dessa forma, dependendo do assunto se for ter mais de um curso sobre ele por exemplo, git linux e tals, pode ser criado uma subpasta para organização e ir linkando os arquivos, na dúvida sempre pegue de referência o que já está cadastrado.\n\n```bash\nmv curso_git_curso_em_video.md docs/niveis/avancado/git/\n```\nPara finalizar, falta mapear o markdown no menu que irá aparecer, como o assunto de git, já tem um subpasta mapeado, abra o arquivo git.md e adicione o mapeamento para esse arquivo md, como por exemplo no item 1 basicamente\n\n```\nNUMERO_ORDENADO_DO_ITEM. [Assunto](./arquivo.md)\n```\n\nComo do exemplo abaixo\n\n```md\n# Git\n\n1. [Github - Curso em Vídeo](./github_curso_em_video.md)\n2. [Git 4 Noobs](https://github.com/DanielHe4rt/git4noobs)\n3. [Comandos Git](https://github.com/theandersonn/comandos-git)\n4. [Aprenda Git](https://learngitbranching.js.org/)\n5. [Git School](https://git-school.github.io/visualizing-git/)\n6. [Git Flow Cheatsheet](https://danielkummer.github.io/git-flow-cheatsheet/)\n```\n\nFeito isso agora precisa ser incluido essa alteração no arquivo **sidebars.js**, basta fazer o mapeamento seguindo os diretórios e categorias, como por exemplo.\n\n![](./static/img/readme/sidebars.png)\n\n\n**Obs:** Para conteúdos onde não existe uma playlist do youtube, por exemplo um único vídeo que explica sobre um assunto x ou um link de documentação ou até de outro repositório não precisa fazer todo aquele processo acima utiliando o script, basta realizar a edição direta do **arquivo.md** do assunto principal ou criar um novo para esse assunto fazendo os mapeamento necessários.\n\n\n## Quem já contribuiu?\n\n\u003cp align=\"center\"\u003e\n  \u003ca href = \"https://github.com/waltenne/guiadevopsbrasil/graphs/contributors\"\u003e\n    \u003cimg src = \"https://contributors-img.web.app/image?repo=waltenne/guiadevopsbrasil\" alt=\"Quem já contribuiu\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n## Contribuição\n\nPull requests são bem-vindos. Para grandes mudanças, por favor, abra primeiro uma issue para discutirmos a mudança.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaltenne%2Fguiadevopsbrasil","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwaltenne%2Fguiadevopsbrasil","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwaltenne%2Fguiadevopsbrasil/lists"}