Trabalhar com problemas e solicitações de pull

Esta página descreve como trabalhar com problemas e solicitações de extração na interface da Web do Secure Source Manager.

Para acessar a instância do Secure Source Manager pela interface da Web, copie o seguinte URL na barra de endereço do navegador.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Substitua:

  • INSTANCE_ID com o nome da instância.
  • PROJECT_NUMBER pelo número do projeto Google Cloudda instância. Para informações sobre como identificar projetos, consulte Identificar projetos.
  • LOCATION com a região da instância.

Funções exigidas

Para receber as permissões necessárias para trabalhar com problemas e solicitações de pull, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Para informações sobre como conceder papéis do Secure Source Manager, consulte Controle de acesso com o IAM e Conceder acesso à instância aos usuários.

Ver solicitações de envio

Você pode ver todos os pull requests a que tem acesso ou os de um repositório específico.

Os repositórios vazios não têm uma guia Solicitações de envio. Depois de enviar para um repositório, você pode acessar a guia de solicitação de envio.

Para ver solicitações de envio ou problemas atribuídos a você, navegue até a guia Problemas ou Solicitações de envio do Secure Source Manager e clique em Atribuído a mim.

Para ver as solicitações de envio de um repositório:

  1. Na interface da Web do Secure Source Manager, selecione seu repositório.
  2. Na página do repositório, clique na guia Solicitações de envio.
  3. É possível filtrar ou classificar as solicitações de pull usando os menus suspensos para Responsável, Tipo ou Ordenar.

Para ver todas as solicitações de pull:

  1. Na interface da Web do Secure Source Manager, clique na guia Solicitações de envio.

  2. É possível filtrar ou classificar as solicitações de pull usando os menus suspensos para Responsável, Tipo ou Ordenar.

Criar uma solicitação de envio

  1. Na interface da Web do Secure Source Manager, selecione o repositório para o qual você quer criar uma solicitação de envio.
  2. Na página do repositório, clique na guia Pull requests.
  3. Clique em Nova solicitação de pull.
  4. No menu mesclar em, selecione a ramificação em que você quer mesclar a solicitação de extração.
  5. No menu extrair de, selecione a ramificação de onde extrair.
  6. Clique em Nova solicitação de pull.
  7. Dê um título e uma descrição à solicitação de envio e anexe os arquivos relevantes.

  8. Clique em Criar solicitação de pull.

    Você vai acessar a página de solicitação de envio, onde é possível adicionar revisores, rótulos, marcos e atribuídos.

Editar detalhes da solicitação de envio

É possível adicionar Revisores, Rótulos, Marcos, Responsáveis e uma Data de conclusão a uma solicitação de envio.

Para adicionar Revisores, Marcadores, Marcos e Responsáveis:

Na página da solicitação de envio, clique no ícone de engrenagem ícone de engrenagem ao lado do detalhe que você quer editar.

As edições são salvas automaticamente.

Para atualizar a Data de entrega:

  1. Clique no ícone de calendário na seção Data de entrega e selecione uma data.
  2. Clique no Ícone "Mais" ícone de adição para salvar a data de vencimento.

Revisar uma solicitação de envio

Os revisores podem adicionar comentários, pedir mudanças e aprovar uma solicitação de envio.

Para revisar uma solicitação de envio atribuída a você:

  1. Na interface da Web do Secure Source Manager, clique na guia Solicitações de envio.
  2. Clique em Atribuído a você.

  3. Clique na solicitação de envio que você quer analisar.

    A página Conversa é aberta. Você pode conferir os comentários deixados pelo autor da solicitação de envio ou por outros revisores.

  4. Para ver e comentar os arquivos alterados, clique na guia Arquivos alterados. Para mudar o comportamento da visibilidade de espaços em branco, clique nos menus suspensos Espaços em branco, Visualização dividida/Visualização unificada e Opções de diff.

  5. Para deixar um comentário, clique no ícone de adição ao lado da linha que você quer comentar.

  6. Clique em Iniciar análise.

  7. Para deixar outros comentários, clique no ícone de adição na linha em que você quer comentar e depois em Adicionar comentário.

    Os comentários aceitam formatação com Markdown.

  8. Para enviar seus comentários, aprovar a solicitação de envio ou pedir mudanças, clique em Revisar.

  9. Deixe um comentário para resumir as mudanças ou deixe o espaço em branco e selecione uma das seguintes opções:

    • Aprovar: aprova as mudanças.
    • Comentar: envie seus comentários sem aprovar a solicitação de envio.

    • Solicitar alterações: solicite alterações na solicitação de envio.

Mesclar solicitações de pull

  1. Na página do repositório, clique na guia Pull requests.
  2. Selecione a solicitação de envio que você quer mesclar.
  3. Se não houver conflitos, clique em Mesclar solicitação de pull.

Ver problemas

  1. Na interface da Web do Secure Source Manager, selecione seu repositório.
  2. Na página do repositório, clique na guia Problemas.
  3. É possível filtrar ou classificar os problemas usando os menus de Responsável, Tipo ou Ordenar.

Criar um problema

  1. Na interface da Web do Secure Source Manager, selecione seu repositório.
  2. Na página do repositório, clique na guia Problemas.
  3. Clique em Novo problema.
  4. Insira o título e a descrição do problema e clique em Criar problema.

  5. Na página de detalhes do problema, é possível atribuir rótulos, marcos, responsáveis e especificar um ramo ou uma tag.

Adicionar diagramas com o Mermaid

O Secure Source Manager é compatível com a renderização de diagramas Mermaid em arquivos Markdown (como README.md), descrições de solicitação de envio, problemas e comentários.

Para adicionar um diagrama, use um bloco de código delimitado mermaid:

```mermaid
graph TD
    A[Write Markdown] --> B(Click Preview Tab)
    B --> C{Does it render?}
    C -- Yes --> D[Success]
    C -- No --> E[Check Syntax]
```

Clique na guia Visualização no editor do Markdown para verificar se o diagrama é renderizado antes de salvar.

Tipos de diagramas compatíveis

O Secure Source Manager é compatível com os seguintes tipos de diagramas do Mermaid:

  • Fluxogramas: graph ou flowchart (compatível com TD, TB, LR, BT, RL)
  • Diagramas de sequência: sequenceDiagram
  • Diagramas de classes: classDiagram
  • Diagramas de entidade-relacionamento: erDiagram
  • Diagramas de estado: stateDiagram ou stateDiagram-v2
  • Gráficos XY: xychart-beta ou xychart

Comportamento e limitações de renderização

  • Renderização estática: os diagramas são renderizados como imagens estáticas. Recursos interativos (como callbacks click e dicas) e scripts externos são desativados por segurança.
  • Adaptação de tema: os diagramas se adaptam automaticamente aos temas claro e escuro.
  • Acessibilidade: os diagramas renderizados incluem texto alternativo preenchido com o código-fonte do diagrama para leitores de tela.
  • Tipos de diagrama não aceitos: mostram uma mensagem de erro e não são renderizados. Entre eles estão os diagramas de Gantt, mapa mental, pizza, Gitgraph, jornada do usuário, requisito, C4, linha do tempo, Sankey e blocos. Para tipos de diagrama não compatíveis, renderize o diagrama localmente em uma imagem (PNG ou SVG) e incorpore usando a sintaxe padrão de imagem do Markdown.

A seguir