Trabajar con incidencias y solicitudes de extracción

En esta página se describe cómo trabajar con incidencias 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, copie la siguiente URL en la barra de direcciones de su navegador.

INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.dev

Haz los cambios siguientes:

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

Roles obligatorios

Para obtener los permisos que necesitas para trabajar con incidencias y solicitudes de extracción, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

• Accessor de instancia de Secure Source Manager (roles/securesourcemanager.instanceAccessor) en la instancia de Secure Source Manager
• Escritor de repositorios de Secure Source Manager (roles/securesourcemanager.repoWriter) en el repositorio

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Para obtener información sobre cómo conceder roles de Secure Source Manager, consulta los artículos Control de acceso con gestión de identidades y accesos y Conceder acceso a instancias a los usuarios.

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 Solicitudes de extracción. Una vez que hayas enviado el contenido a un repositorio, podrás ver la pestaña de solicitudes de extracción.

Para ver las solicitudes de extracción o los problemas que se te han asignado, ve a la pestaña Problemas o Solicitudes de extracción de Secure Source Manager y haz clic en Asignados a mí.

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 de tu repositorio, haz clic en la pestaña Pull requests (Solicitudes de extracción).
3. Puedes filtrar u ordenar las solicitudes de extracción mediante los menús desplegables Asignado a, Tipo u Ordenar.

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

1. En la interfaz web de Gestor de fuentes seguras, haga clic en la pestaña Solicitudes de extracción.

   Nota: Debes tener el rol Lector de repositorio (roles/securesourcemanager.repoReader) en un repositorio para ver las solicitudes de extracción de ese repositorio.

2. Puedes filtrar o ordenar las solicitudes de extracción mediante los menús desplegables Asignado a, Tipo u Ordenar.

Crear una solicitud de extracción

1. En la interfaz web de Secure Source Manager, selecciona el repositorio para el que quieras crear una solicitud de extracción.
2. En la página del repositorio, haz clic en la pestaña Pull requests (Solicitudes de extracción).
3. Haz clic en Nueva solicitud de extracción.
4. En el menú Combinar con, selecciona la rama en la que quieras combinar la solicitud de extracción.
5. En el menú Extraer de, selecciona la rama de la que quieras extraer contenido.
6. Haz clic en Nueva solicitud de extracción.
7. Asigna un título y una descripción a la solicitud de extracción, y adjunta los archivos pertinentes.

8. Haz clic en Crear solicitud de extracción.

   Se te dirigirá a la página de solicitud de extracción, donde podrás añadir revisores, etiquetas, hitos y asignados.

Editar los detalles de una solicitud de extracción

Puedes añadir Revisores, Etiquetas, Hitos, Asignados y una Fecha de vencimiento a una solicitud de extracción.

Nota: En esta versión no se envían notificaciones por correo electrónico a los revisores ni a los usuarios asignados.

Para añadir Revisores, Etiquetas, Hitos y Responsables, sigue estos pasos:

En la página de solicitud de extracción, haz clic en el icono de rueda dentada situado junto al detalle que quieras editar.

Los cambios se guardan automáticamente.

Para actualizar la fecha de vencimiento, sigue estos pasos:

1. Haz clic en el icono de calendario de la sección Fecha de vencimiento y selecciona una fecha.
2. Haz clic en el icono del signo más para guardar la fecha de vencimiento.

Revisar una solicitud de extracción

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

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

1. En la interfaz web de Secure Source Manager, haga clic en la pestaña Pull requests (Solicitudes de extracción).
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 haya dejado el autor de la solicitud de extracción u otros revisores.

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

5. Para dejar un comentario, haz clic en el icono más junto a la línea que quieras comentar.

6. Haz clic en Empezar revisión.

7. Para añadir más comentarios, haz clic en el icono del signo más de la línea que quieras comentar y, a continuación, en Añadir comentario.

   Los comentarios admiten estilos con Markdown.

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

9. Escribe un comentario para resumir los cambios o deja el espacio 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.

     Nota: Si comentas tu propia solicitud de extracción, no puedes aprobarla ni solicitar cambios en ella.

Combinar solicitudes de extracción

1. En la página del repositorio, haz clic en la pestaña Pull requests (Solicitudes de extracción).
2. Selecciona la solicitud de extracción que quieras 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 del repositorio, haz clic en la pestaña Problemas.
3. Puedes filtrar u ordenar los problemas mediante los menús Asignado a, Tipo u Ordenar.

Crear un problema

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

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

   Nota: En esta versión no hay notificaciones por correo electrónico.

Siguientes pasos

• Usa la gestión de código fuente de Git con Secure Source Manager.