Trabaja con problemas y solicitudes de extracción

En esta página, se describe cómo trabajar con problemas y solicitudes de extracción en la interfaz web de Secure Source Manager.

Para acceder a la instancia de Secure Source Manager a través de su interfaz web, copia la siguiente URL en la barra de direcciones de tu navegador.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Reemplaza lo siguiente:

  • INSTANCE_ID por el nombre de la instancia.
  • PROJECT_NUMBER por el número de proyecto de la instancia Google Cloud. Para obtener información sobre cómo identificar proyectos, consulta Identifica proyectos.
  • LOCATION por la región de la instancia.

Roles obligatorios

Para obtener los permisos que necesitas para trabajar con problemas y solicitudes de extracción, pídele a tu administrador que te otorgue los siguientes roles de IAM:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener información sobre cómo otorgar roles de Secure Source Manager, consulta Control de acceso con IAM y Otorga acceso a la instancia a los usuarios.

Cómo ver solicitudes de extracción

Puedes ver todas las solicitudes de extracción a las que tienes acceso o las solicitudes de extracción de un repositorio específico.

Los repositorios vacíos no tienen la pestaña Pull requests. Una vez que envíes los cambios a un repositorio, podrás ver la pestaña de solicitud de extracción.

Para ver las solicitudes de extracción o los problemas que se te asignaron, navega a la pestaña Issues o Pull requests de Secure Source Manager y haz clic en Assigned to me.

Para ver las solicitudes de extracción de un repositorio, sigue estos pasos:

  1. En la interfaz web de Secure Source Manager, selecciona tu repositorio.
  2. En la página del repositorio, haz clic en la pestaña Pull requests.
  3. Puedes filtrar o ordenar las solicitudes de extracción con los menús desplegables de Asignado a, Tipo o Ordenar.

Para ver todas las solicitudes de extracción, sigue estos pasos:

  1. En la interfaz web de Secure Source Manager, haz clic en la pestaña Pull requests.

  2. Puedes filtrar o ordenar las solicitudes de extracción con los menús desplegables de Asignatario, Tipo o Ordenar.

Crea una solicitud de extracción

  1. En la interfaz web de Secure Source Manager, selecciona el repositorio para el que deseas crear una solicitud de extracción.
  2. En la página del repositorio, haz clic en la pestaña Solicitudes de extracción.
  3. Haz clic en New pull request.
  4. En el menú merge into, selecciona la rama en la que deseas combinar la solicitud de extracción.
  5. En el menú pull from, selecciona la rama desde la que se extraerá.
  6. Haz clic en New pull request.
  7. Asigna un título y una descripción a la solicitud de extracción, y adjunta los archivos pertinentes.

  8. Haz clic en Create pull request.

    Se te redireccionará a la página de la solicitud de extracción, donde podrás agregar revisores, etiquetas, hitos y personas asignadas.

Cómo editar los detalles de una solicitud de extracción

Puedes agregar revisores, etiquetas, hitos, personas asignadas y una fecha de vencimiento a una solicitud de extracción.

Para agregar Revisores, Etiquetas, Hitos y Responsables, sigue estos pasos:

En la página de la solicitud de extracción, haz clic en el gear_icon ícono de ajustes junto al detalle que deseas editar.

Los cambios se guardan automáticamente.

Para actualizar la fecha límite, haz lo siguiente:

  1. Haz clic en el ícono de calendario en la sección Fecha límite y selecciona una fecha.
  2. Haz clic en el ícono de signo más ícono de signo más para guardar la fecha límite.

Revisa una solicitud de extracción

Los revisores pueden agregar comentarios, solicitar cambios y aprobar una solicitud de extracción.

