1 - OBJETIVO ... 2
2 - APLICABILIDADE ... 2
3 - DOCUMENTOS COMPLEMENTARES ... 2
3.1 Instrução de Trabalho para Versionamento de Itens de Configuração. ... 2 3.2 Instrução de Trabalho para Descrição de Checkout/Checkin. ... 2
4 – TERMOS E DEFINIÇÕES ... 2
4.1 Desenvolvedor ... 2 4.2 Chefes de Setores ... 2 4.3 Diretor do SRDM ... 2 4.4 Configuração de Produção (CFG_PRD_<SIS>) ... 3
5 – CONSIDERAÇÕES GERAIS ... 3
5.1 Atribuições e responsabilidades ... 3
6 – NORMAS ... 3
7 – AÇÕES PARA TRATAMENTO DE EXCEÇÕES ... 4
7.1 Situações específicas ... 4 7.2 Ações ... 5
Código: SEPROD.SRDM.N.001 Data: 29/06/2002 Revisão: 04 Página: 2 de 6
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST
1 - OBJETIVO
Esta norma estabelece os aspectos que devem ser observados pelos Desenvolvedores quando executarem o Processo de Controle de Versões de Software.
2 - APLICABILIDADE
Esta norma aplica-se aos Desenvolvedores e Chefes de setores.
3 - DOCUMENTOS COMPLEMENTARES
3.1 Instrução de Trabalho para Versionamento de Itens de Configuração. 3.2 Instrução de Trabalho para Descrição de Checkout/Checkin.
4 – TERMOS E DEFINIÇÕES
4.1 Desenvolvedor
Servidor lotado no Setor de Sistemas Administrativos (STSAF), no Setor de Sistemas Jurídicos (STSJ) ou no Setor de Sistemas de Recursos Humanos (STSRH) que exerçam a atividade de Analista de Sistemas ou de Programador.
4.2 Chefes de Setores
Analistas e programadores líderes de projetos novos ou em andamento nos setores: Sistemas Administrativos e Financeiros (STSAF), Sistemas Jurídicos (STSJ), Recursos Humanos (STSRH), Tecnologia Internet (STTI), Projeto e Modelagem de Banco de Dados (STPMDB) e Setor Normativo e de Documentação (STND).
4.3 Diretor do SRDM
Tribunal Superior do Trabalho de Software
Código: SEPROD.SRDM.N.001 Data: 29/06/2002 Revisão: 04 Página: 3 de 6
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST
4.4 Configuração de Produção (CFG_PRD_<SIS>)
É o conjunto de itens de configuração (componentes) de um sistema. Esse agrupamento de itens deve refletir o conjunto dos arquivos, documentos e demais itens relativos à versão de produção de um sistema disponibilizado para o usuário.
5 – CONSIDERAÇÕES GERAIS
5.1 Atribuições e responsabilidades
5.1.1 Cabe aos Desenvolvedores executarem os pedidos de alteração de versão dos itens de configuração quando autorizados.
5.1.2 Cabe aos Chefes de Setores deliberarem sobre a pertinência de um pedido de modificação da configuração visando decidir sobre a sua aprovação, rejeição ou submissão ao Quadro de Controle de Mudanças.
5.1.3 Cabe ao Diretor do SRDM a palavra final sobre a aceitação, rejeição ou colocação no quadro de controle de mudanças, de um pedido de mudança na configuração de um sistema.
6 – NORMAS
6.1 O escopo do processo de controle de versões abrange os ambientes de desenvolvimento, de homologação e de produção.
6.2 É obrigatória a conferência entre versões, antes da alteração de um IC.
6.2.1 Antes de um código ser mantido, deve-se verificar se a versão de desenvolvimento confere com a versão da Configuração de Produção e com a do File System (ambiente de produção).
6.2.2 Caso haja alguma divergência, verificar a descrição das últimas operações de Checkin e Checkout das Configurações de produção e dos ICs, bem como o histórico de mudanças efetuadas naquele IC.
6.2.3 Se ainda assim não for possível resolver, procurar os responsáveis pelas operações com a finalidade de compatibilizar as versões divergentes.
6.3 Para testar uma versão em desenvolvimento, manter o IC no estado de Checkout. 6.4 Todo IC no estado de Checkin não está em Manutenção/Desenvolvimento.
Código: SEPROD.SRDM.N.001 Data: 29/06/2002 Revisão: 04 Página: 4 de 6
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST
6.5 Todo IC em Checkout está em Manutenção/Desenvolvimento.
6.6 Uma Configuração de Produção no estado de Checkout possui ICs em Homologação. 6.7 Uma Configuração de Produção no estado de Checkin não possui IC´s em Homologação.
6.8 Para homologar uma Configuração o IC deve estar no estado de Checkin e a Configuração de Produção no estado de Checkout.
6.9 Para distribuir uma Configuração de Produção, ela deve alternar-se entre os estados de Checkout e Checkin, observando as regras descritivas na Instrução de Trabalho para Descrição de Checkout/Checkin.
6.10 É provável que a última versão do IC seja a mesma do ambiente de produção e de homologação.
7 – AÇÕES PARA TRATAMENTO DE EXCEÇÕES
7.1 Situações específicas
Situação IC Configuração de Produção Leitura
A CheckOUT CheckOUT Desenvolvimento/Homologando
B CheckOUT CheckIN Desenvolvimento
C CheckIN CheckOUT Homologando
D* CheckIN CheckIN Homologada
Tabela G-I. Situações possíveis de estado do código sob controle de versões. * Situação preferencial
Tribunal Superior do Trabalho de Software
Código: SEPROD.SRDM.N.001 Data: 29/06/2002 Revisão: 04 Página: 5 de 6
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST
7.2 Ações
Situação Tipo da Manutenção Ações do Desenvolvedor
A
Emergencial Se mesmo módulo
Gerar .KEEP (mantém desenvolvimento atual);
Independente dos Módulos Gerar nova versão do Fonte
Testar em desenvolvimento e fazer CheckIN do Fonte.
Copiar o comentário de checkout da CFG_PRD_<SIS>
Executar UndoCheckout da CFG_PRD Executar novo Checkout adicionando a descrição Checkout atual com a anterior.
Obter homologação do Fonte Receber homologação
Colocar em Produção. Alterar a
CFG_PRD_<SIS> incluindo o fonte homologado e fazer CheckIN. Caso persista algum(ns) Fonte(s) para homologar, fazer CheckOUT da versão recém criada da CFG_PRD_<SIS> adicionando a(s) descrição(ões) do(s) código(s) que falta(m) homologar.
Convencional Entrar em acordo com quem estiver mantendo o
Fonte, afim de evitar manutenção concorrente.
B
Emergencial Gerar .KEEP (mantém desenvolvimento atual)
Gerar nova versão do Fonte (criação da próxima versão de homologação)
Fazer CheckIN do Fonte
Fazer CheckOUT da CFG_PRD_<SIS> Obter homologação do Fonte
Receber homologação Colocar em Produção:
- Fazer CheckOUT da CFG_PRD_<SIS> - Alterar a CFG com a nova versão do fonte homologado.
- Fazer CheckIN da CFG_PRD_<SIS>
Convencional Entrar em acordo com quem estiver mantendo o
Código: SEPROD.SRDM.N.001 Data: 29/06/2002 Revisão: 04 Página: 6 de 6
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST
C
Emergencial Fazer CheckOUT do Fonte
Gerar nova versão do Fonte (criação de duas ou mais versões de homologação)
Testar em desenvolvimento e fazer CheckIN do Fonte
Manter a CFG_PRD_<SIS> em CheckOUT Obter homologação do Fonte
Receber homologação
Colocar em Produção. Alterar a CFG_PRD_<SIS> incluindo o fonte homologado e fazer CheckIN. Caso persista algum(ns) Fonte(s) para homologar, fazer CheckOUT da versão recém criada da CFG_PRD_<SIS>.
Convencional Entrar em acordo com quem estiver mantendo o
código, afim de evitar manutenção concorrente.
D
Emergencial CheckOUT do Fonte (desenvolvimento)
CheckIN do Fonte (homologação ou equívoco) CheckOUT na CFG (homologação)
CheckIN na CFG (produção)
Convencional CheckOUT do Fonte (desenvolvimento)
CheckIN do Fonte (homologação ou equívoco) CheckOUT na CFG (homologação)
CheckIN na CFG (produção) Tabela G-II. Ações no relacionamento com o repositório.
Código: SEPROD.SRDM.I.002 Data: 08/03/2002 Revisão: 02 Página: 1 de 4
Elaborado por Revisado por Aprovado por
Iniciais :_______________ Iniciais :_______________ Iniciais :_______________
Rubrica :______________ Rubrica :______________ Rubrica :______________
Data : ____/_____/____ Data : _____/_____/_____ Data : _____/_____/_____
Este documento não pode ser copiado ou cedido sem prévia autorização do Tribunal Superior do Trabalho - TST