Esta página foi traduzida pela API Cloud Translation.

Projeto do Jenkins X

Esta página contém os detalhes de um projeto de escrita técnica aceito para a temporada de documentos do Google.

Resumo do projeto

Organização de código aberto:: Jenkins X
Redator técnico:: Nitina
Nome do projeto:: Como refatorar o site de documentos do Jenkins X e a matriz de recursos do Jenkins X
Duração do projeto:: Duração padrão (3 meses)

Project description

O principal objetivo deste projeto é refatorar a documentação do Jenkins X e corrigir os problemas relacionados aos documentos, além de preparar a matriz de recursos atualizada do Jenkins X com a documentação do usuário sobre o uso do Jenkins X nos provedores de nuvem empresariais. Este projeto também envolve trabalhar com Daniel no desenvolvimento da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift.

Como parte da refatoração da documentação do Jenkins X, alguns dos problemas em que eu trabalharia:

Recursos de inicialização no EKS: problema
O Vault falha no EKS com inicialização: problema
Envars de documentos para inicialização do jx: problema
Documentação necessária para a configuração do Vault: problema
Falha no upgrade da inicialização do local para o Vault: problema
Relação do feedback da documentação entre "criar" e "instalar jx" x "inicialização" e "importação": problema
A documentação do Helm está espalhada: problema
Melhoria na documentação por que o Chart Museum, Monocular e Docker Registry não são substituídos pelo Nexus Issue
Não foi possível alterar o Docker Registry ao usar a inicialização + GKE: problema
Falha ao alterar o domínio de nip.io para um domínio personalizado: problema

Na Matriz de recursos do Jenkins X, o trabalho envolve, como mencionado abaixo, serviços empresariais do Kubernetes oferecidos por cada um dos provedores do Cloud, ou seja, Google Cloud (GKE), Amazon Web Services (AWS EKS) e Azure Cloud (AKS).

Instalação do Jenkins X na nuvem via scripts do Terraform e jx boot
Verificando a compatibilidade das versões do Kubernetes com o Jenkins X nos serviços do Kubernetes dos provedores de nuvem.
Qualquer outro recurso (armazenamento no Vault para secrets, versões de controle de origem ou outros) a ser discutido com Deane e os membros da comunidade Jenkins X.

Quanto ao trabalho na configuração da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift, o trabalho inclui:

Documento de design na infraestrutura do ambiente de visualização do Jenkins X na plataforma OpenShift
Automatizar a criação de ambientes de visualização do Jenkins X no OpenShift
Atualizar a documentação do Jenkins X em ambientes de visualização

Entregas do projeto:

Correções por meio de relações públicas para os problemas de documentos mencionados acima, considerando a refatoração da documentação existente do Jenkins X.
Atualização da matriz de recursos do Jenkins X com a documentação do usuário sobre como usar o Jenkins X com diferentes provedores de nuvem (serviços do Kubernetes, principalmente AKS, EKS e GKE).
Configuração automatizada da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift, em colaboração com Daniel.

Cronograma provisório (com tarefas) proposto:

Vínculo comunitário (17 de agosto a 13 de setembro)

Configurar o ambiente de desenvolvimento para documentação técnica e acessar infraestruturas de nuvem para trabalhar nas tarefas do projeto.
Discussão com os mentores do projeto sobre o cronograma provisório proposto, as entregas do projeto e as tarefas (junto com a prioridade delas).
Conheça e prepare-se bem com o processo de trabalho da organização e com o processo de análise de relações públicas. Envolva-se com a comunidade.
Revisar o estado atual da documentação do Jenkins X.

Semana 1 (14 a 20 de setembro)

Entender as instruções para configurar o Jenkins X na nuvem, o estado atual e a documentação.
Discussão com Deane sobre os recursos atuais do Jenkins X (a ser verificado em diferentes provedores de nuvem).
Discussão com Daniel sobre o estado atual da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift.
Trabalhe (em colaboração com Daniel) para projetar a arquitetura da infraestrutura do ambiente de visualização do Jenkins X no OpenShift.

Semana 2 (21 de setembro a 27 de setembro)

Trabalhar na matriz de recursos do Jenkins X para a nuvem do GKE: instalar o Jenkins X e preparar o rascunho de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.

Semana 3 (28 de setembro a 4 de outubro)

Trabalhar na matriz de recursos do Jenkins X para a nuvem do GKE: instalar o Jenkins X e preparar o rascunho de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.
Trabalhar na infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift.

Semana 4 (5 a 11 de outubro)

