Esta página contém os detalhes de um projeto de redação técnica aceito para a Google Season of Docs.
Resumo do projeto
- Organização de código aberto:
- Projeto do Jenkins
- Redator técnico:
- Zaycodes
- Nome do projeto:
- Jenkins no Kubernetes
- Duração do projeto:
- Duração padrão (três meses)
Project description
O Kubernetes é uma ferramenta de orquestração de contêineres independente de plataforma criada pelo Google e amplamente apoiada pela comunidade de código aberto como um projeto da Cloud Native Computing Foundation. Ele permite que você use e gerencie instâncias de contêiner para escalonamento e tolerância a falhas. Ele também processa uma ampla gama de atividades de gerenciamento que, de outra forma, exigiriam soluções separadas ou código personalizado, incluindo roteamento de solicitações, descoberta de contêineres, verificações de integridade e atualizações contínuas.
O Kubernetes é compatível com a maioria das ferramentas de CI/CD, que permitem que os desenvolvedores executem testes, implantem builds no Kubernetes e atualizem aplicativos sem tempo de inatividade. Atualmente, uma das ferramentas de CI/CD mais conhecidas é o Jenkins pelos seguintes motivos: 1. Ele é de código aberto e sem custo financeiro. 2. Ele é fácil de usar, de instalação e não requer instalações ou componentes adicionais. 3. O Jenkins também é muito fácil de configurar, modificar e ampliar. 4. Ele implanta códigos instantaneamente e gera relatórios de teste. 5. O Jenkins pode ser configurado de acordo com os requisitos de integração e entrega contínuas. 6. O Jenkins está disponível para todas as plataformas e diferentes sistemas operacionais, seja OS X, Windows ou Linux. 7. Ele também tem um ecossistema de plug-ins rico. O grande pool de plug-ins torna o Jenkins flexível e permite criar, implantar e automatizar em várias plataformas. 8. A maior parte do trabalho de integração é automatizada. Assim, há menos problemas de integração. Isso economiza tempo e dinheiro ao longo da vida útil de um projeto.
Os motivos a seguir tornaram o Jenkins no Kubernetes um tema popular entre os usuários do Jenkins. No entanto, atualmente não há um local central para a documentação que descreve o Jenkins no Kubernetes, o que dificulta a navegação e a busca de informações pelos usuários. Esse projeto criaria uma nova página de soluções do Kubernetes que descreveria os conceitos, técnicas e escolhas para usuários do Kubernetes que executam o Jenkins.
Estado atual
Há muitas apresentações e artigos sobre como usar o Jenkins no Kubernetes. No entanto, não há um local central para descrever o Jenkins no Kubernetes. Isso dificulta: 1. Usuários do Jenkins no Kubernetes para navegar e encontrar informações 2. Acompanhar, atualizar e manter informações no Jenkins no Kubernetes
Por que a documentação proposta é uma melhoria em relação à atual?
Para resolver o problema atual com a documentação do Jenkins no Kubernetes, vou criar uma página de soluções do Kubernetes no Jenkins.io seguindo esta estrutura que criei. Essa página vai reunir materiais e projetos relacionados. Esse projeto oferece as seguintes vantagens:
- Melhore a experiência dos usuários do Jenkins no Kubernetes com um único local para encontrar informações sobre o Jenkins no Kubernetes.
- Facilite o rastreamento, a atualização e a manutenção de informações no Jenkins no Kubernetes usando a página "Soluções".
Como desenvolvedor, sei como pode ser frustrante ter problemas e ainda ter que navegar por horas antes de encontrar uma única informação, algo que normalmente levaria alguns minutos para encontrar se a informação estivesse bem estruturada. Escolhi trabalhar neste projeto porque criar uma página de soluções para o Jenkins no Kubernetes me daria a oportunidade de melhorar a experiência dos usuários do Jenkins.
Análise
Criei uma estrutura para a página Soluções do Kubernetes, agregando alguns dos materiais existentes sobre o Jenkins no Kubernetes e links para alguns recursos úteis. Além disso, considerando o fato de que "não é possível criar uma documentação de usuário realmente excelente até que você tenha ouvido as pessoas fora da sua organização que realmente usam os produtos, conheça os problemas delas e tente resolvê-los da melhor maneira possível", compartilhei a nova estrutura da página "Soluções do Kubernetes" com alguns usuários do Jenkins no Kubernetes na minha organização, Interswitch, e também com a comunidade do Jenkins para receber feedback sobre o que eles gostariam de ver na nova documentação. Eles deixaram alguns comentários que também podem ser encontrados na nova estrutura proposta. No entanto, essa estrutura precisa ser aceita e modificada pelos mentores antes do início da implementação.
Metas do projeto
Crie uma nova página de soluções do Kubernetes seguindo essa estrutura na página de soluções do Jenkins ou um volume que descreva os conceitos, técnicas e escolhas para usuários do Kubernetes que executam o Jenkins.