|
<table>
|
|
<table>
|
|
<tr>
|
|
<tr>
|
|
<th> [Home](home) </th>
|
|
<th>
|
|
<th> [Escopo e Cronograma](Escopo e Cronograma) </th>
|
|
|
|
<th> [Processo](Processo) </th>
|
|
[Home](home)
|
|
<th> [Design/Mockups](Design & Mockups) </th>
|
|
</th>
|
|
<th> [Configuração](Configuracao) </th>
|
|
<th>
|
|
<th> [Arquitetura](Arquitetura) </th>
|
|
|
|
<th> [Infra](Infraestrutura) </th>
|
|
[Escopo e Cronograma](Escopo%20e%20Cronograma)
|
|
<th> [Código](Codigo) </th>
|
|
</th>
|
|
<th> [BD](Banco de dados) </th>
|
|
<th>
|
|
<th> [Backend](Backend) </th>
|
|
|
|
<th> [Frontend](Frontend) </th>
|
|
[Processo](Processo)
|
|
<th> [Qualidade](Qualidade) </th>
|
|
</th>
|
|
</tr>
|
|
<th>
|
|
|
|
|
|
|
|
[Design/Mockups](Design%20&%20Mockups)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Configuração](Configuracao)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Arquitetura](Arquitetura)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Infra](Infraestrutura)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Código](Codigo)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[BD](Banco%20de%20dados)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Backend](Backend)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Frontend](Frontend)
|
|
|
|
</th>
|
|
|
|
<th>
|
|
|
|
|
|
|
|
[Qualidade](Qualidade)
|
|
|
|
</th>
|
|
|
|
</tr>
|
|
</table>
|
|
</table>
|
|
|
|
|
|
## Descrição
|
|
## Descrição
|
... | @@ -49,35 +85,36 @@ A branch **development** é a branch default para desenvolvimento do projeto. Es |
... | @@ -49,35 +85,36 @@ A branch **development** é a branch default para desenvolvimento do projeto. Es |
|
#### Branches não protegidas
|
|
#### Branches não protegidas
|
|
|
|
|
|
##### **Feature**:
|
|
##### **Feature**:
|
|
Branches para a implementação de funcionalidades novas. O padrão de nomenclatura utilizado é _feature/US-númerodaUS-atividade-desenvolvida_, que representa uma breve descrição do que está sendo implementado na branch.
|
|
|
|
|
|
|
|
Exemplo: _feature/US-03-tela-login._
|
|
Branches para a implementação de funcionalidades novas. O padrão de nomenclatura utilizado é _feature_ Número da feature_/atividade-desenvolvida_, que representa uma breve descrição do que está sendo implementado na branch.
|
|
|
|
|
|
|
|
Exemplo: _feature3/tela-login._
|
|
|
|
|
|
MRs dessas branches devem sempre ser abertos *para* **development**.
|
|
MRs dessas branches devem sempre ser abertos _para_ **development**.
|
|
|
|
|
|
##### **Fix**
|
|
##### **Fix**
|
|
Branches para correção de bugs. O padrão de nomenclatura utilizado é _fix/US-01-problema_, que representa uma breve descrição do que está sendo corrigido na branch. Exemplo: _fix/US-01-bug-botão-header_.
|
|
|
|
|
|
|
|
Em caso de `Fix`, devem ser abertos Merge Requests para **main** e **development**.
|
|
Branches para correção de bugs. O padrão de nomenclatura utilizado é _fix_ Número da fix_/problema_, que representa uma breve descrição do que está sendo corrigido na branch. Exemplo: _fix1/bug-botão-header_.
|
|
|
|
|
|
|
|
Em caso de `Fix`, devem ser abertos Merge Requests para **main** e **development**.
|
|
|
|
|
|
#### Como criar uma branch?
|
|
#### Como criar uma branch?
|
|
|
|
|
|
Para garantir que o processo de desenvolvimento esteja sempre atualizado, lembre-se de executar o seguinte comando na branch dev antes de criar uma branch nova:
|
|
Para garantir que o processo de desenvolvimento esteja sempre atualizado, lembre-se de executar o seguinte comando na branch dev antes de criar uma branch nova:
|
|
|
|
|
|
```
|
|
```plaintext
|
|
git pull origin development
|
|
git pull origin development
|
|
```
|
|
```
|
|
|
|
|
|
Depois da execução desse comando é necessário oficialmente criar a Branch, para isso, execute o seguinte comando:
|
|
Depois da execução desse comando é necessário oficialmente criar a Branch, para isso, execute o seguinte comando:
|
|
|
|
|
|
```
|
|
```plaintext
|
|
git checkout -b <nomeDaBranch>
|
|
git checkout -b <nomeDaBranch>
|
|
```
|
|
```
|
|
|
|
|
|
Assim que criar a branch, é necessário fazer um \\\`push\\\`para garantir que a mesma estará remota:
|
|
Assim que criar a branch, é necessário fazer um \\\`push\\\`para garantir que a mesma estará remota:
|
|
|
|
|
|
```
|
|
```plaintext
|
|
git push --set-upstream origin <nomeDaBranch>
|
|
git push --set-upstream origin <nomeDaBranch>
|
|
```
|
|
```
|
|
|
|
|
... | @@ -107,12 +144,9 @@ git commit -m 'descrição da tarefa em português' |
... | @@ -107,12 +144,9 @@ git commit -m 'descrição da tarefa em português' |
|
|
|
|
|
</div>O padrão de commits é que as mensagens devem ser em Português.
|
|
</div>O padrão de commits é que as mensagens devem ser em Português.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
#### Salvando Remotamente
|
|
#### Salvando Remotamente
|
|
|
|
|
|
Depois de finalizar o desenvolvimento, envie todos os commits da sua máquina para o GitLab.
|
|
Depois de finalizar o desenvolvimento, envie todos os commits da sua máquina para o GitLab. Para isso depois de realizar as etapas de salvamento local, salve remotamente com o comando `push`:
|
|
Para isso depois de realizar as etapas de salvamento local, salve remotamente com o comando `push`:
|
|
|
|
|
|
|
|
<div>
|
|
<div>
|
|
|
|
|
... | @@ -121,18 +155,17 @@ git push |
... | @@ -121,18 +155,17 @@ git push |
|
```
|
|
```
|
|
|
|
|
|
#### Abrindo um Merge Request
|
|
#### Abrindo um Merge Request
|
|
|
|
|
|
Após a realização do desenvolvimento de uma tarefa e ela estiver de acordo com os critérios de aceitação, é necessário que a mesma seja enviada para a branch de development, então deve-se abrir um Merge Request.
|
|
Após a realização do desenvolvimento de uma tarefa e ela estiver de acordo com os critérios de aceitação, é necessário que a mesma seja enviada para a branch de development, então deve-se abrir um Merge Request.
|
|
|
|
|
|
Para criar o Merge Request devem ser seguidos os seguintes passos:
|
|
Para criar o Merge Request devem ser seguidos os seguintes passos:
|
|
1. Selecionar a branch de origem (branch de desenvolvimento) e branch (branch de development) de destino.
|
|
|
|
|
|
|
|
|
|
1. Selecionar a branch de origem (branch de desenvolvimento) e branch (branch de development) de destino.
|
|
2. Selecionar `Compare branch and continues`.
|
|
2. Selecionar `Compare branch and continues`.
|
|
|
|
|
|
3. No campo **Title**, preencher com um título que descreva a funcionalidade implementada ou bug corrigido e o número da tarefa que está sendo realizada.
|
|
3. No campo **Title**, preencher com um título que descreva a funcionalidade implementada ou bug corrigido e o número da tarefa que está sendo realizada.
|
|
|
|
|
|
4. No campo **Description**, preencher utilizando o seguinte template:
|
|
4. No campo **Description**, preencher utilizando o seguinte template:
|
|
|
|
|
|
```
|
|
```plaintext
|
|
## Link da Tarefa
|
|
## Link da Tarefa
|
|
[Inserir link da tarefa do Trello]
|
|
[Inserir link da tarefa do Trello]
|
|
|
|
|
... | @@ -153,9 +186,7 @@ Para criar o Merge Request devem ser seguidos os seguintes passos: |
... | @@ -153,9 +186,7 @@ Para criar o Merge Request devem ser seguidos os seguintes passos: |
|
```
|
|
```
|
|
|
|
|
|
4. Na seção **Asignee**, selecione **Assign to me** para que você fique registrado como responsável pelo desenvolvimento daquela tarefa.
|
|
4. Na seção **Asignee**, selecione **Assign to me** para que você fique registrado como responsável pelo desenvolvimento daquela tarefa.
|
|
|
|
|
|
5. Em **Labels** adicione o tipo da tarefa que foi realizado.
|
|
5. Em **Labels** adicione o tipo da tarefa que foi realizado.
|
|
|
|
|
|
6. Revise se os arquivos estão corretos e clique em **Submit Merge Request**.
|
|
6. Revise se os arquivos estão corretos e clique em **Submit Merge Request**.
|
|
|
|
|
|
#### Revisando o Merge Request
|
|
#### Revisando o Merge Request
|
... | @@ -177,7 +208,7 @@ Uma vez que a revisão tenha sido concluída e todos os pontos de ajuste apontad |
... | @@ -177,7 +208,7 @@ Uma vez que a revisão tenha sido concluída e todos os pontos de ajuste apontad |
|
|
|
|
|
No final de cada Sprint, para gerar uma nova versão do projeto a ser apresentada para o cliente, deve ser aberto um Merge Request para realizar o merge da branch develop na branch master, atualizando o código de produção com os desenvolvimentos realizados durante a sprint.
|
|
No final de cada Sprint, para gerar uma nova versão do projeto a ser apresentada para o cliente, deve ser aberto um Merge Request para realizar o merge da branch develop na branch master, atualizando o código de produção com os desenvolvimentos realizados durante a sprint.
|
|
|
|
|
|
O merge deve ser feito com a estratégia *squash-commits* e as branches devem ser excluídas após o merge para a branch de destino.
|
|
O merge deve ser feito com a estratégia _squash-commits_ e as branches devem ser excluídas após o merge para a branch de destino.
|
|
|
|
|
|
### Práticas de CI/CD
|
|
### Práticas de CI/CD
|
|
|
|
|
... | @@ -199,3 +230,5 @@ A pipeline criada pode ser vista [aqui](https://tools.ages.pucrs.br/sem-barreira |
... | @@ -199,3 +230,5 @@ A pipeline criada pode ser vista [aqui](https://tools.ages.pucrs.br/sem-barreira |
|
- Ao se criar uma Tag a partir da branch main, realiza-se o deploy da imagem identificada pelo nome da tag, para o ambiente de produção.
|
|
- Ao se criar uma Tag a partir da branch main, realiza-se o deploy da imagem identificada pelo nome da tag, para o ambiente de produção.
|
|
|
|
|
|
Os dois primeiros estágios estão relacionados ao processo de integração contínua, ou seja, de integrar novas mudanças no código do repositório de Backend. Por outro lado, os dois últimos estágios estão relacionados à entrega contínua, no sentido que automatizam a liberação do código gerado, incluindo a sua implantação no ambiente produtivo.
|
|
Os dois primeiros estágios estão relacionados ao processo de integração contínua, ou seja, de integrar novas mudanças no código do repositório de Backend. Por outro lado, os dois últimos estágios estão relacionados à entrega contínua, no sentido que automatizam a liberação do código gerado, incluindo a sua implantação no ambiente produtivo.
|
|
|
|
|
|
|
|
</div> |
|
|
|
\ No newline at end of file |