Revisión de una solicitud de extracción - AWS CodeCommit

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Revisión de una solicitud de extracción

Puedes usar la AWS CodeCommit consola para revisar los cambios incluidos en una solicitud de extracción. Puede añadir comentarios a la solicitud, a los archivos y a líneas de código individuales. También puede responder a los comentarios de otros usuarios. Si el repositorio está configurado con notificaciones, recibirá un correo electrónico cuando los usuarios respondan a sus comentarios o cuando hagan comentarios sobre una solicitud de extracción.

Puedes utilizarla AWS CLI para comentar una solicitud de cambios y responder a los comentarios. Para revisar los cambios, debes usar la CodeCommit consola, el git diff comando o una herramienta de diferenciación.

Revisión de una solicitud de extracción (consola)

Puedes usar la CodeCommit consola para revisar una solicitud de incorporación de cambios en un CodeCommit repositorio.

  1. Abre la CodeCommit consola en https://console.aws.amazon.com/codesuite/codecommit/home.

  2. En Repositories (Repositorios), seleccione el nombre del repositorio.

  3. En el panel de navegación, seleccione Pull requests (Solicitudes de extracción).

  4. De forma predeterminada, se muestra una lista de todas las solicitudes de extracción abiertas. Elija la solicitud de extracción abierta que desea revisar.

    Abre las solicitudes de cambios que aparecen en la CodeCommit consola.
    nota

    Puede comentar una solicitud de extracción cerrada o combinada, pero no puede combinarla ni volver a abrirla.

  5. En la solicitud de extracción, elija Changes.

  6. Realice una de las siguientes acciones siguientes:

    • Para añadir un comentario general para la solicitud de extracción en su conjunto, en Comments on changes (Comentarios de los cambios), bajo New comment (Nuevo comentario), introduzca un comentario y, a continuación, seleccione Save (Guardar). Puede utilizar Markdown (Marcado) o introducir un comentario en texto sin formato.

      Comentario general sobre los cambios en una solicitud de extracción.
    • Para añadir un comentario a un archivo en la confirmación, en Changes, busque el nombre del archivo. Elija el icono de comentario The comment bubble icon that that indicates that you can leave a comment on that line of code. que aparece junto al nombre de archivo, introduzca un comentario y, a continuación, elija Save (Guardar).

      Añadir un comentario a un archivo en una solicitud de extracción.
    • Para añadir un comentario a una línea modificada en la solicitud de extracción, en Changes, vaya a la línea sobre la que desea realizar un comentario. Elija el icono de comentario The comment bubble icon that that indicates that you can leave a comment on that line of code. que aparece para esa línea, introduzca un comentario y, a continuación, elija Save (Guardar).

      Añadir un comentario a una línea en una solicitud de extracción.
  7. Para responder a los comentarios sobre una confirmación, en Changes o en Activity, elija Reply. Puede responder con texto y emojis.

    Añadir respuestas y reacciones con emojis a un comentario.

    Para ver los nombres de las personas que respondieron con una respuesta de reacción con emoji en particular, selecciónela. Para ver todas las reacciones con emojis e información sobre quién respondió y con qué emojis lo hizo, seleccione Ver todas las reacciones. Si respondió con un emoji a un comentario, su respuesta se mostrará en el icono del botón de reacción con emoji.

    nota

    Los recuentos de reacciones que se muestran en la consola son exactos en el momento en que se cargó la página. Para obtener la información más actualizada sobre el recuento de reacciones de los emojis, actualice la página o seleccione Ver todas las reacciones.

    Ver información sobre los usuarios que respondieron a un comentario con una reacción con emoji.
  8. (Opcional) Para responder a una recomendación creada por Amazon CodeGuru Reviewer, incluida la aportación de comentarios sobre la calidad de la recomendación, selecciona Responder. Utilice los botones de reacción para proporcionar información general acerca de si aprueba o no la recomendación. Utilice el campo de comentario para proporcionar más detalles sobre su reacción.

    nota

    Amazon CodeGuru Reviewer es un servicio de revisión de código automatizado que utiliza el análisis de programas y el aprendizaje automático para detectar problemas comunes y recomendar soluciones en el código de Java o Python.

    • Solo verás los comentarios de Amazon CodeGuru Reviewer si has asociado el repositorio a Amazon CodeGuru Reviewer, si el análisis está completo y si el código de la solicitud de extracción es código Java o Python. Para obtener más información, consulte Asociar o desasociar un AWS CodeCommit repositorio con Amazon CodeGuru Reviewer.

    • Los comentarios de Amazon CodeGuru Reviewer solo aparecen en la pestaña Cambios si se hicieron en la revisión más reciente de la solicitud de cambios. Siempre aparecen en la pestaña Actividad.

    • Si bien puedes responder con cualquiera de las reacciones de emoji disponibles a las recomendaciones de Amazon CodeGuru Reviewer, solo se utilizan las reacciones de emoji con el pulgar hacia arriba y el pulgar hacia abajo para evaluar la utilidad de la recomendación.

    Recomendación creada por Amazon CodeGuru Reviewer con un trabajo de revisión en curso.
  9. Para aprobar los cambios realizados en una solicitud de extracción, elija Approve (Aprobar).

    nota

    No puede aprobar una solicitud de extracción que ha creado.

    Puede ver aprobaciones, reglas de aprobación para una solicitud de extracción y reglas de aprobación creadas por plantillas de reglas de aprobación en Approvals (Aprobaciones). Si decide no aprobar la solicitud de extracción después de todo, puede elegir Revoke approval (Revocar aprobación).

    nota

    Solo puede aprobar o revocar la aprobación en una solicitud de extracción abierta. No se puede aprobar ni revocar la aprobación de una solicitud de extracción cuyo estado sea Merged (Combinada) o Closed (Cerrada).

    Aprobaciones y reglas de aprobación en una solicitud de extracción.

