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 CloudPara obtener información sobre cómo identificar proyectos, consulta Identifica proyectos.
• LOCATION con la región de la instancia.

Roles requeridos

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:

• Secure Source Manager Instance Accessor (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 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 Cómo otorgar acceso a la instancia a los usuarios.

Cómo ver las 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, haz lo siguiente:

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 Asignatario, 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.

   Nota: Debes tener el rol de lector de repositorios (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 con los menús desplegables de Asignado a, 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 Pull requests.
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 deseas 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, en la que podrás agregar revisores, etiquetas, hitos y cesionarios.

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.

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

Para agregar revisores, etiquetas, hitos y personas asignadas, sigue estos pasos:

En la página de la solicitud de extracción, haz clic en el í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 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 sobre ellos, 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 de comparación haciendo clic en los menús desplegables Espacios en blanco, Vista dividida/Vista unificada y Opciones de comparación.

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 uso de Markdown para aplicarles estilo.

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.

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

Cómo combinar solicitudes de extracción

1. En la página del repositorio, haz clic en la pestaña Pull requests.
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 o ordenar los problemas con los menús Asignatario, Tipo o Ordenar.

Crea 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.

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

¿Qué sigue?

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