Para revisar una solicitud de extracción que se te asignó, sigue estos pasos:

  1. En la interfaz web de Secure Source Manager, haz clic en la pestaña Pull requests.
  2. Haz clic en Asignadas a ti.

  3. Haz clic en la solicitud de extracción que quieras revisar.

    Se abrirá la página Conversación. Puedes ver los comentarios que dejó el autor de la solicitud de extracción o los demás revisores.

  4. Para ver los archivos modificados y agregar comentarios, haz clic en la pestaña Archivos modificados. Puedes cambiar el comportamiento de la visibilidad de los espacios en blanco, las opciones de vista y las opciones de diferencia haciendo clic en los menús desplegables Espacios en blanco, Vista dividida/Vista unificada y Opciones de diferencia.

  5. Para dejar un comentario, haz clic en el ícono de signo más junto a la línea sobre la que quieres comentar.

  6. Haz clic en Comenzar revisión.

  7. Para dejar comentarios adicionales, haz clic en el ícono de signo más en la línea en la que quieres dejar un comentario y, luego, haz clic en Agregar comentario.

    Los comentarios admiten el diseño con Markdown.

  8. Para enviar tus comentarios, aprobar la solicitud de extracción o solicitar cambios, haz clic en Revisar.

  9. Deja un comentario para resumir los cambios o deja el espacio de comentarios en blanco y selecciona una de las siguientes opciones:

    • Aprobar: Aprueba los cambios.
    • Comentar: Envía tus comentarios sin aprobar la solicitud de extracción.

    • Solicitar cambios: Solicita cambios en la solicitud de extracción.

Cómo combinar solicitudes de extracción

  1. En la página del repositorio, haz clic en la pestaña Solicitudes de extracción.
  2. Selecciona la solicitud de extracción que deseas combinar.
  3. Si no hay conflictos, haz clic en Combinar solicitud de extracción.

Ver problemas

  1. En la interfaz web de Secure Source Manager, selecciona tu repositorio.
  2. En la página de tu repositorio, haz clic en la pestaña Issues.
  3. Puedes filtrar u ordenar los problemas con los menús de Asignatario, Tipo o Ordenar.

Cómo crear un problema

  1. En la interfaz web de Secure Source Manager, selecciona tu repositorio.
  2. En la página del repositorio, haz clic en la pestaña Problemas.
  3. Haz clic en New Issue.
  4. Ingresa el título y la descripción del problema y, luego, haz clic en Crear problema.

  5. En la página Detalles del problema, puedes asignar etiquetas, hitos, responsables y especificar una rama o una etiqueta.

Cómo agregar diagramas con Mermaid

Secure Source Manager admite la renderización de diagramas de Mermaid en archivos Markdown (como README.md), descripciones de solicitud de extracción, problemas y comentarios.

Para agregar un diagrama, usa un bloque 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]
```

Haz clic en la pestaña Vista previa en el editor de Markdown para verificar que el diagrama se renderice antes de guardarlo.

Tipos de diagramas admitidos

Secure Source Manager admite los siguientes tipos de diagramas de Mermaid:

  • Diagramas de flujo: graph o flowchart (admite TD, TB, LR, BT, RL)
  • Diagramas de secuencia: sequenceDiagram
  • Diagramas de clases: classDiagram
  • Diagramas de entidad-relación: erDiagram
  • Diagramas de estado: stateDiagram o stateDiagram-v2
  • Gráficos XY: xychart-beta o xychart

Comportamiento y limitaciones de la renderización

  • Renderización estática: Los diagramas se renderizan como imágenes estáticas. Por motivos de seguridad, se inhabilitaron las funciones interactivas (como las devoluciones de llamada click y las sugerencias) y las secuencias de comandos externas.
  • Adaptación de temas: Los diagramas se adaptan automáticamente a los temas claros y oscuros.
  • Accesibilidad: Los diagramas renderizados incluyen texto alternativo completado con el código fuente del diagrama para los lectores de pantalla.
  • Tipos de diagramas no admitidos: Los tipos de diagramas no admitidos muestran un mensaje de error y no se renderizan. Estos incluyen diagramas de Gantt, de mapa mental, de pastel, de Gitgraph, de recorrido del usuario, de requisitos, de C4, de cronograma, de Sankey y de bloques. En el caso de los tipos de diagramas no admitidos, renderiza el diagrama de forma local en una imagen (PNG o SVG) y, luego, incorpóralo con la sintaxis de imagen de Markdown estándar.

¿Qué sigue?