Finalize os documentos do usuário para o Jenkins X no GKE.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.

Semana 5 (12 a 18 de outubro)

Trabalhe na matriz de recursos do Jenkins X para Azure Cloud (AKS): instalação do Jenkins X e preparação de rascunhos de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.
Finalize o documento de design da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift após receber feedback dos membros da comunidade.

Semana 6 (19 a 25 de outubro)

Trabalhe na matriz de recursos do Jenkins X para Azure Cloud (AKS): instalação do Jenkins X e preparação de rascunhos de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.

Semana 7 (26 de outubro a 1o de novembro)

Trabalhe na matriz de recursos do Jenkins X para Azure Cloud (AKS): instalação do Jenkins X e preparação de rascunhos de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.
Trabalhar na configuração da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift.

Semana 8 (2 a 8 de novembro)

Finalize os documentos do usuário para o Jenkins X no AKS.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.

Semana 9 (9 a 15 de novembro)

Trabalhe na matriz de recursos do Jenkins X para AWS (EKS): instalação do Jenkins X e preparação de rascunhos de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.
Trabalhar na configuração da infraestrutura do ambiente de visualização do Jenkins X com base no OpenShift.

Semana 10 (16 a 22 de novembro)

Trabalhe na matriz de recursos do Jenkins X para AWS (EKS): instalação do Jenkins X e preparação de rascunhos de notas do usuário.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.

Semana 11 (23 a 29 de novembro)

Finalize os documentos do usuário para o Jenkins X no EKS.
Trabalhe em um dos problemas de documentação para melhorar a documentação atual do Jenkins X.
Finalizar a documentação da infraestrutura do ambiente de visualização do Jenkins X no site de documentos do Jenkins X.

Semana 12 (30 de novembro a 5 de dezembro)

Finalizar as entregas do projeto e refatorar o código, se houver, com base no feedback.
Testar o funcionamento do site de documentos do Jenkins X, incluindo links, imagens, hiperlinks e outros.
Verifique o controle e a navegação definidos pelo usuário do site de documentos do Jenkins X.
Confira a apresentação finalizada da matriz de recursos do Jenkins X.

Antes de 10 de dezembro de 2020 O redator técnico e os mentores enviam a avaliação do projeto.

Quais benefícios o projeto proposto tem para o Jenkins X e sua comunidade? Esse projeto vai ajudar a comunidade do Jenkins X a melhorar a documentação para usuários finais e desenvolvedores para referência sobre a arquitetura técnica, a compatibilidade, o uso e a integração do Jenkins. Com a conclusão desse projeto proposto, existiria uma documentação do usuário completa, bem definida e tecnicamente verificada do Jenkins X, além da matriz de capacidades do Jenkins X para a compatibilidade com diferentes provedores de nuvem.

Quais benefícios futuros você planeja usar com o Jenkins X? Após o fim do programa Google Season of Docs 2020, pretendo me tornar um colaborador de longo prazo do projeto Jenkins X como um membro ativo da comunidade. Estou sempre por perto para ajudar outras pessoas (novatos) e incentivá-las a se envolverem na comunidade Jenkins X. Estou sempre disposto a trabalhar em outras ideias de projetos do Jenkins X.

Alguns dos motivos que me tornam mais adequado para trabalhar neste projeto:

Sou muito metódico e organizado. Eu espero manter-se informado sobre o progresso do projeto, tanto para os mentores do projeto quanto para a comunidade da organização, por meio de postagens do blog uma vez por semana, reuniões semanais agendadas do SIG-docs e por e-mails regularmente.
Buscará orientação, bem como feedback dos mentores e membros da comunidade com frequência, para avançar nas tarefas e garantir que todos estejam alinhados (mencionando todos os desafios e/ou pontos de bloqueio enfrentados).
Comprometendo todo o código-fonte escrito regularmente, para que o código seja revisado pelo mentor, pelos colaboradores e documentando o trabalho feito para referência aos membros da comunidade.
Tenho todas as habilidades técnicas necessárias para trabalhar na ideia do projeto e discuti a proposta com os mentores Deane, Kara e Daniel. Tenho uma compreensão profunda da proposta do projeto e de suas entregas.
Tenho experiência em trabalhar com as habilidades técnicas (Google Cloud, Azure Cloud, AWS, Kubernetes, OpenShift, Hugo e outras) necessárias para fornecer uma documentação completa e resolver a maioria dos problemas atuais relacionados à documentação. Tenho uma atitude positiva para que o projeto seja feito no prazo e com pouca supervisão.