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

AWS CodeCommit ya no está disponible para los nuevos clientes. Los clientes existentes de AWS CodeCommit pueden seguir utilizando el servicio con normalidad. Más información"

Revisión de una solicitud de extracción

Puede utilizar la consola AWS CodeCommit 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.

Puede utilizar la AWS CLI para hacer un comentario sobre una solicitud de extracción y responder a los comentarios. Para revisar los cambios, debe utilizar la consola de CodeCommit, el comando git diff o una herramienta de diferencias.

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

Puede utilizar la consola de CodeCommit para revisar una solicitud de extracción en un repositorio de CodeCommit.

  1. Abra la consola de CodeCommit 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.

    Abrir las solicitudes de extracción que se muestran en la consola de CodeCommit.
    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:

    • 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 el revisor de Amazon CodeGuru, p incluso proporcionar comentarios sobre la calidad de la recomendación, seleccione 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

    El revisor de Amazon CodeGuru es un servicio automatizado de revisión de código que utiliza el análisis de programas y el machine learning para detectar problemas comunes y recomendar correcciones en el código Java o Python.

    • Solo aparecerán los comentarios del revisor de Amazon CodeGuru si ha asociado el repositorio con el revisor de Amazon CodeGuru, el análisis está completo y 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 del revisor de Amazon CodeGuru.

    • Los comentarios del revisor de Amazon CodeGuru 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 puede responder con cualquiera de las reacciones con emojis disponibles a las recomendaciones del revisor de Amazon CodeGuru, solo se utilizan las reacciones con emojis con el pulgar hacia arriba y el pulgar hacia abajo para evaluar la utilidad de la recomendación.

    Recomendación creada por el revisor de Amazon CodeGuru 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 utilizar los comandos de AWS CLI en CodeCommit, instale la AWS CLI. Para obtener más información, consulte Referencia de la línea de comandos.

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

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

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

  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?” en el cambio realizado en el archivo ahs_count.py en una solicitud de extracción con el ID 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 repositorio de CodeCommit (con la opción --repository-name).

    • 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). Puede obtener el ID de revisión actual de una solicitud de extracción mediante el comando get-pull-request.

    • 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": [] } }