Revisar solicitudes de extracción (AWS CLI)

Para usar AWS CLI comandos con CodeCommit, instale el AWS CLI. Para obtener más información, consulte Referencia de la línea de comandos.

Puedes revisar las solicitudes de cambios con los siguientes AWS CLI comandos:

También puede usar emojis con comentarios en una solicitud de extracción con los siguientes comandos:

Para usar el AWS CLI para revisar las solicitudes de extracción en un CodeCommit repositorio

  1. Para añadir un comentario a una solicitud de extracción, ejecute el comando post-comment-for-pull-requestespecificando lo siguiente:

    • El ID de la solicitud de extracción (con la opción --pull-request-id).

    • El nombre del repositorio que contiene la solicitud de extracción (con la opción --repository-name).

    • El ID completo de la confirmación en la ramificación de destino en la que se combina la solicitud de extracción (con la opción --before-commit-id).

    • El ID completo de la confirmación de la ramificación de origen que es el extremo actual de la ramificación de la solicitud de extracción en el momento en que se publica el comentario (con la opción --after-commit-id).

    • Un token de idempotencia único generado por el cliente (con la opción --client-request-token).

    • El contenido del comentario (con la opción --content).

    • Una lista con información de la ubicación sobre dónde se puede introducir el comentario, que incluya:

      • El nombre del archivo que se está comparando, incluida la extensión y el subdirectorio, si los hubiese (con el atributo filePath).

      • El número de línea del cambio del archivo comparado (con el atributo filePosition).

      • Si el comentario sobre el cambio se ha realizado “antes” o ”después” en la comparación entre la ramificación de origen y la de destino (con el atributo relativeFileVersion).

    Por ejemplo, use este comando para añadir el comentario “No parece que se usen en ningún sitio. ¿Se podrían eliminar?” sobre el cambio al archivo ahs_count.py en una solicitud de incorporación de cambios con el identificador 47 en un repositorio denominado MyDemoRepo.

    aws codecommit post-comment-for-pull-request --pull-request-id "47" --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "These don't appear to be used anywhere. Can we remove them?" --location filePath=ahs_count.py,filePosition=367,relativeFileVersion=AFTER

    Si se ejecuta correctamente, el resultado del comando será similar al siguiente.

    { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "123Example", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": [] } "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "47" }
  2. Para ver los comentarios de una solicitud de extracción, ejecute el comando get-comments-for-pull-requestespecificando lo siguiente:

    • El nombre del CodeCommit repositorio (con la --repository-name opción).

    • El ID generado por el sistema de la solicitud de extracción (con la opción --pull-request-id).

    • (Opcional) Un token de enumeración para devolver el siguiente lote de resultados (con la opción --next-token).

    • (Opcional) Un número entero no negativo para limitar en el número de resultados devueltos (con la opción --max-results).

    Por ejemplo, utilice este comando para ver los comentarios de una solicitud de extracción con el ID 42.

    aws codecommit get-comments-for-pull-request --pull-request-id 42

    Si se ejecuta correctamente, el resultado del comando será similar al siguiente.

    { "commentsForPullRequestData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "5d036259EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "317f8570EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Saanvi_Sarkar", "clientRequestToken": "", "commentId": "abcd1234EXAMPLEb5678efgh", "content": "These don't appear to be used anywhere. Can we remove them?", "creationDate": 1508369622.123, "deleted": false, "lastModifiedDate": 1508369622.123, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 6, "CONFUSED" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.104, "deleted": false, "lastModifiedDate": 150836912.273, "callerReactions": ["THUMBSUP"] "reactionCounts": { "THUMBSUP" : 14 } } ], "location": { "filePath": "ahs_count.py", "filePosition": 367, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo", "pullRequestId": "42" } ], "nextToken": "exampleToken" }
  3. Para aprobar o revocar la aprobación de una solicitud de extracción, ejecute el comando update-pull-request-approval-state especificando lo siguiente:

    • El ID de la solicitud de extracción (con la opción --pull-request-id).

    • El ID de revisión de la solicitud de extracción (mediante --revision-id option)). Puedes obtener el identificador de revisión actual de una solicitud de incorporación de cambios mediante el get-pull-requestcomando.

    • El estado de aprobación que desea aplicar (mediante la opción --approval-state). Los estados de aprobación válidos incluyen APPROVE y REVOKE.

    Por ejemplo, utilice este comando para aprobar una solicitud de extracción con el ID 27 y el ID de revisión 9f29d167EXAMPLE.

    aws codecommit update-pull-request-approval-state --pull-request-id 27 --revision-id 9f29d167EXAMPLE --approval-state "APPROVE"

    Si se ejecuta correctamente, este comando no devuelve nada.

  4. Para publicar una respuesta a un comentario en una solicitud de extracción, ejecute el comando post-comment-reply especificando lo siguiente:

    • El ID generado por el sistema del comentario al que desea responder (con la opción --in-reply-to).

    • Un token de idempotencia único generado por el cliente (con la opción --client-request-token).

    • El contenido de la respuesta (con la opción --content).

    Por ejemplo, use este comando para añadir la respuesta “Bien visto. Voy a eliminarlos.” al comentario con el ID generado por el sistema abcd1234EXAMPLEb5678efgh.

    aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example

    Si se ejecuta correctamente, el resultado del comando será similar al siguiente.

    { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "442b498bEXAMPLE5756813", "content": "Good catch. I'll remove them.", "creationDate": 1508369829.136, "deleted": false, "lastModifiedDate": 150836912.221, "callerReactions": [], "reactionCounts": [] } }