Ir para o conteúdo principal

Prestações de serviço

Introdução

Serão descritos aqui os requisitos para prestações de serviço, separados por produtos. Os produtos denominados "Sistemas Web" agrupam os requisitos genéricos que são válidos para o grupo todo. Produtos com requisitos específicos serão descritos separadamente.

Qualquer PS que falhe em ter estes requisitos deve ser imediatamente devolvida e corrigida por parte do remetente.

Importante: Algumas prestações de serviço podem ter mais de um serviço solicitado ao mesmo tempo, desde que todos os requisitos mínimos de todos os serviços solicitados estejam adequados.

Toma-se como base para todos os produtos abaixo as seguintes regras:

  • Título deve ser claro eclaro, conciso (deve ser fácil de localizar na lista de PS da equipe); e deve ser relacionado ao pedido em questão;
  • Produto e Serviço preenchidos adequadamente (uma PS a respeito do Jenkins não pode ter ProGet selecionado)
    • Uma exceção a esta regra seria uma PS relacionada a múltiplos serviços, que pode ser marcada como "Outros";
  • Prioridade deve estar marcado corretamente, para não prejudicar o andamento adequado dos trabalhos (Não serão aceitas PS "urgentes" ou de "alta prioridade" que não tem essa necessidade);
  • Chamado, caso tenha, deve ser preenchido para entendimento do contexto;
  • Situação deve ser preenchida como "Em análise";
  • Descrição deve estar preenchida de maneira clara, detalhada e com o português correto, evitando textos dúbios que podem levar à execução de um serviço errado;

DevOps

Bitbucket

  • A descrição deve conter os seguintes dados:
    • Nome do repositório (no formato de nome do projeto, por exemplo, Cebi.Usuarios - o nome informal do sistema pode ser diferente do nome do repositório);
    • Qual o procedimento a ser feito e seu detalhamento. Por exemplo:
      • Criação de novo repositório com nome no formato adequado, indicando quem, além do PO, poderá aceitar PRs em master (caso tenha, o PO deve ter autorizado, seja por mensagem anexada como print ou por comentário/observação no encaminhamento da PS) e informando se precisará de job do Jenkins (neste caso, contendo também todos os requisitos de uma PS para criação de job)
      • Configuração de repositório com nome do repositório e qual o problema a ser resolvido;
      • Inclusão de responsável por aceitar PRs em master com nome completo da pessoa e autorização do PO, seja por mensagem anexada como print ou por comentário/observação no encaminhamento da PS);

Jenkins

  • A descrição deve conter os seguintes dados:
    • Nome do job ou nome do sistema do job (no formato de nome do projeto, por exemplo, Cebi.Usuarios - o nome informal do sistema pode ser diferente do nome do job);
    • Qual o procedimento a ser feito e seu detalhamento. Por exemplo:
      • Criação de novo job com o repositório a qual se refere;
      • Tipo de job, podendo ser projeto Web ou Biblioteca;
      • Verificação de erro de build com o link direto para o log com erro;
      • Manutenção de job, como troca de nome, troca de repositório, troca de JenkinsFile...
      • Criação de novo usuário com nome completo da pessoa e e-mail corporativo;

Importante: para casos de verificação de erro de build a PS deve, necessariamente, ter passado por um desenvolvedor responsável e o mesmo deve incluir na solicitação o que ele já verificou/fez, pois muitas vezes, o erro é de compilação.