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. # Trabajar con confirmaciones en repositorios AWS CodeCommit Las confirmaciones son instantáneas del contenido y de los cambios en el contenido de su repositorio. Cada vez que un usuario confirma y envía un cambio, dicha información se guarda y se almacena. Esta información incluye datos sobre la persona que confirmó el cambio, la fecha y la hora de la confirmación y los cambios realizados como parte de la confirmación. También se pueden añadir etiquetas a las confirmaciones para identificar fácilmente confirmaciones específicas. En CodeCommit, puedes: + Revisar confirmaciones + Ver el historial de confirmaciones en un gráfico + Comparar una confirmación con su elemento principal o con otro especificador + Añadir comentarios a sus confirmaciones y responder a los comentarios de otras personas ![\[Añadir un comentario en una línea modificada de una confirmación.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-addlinecomment.png) Para poder enviar las confirmaciones a un CodeCommit repositorio, debes configurar tu ordenador local para que se conecte al repositorio. Para un método más sencillo, consulte [Para usuarios HTTPS mediante credenciales de Git](setting-up-gc.md). Para obtener información sobre cómo trabajar con otros aspectos del repositorio en CodeCommit[Trabajar con repositorios](repositories.md), consulte [Trabajar con archivos](files.md)[Trabajo con solicitudes de extracción](pull-requests.md),[Uso de las ramificaciones](branches.md), y[Trabajo con las preferencias del usuario](user-preferences.md). **Topics** + [Crea una confirmación en AWS CodeCommit](how-to-create-commit.md) + [Consulta los detalles de la confirmación en AWS CodeCommit](how-to-view-commit-details.md) + [Compara las confirmaciones en AWS CodeCommit](how-to-compare-commits.md) + [Comenta una confirmación en AWS CodeCommit](how-to-commit-comment.md) + [Crea una etiqueta Git en AWS CodeCommit](how-to-create-tag.md) + [Ver detalles de la etiqueta Git en AWS CodeCommit](how-to-view-tag-details.md) + [Eliminar una etiqueta de Git en AWS CodeCommit](how-to-delete-tag.md) # Crea una confirmación en AWS CodeCommit Al crear la primera confirmación para un repositorio nuevo, se utiliza el **put-file** comando AWS CLI and. Esto crea la primera confirmación y le permite crear y especificar la ramificación predeterminada para su nuevo repositorio. Puedes usar Git o el AWS CLI para crear una confirmación en un CodeCommit repositorio. Si el repositorio local está conectado a un CodeCommit repositorio, usas Git para enviar la confirmación del repositorio local al CodeCommit repositorio. Para crear una confirmación directamente en la CodeCommit consola, consulta [Crear o añadir un archivo a un repositorio de AWS CodeCommit](how-to-create-file.md) y. [Editar el contenido de un archivo en un AWS CodeCommit repositorio](how-to-edit-file.md) **nota** Como práctica recomendada, te recomendamos que utilices las últimas versiones compatibles de AWS CLI Git y otros programas. Si usas el AWS CLI, asegúrate de tener instalada una versión reciente para asegurarte de que estás usando una versión que contenga el `create-commit` comando. **Topics** + [Cree la primera confirmación para un repositorio mediante el AWS CLI](#how-to-create-first-commit) + [Creación de una confirmación mediante un cliente de Git](#how-to-create-commit-git) + [Crea una confirmación mediante el AWS CLI](#how-to-create-commit-cli) ## Cree la primera confirmación para un repositorio mediante el AWS CLI Puedes usar el `put-file` comando AWS CLI and the para crear tu primera confirmación para un repositorio. Al usar **put-file**, se crea una primera confirmación que añade un archivo a su repositorio vacío y se crea una ramificación con el nombre que especifique. Designa la nueva ramificación como la ramificación predeterminada de su repositorio. **nota** 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](cmd-ref.md). ## Para crear la primera confirmación de un repositorio mediante el AWS CLI 1. En su ordenador local, cree el archivo que desee añadir como primer archivo al CodeCommit repositorio. Una práctica habitual es crear un archivo de anotaciones de `README.md` que explique el propósito de este repositorio a los demás usuarios del repositorio. Si incluye un `README.md` archivo, el contenido del archivo se muestra automáticamente en la parte inferior de la página de **códigos** de su repositorio en la CodeCommit consola. 1. En el terminal o en la línea de comandos, ejecute el comando **put-file**especificando lo siguiente: + El nombre del repositorio en el que desea añadir el primer archivo. + El nombre de la ramificación que quiere crear como ramificación predeterminada. + La ubicación local del archivo. La sintaxis usada para esta ubicación varía dependiendo de su sistema operativo local. + El nombre del archivo que desea añadir, incluida la ruta en la que se almacena el archivo actualizado en el repositorio. + El nombre de usuario y el correo electrónico que desea asociar a este archivo. + Un mensaje de confirmación en el que se explica por qué añadió este archivo. El nombre de usuario, la dirección de correo electrónico y el mensaje de confirmación son opcionales, pero ayudan a otros usuarios a saber quién realizó el cambio y por qué. Si no proporciona un nombre de usuario, se utilizará de CodeCommit forma predeterminada su nombre de usuario de IAM o una derivación del inicio de sesión de la consola como nombre de autor. Por ejemplo, para añadir un archivo *README.md* con el nombre de un ejemplo de contenido de archivo codificado en base 6 a un repositorio con el nombre de una *MyDemoRepo* rama denominada: *development* ``` aws codecommit put-file --repository-name MyDemoRepo --branch-name development --file-path README.md --file-content "EXAMPLE0123456789example0123456789EXAMPLE1" --name "Mary Major" --email "mary_major@example.com" --commit-message "I added a quick readme for our new team repository." ``` Si se ejecuta correctamente, este comando proporciona información similar a la siguiente: ``` { "commitId": "724caa36EXAMPLE", "blobId": "a8a94062EXAMPLE", "treeId": "08b2fc73EXAMPLE" } ``` ## Creación de una confirmación mediante un cliente de Git Puedes crear confirmaciones mediante un cliente Git instalado en tu ordenador local y, a continuación, enviar esas confirmaciones a tu CodeCommit repositorio. 1. Cumpla los requisitos previos, incluida la [Configuración ](setting-up.md) **importante** Si no ha completado la instalación, no puede conectarse al repositorio ni realizar la confirmación utilizando Git. 1. Asegúrese de que está creando una confirmación en la ramificación correcta. Para ver una lista de las ramificaciones disponibles y saber cuál de ellas está configurada actualmente para utilizarse, ejecute **git branch**. Se muestran todas las ramificaciones. Un asterisco (`*`) aparece junto al nombre de la ramificación actual. Para cambiar a otra ramificación, ejecute **git checkout *branch-name***. Si esta es su primera confirmación, ejecute el comando **git config ** para configurar su cliente Git y crear una ramificación inicial con el nombre que quiera usar para esa ramificación. Por ejemplo, si quieres que tu rama predeterminada tenga el nombre*development*: ``` git config --local init.defaultBranch development ``` **sugerencia** Este comando solamente está disponible en la versión Git v.2.28 o versiones posteriores. También puede ejecutar este comando para establecer como nombre de ramificación predeterminado todos los repositorios de **development** recién creados: ``` git config --global init.defaultBranch development ``` 1. Realice un cambio en la ramificación (como, por ejemplo, añadir, modificar o eliminar un archivo). Por ejemplo, en el repositorio local, cree un archivo denominado `bird.txt` con el siguiente texto: ``` bird.txt -------- Birds (class Aves or clade Avialae) are feathered, winged, two-legged, warm-blooded, egg-laying vertebrates. ``` 1. Ejecute **git status**, que debería indicar que `bird.txt` aún no se ha incluido en ninguna confirmación pendiente: ``` ... Untracked files: (use "git add ..." to include in what will be committed) bird.txt ``` 1. Ejecute **git add bird.txt** para incluir el nuevo archivo en la confirmación pendiente. 1. Si vuelve a ejecutar **git status**, debería ver un resultado similar a este. Indica que `bird.txt` ahora forma parte de la confirmación pendiente o está preparado para confirmarse: ``` ... Changes to be committed: (use "git reset HEAD ..." to unstage) new file: bird.txt ``` 1. Para finalizar la confirmación, ejecute **git commit** con la opción `-m` (por ejemplo, ** git commit -m "*Adding bird.txt to the repository.*"**). La opción `-m` crea el mensaje de confirmación. 1. Si vuelve a ejecutar **git status**, debería ver un resultado similar a este. Indica que la confirmación está lista para enviarse del repositorio local al CodeCommit repositorio: ``` ... nothing to commit, working directory clean ``` 1. Antes de enviar la confirmación finalizada desde el repositorio local al CodeCommit repositorio, puedes ver qué es lo que estás insertando. Este *remote-name* es el apodo que el repositorio local usa para el CodeCommit repositorio y el nombre de la rama que *branch-name* se va a comparar. **git diff --stat *remote-name*/*branch-name*** **sugerencia** Para obtener el alias, ejecute **git remote**. Para obtener una lista de los nombres de las ramificaciones, ejecute **git branch**. Un asterisco (`*`) aparece junto al nombre de la ramificación actual. También puede ejecutar **git status** para obtener el nombre de la ramificación actual. **nota** Si has clonado el repositorio, desde la perspectiva del repositorio local, no *remote-name* es el nombre del repositorio. CodeCommit Al clonar un repositorio, *remote-name* se establece automáticamente en. `origin` Por ejemplo, el resultado de **git diff --stat origin/main** sería similar al siguiente: ``` bird.txt | 1 + 1 file changed, 1 insertion(+) ``` El resultado supone que ya has conectado el repositorio local al CodeCommit repositorio. (Para obtener instrucciones, consulte [Conectarse a un repositorio](how-to-connect.md)). 1. Cuando estés listo para enviar la confirmación del repositorio local al CodeCommit repositorio, ejecuta**git push *remote-name* *branch-name***, que *remote-name* es el apodo que el repositorio local usa para el CodeCommit repositorio y el nombre de la rama que *branch-name* se va a enviar al repositorio. CodeCommit Por ejemplo, el resultado de ejecutar **git push origin main** sería similar al siguiente: Para HTTPS: ``` Counting objects: 7, done. Delta compression using up to 4 threads. Compressing objects: 100% (4/4), done. Writing objects: 100% (5/5), 516 bytes | 0 bytes/s, done. Total 5 (delta 2), reused 0 (delta 0) remote: To https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo b9e7aa6..3dbf4dd main -> main ``` Para SSH: ``` Counting objects: 7, done. Delta compression using up to 4 threads. Compressing objects: 100% (4/4), done. Writing objects: 100% (5/5), 516 bytes | 0 bytes/s, done. Total 5 (delta 2), reused 0 (delta 0) remote: To ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo b9e7aa6..3dbf4dd main -> main ``` **sugerencia** Si añade la opción `-u` a **git push**(por ejemplo, **git push -u origin main**), en el futuro solamente tendrá que ejecutar **git push**, ya que la información de seguimiento ascendente queda configurada. Para obtener información de seguimiento ascendente, ejecute **git remote show *remote-name*** (por ejemplo, **git remote show origin**). Para ver más opciones, consulte la documentación de Git. ## Crea una confirmación mediante el AWS CLI Puedes usar el `create-commit` comando AWS CLI and para crear una confirmación para un repositorio en la punta de una rama específica. También puede crear una confirmación de combinación sin referencia para representar los resultados de la combinación de dos especificadores de confirmación. Para obtener más información, consulte [Crear una confirmación sin referencia](how-to-resolve-conflict-pull-request.md#create-unreferenced-merge-commit). **nota** 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](cmd-ref.md). **Creación de una confirmación** 1. En su equipo local, realice los cambios que desee confirmar en repositorio de CodeCommit. 1. En el terminal o en la línea de comandos, ejecute el comando **create-commit** especificando lo siguiente: + El repositorio en el que desea confirmar los cambios. + La ramificación en la que desea confirmar los cambios. + El ID de confirmación completo de la confirmación más reciente realizada a esa ramificación, también conocido como confirmación TIP o HEAD o el ID de confirmación principal. + Si se mantienen las carpetas vacías si los cambios que ha realizado eliminan el contenido de estas carpetas. De forma predeterminada, este valor es false. + La información acerca de los archivos que desea añadir, cambiar o eliminar. + El nombre de usuario y el correo electrónico que desea asociar a estos cambios. + Un mensaje de confirmación que explica porqué ha realizado estos cambios. El nombre de usuario, la dirección de correo electrónico y el mensaje de confirmación son opcionales, pero ayudan a otros usuarios a saber quién realizó los cambios y por qué. Si no proporciona un nombre de usuario, se utilizará de CodeCommit forma predeterminada su nombre de usuario de IAM o una derivación del inicio de sesión de la consola como nombre de autor. Por ejemplo, para crear una confirmación para un repositorio que añada un `README.md` archivo a un repositorio con el nombre *MyDemoRepo* de la rama. *main* El contenido del archivo está en Base64 y dice “¡Bienvenido al repositorio de nuestro equipo\$1”: ``` aws codecommit create-commit --repository-name MyDemoRepo --branch-name main --parent-commit-id 4c925148EXAMPLE --put-files "filePath=README.md,fileContent=V2VsY29tZSB0byBvdXIgdGVhbSByZXBvc2l0b3J5IQo=" ``` **sugerencia** Para obtener el ID de confirmación principal, ejecute el comando [get-branch](how-to-view-branch-details.md#how-to-view-branch-details-cli-details). Si se ejecuta correctamente, este comando proporciona información similar a la siguiente: ``` { "commitId": "4df8b524-EXAMPLE", "treeId": "55b57003-EXAMPLE", "filesAdded": [ { "blobId": "5e1c309dEXAMPLE", "absolutePath": "meeting.md", "fileMode": "NORMAL" } ], "filesDeleted": [], "filesUpdated": [] } ``` Para crear una confirmación que realice cambios en los archivos denominados *file1.py* y*file2.txt*, cambie el nombre de *picture.png* un archivo *image1.png* y lo mueva de un directorio denominado *pictures* a un directorio denominado*images*, y elimine un archivo nombrado *ExampleSolution.py* en un repositorio denominado *MyDemoRepo* en una rama denominada *MyFeatureBranch* cuya confirmación más reciente tenga un identificador de: *4c925148EXAMPLE* ``` aws codecommit create-commit --repository-name MyDemoRepo --branch-name MyFeatureBranch --parent-commit-id 4c925148EXAMPLE --author-name "Saanvi Sarkar" --email "saanvi_sarkar@example.com" --commit-message "I'm creating this commit to update a variable name in a number of files." --keep-empty-folders false --put-files '{"filePath": "file1.py", "fileMode": "EXECUTABLE", "fileContent": "bucket_name = sys.argv[1] region = sys.argv[2]"}' '{"filePath": "file2.txt", "fileMode": "NORMAL", "fileContent": "//Adding a comment to explain the variable changes in file1.py"}' '{"filePath": "images/image1.png", "fileMode": "NORMAL", "sourceFile": {"filePath": "pictures/picture.png", "isMove": true}}' --delete-files filePath="ExampleSolution.py" ``` **nota** La sintaxis para el segmento **--put-files** varía en función de su sistema operativo. En el ejemplo anterior está optimizado para usuarios de Linux, macOS, o Unix y usuarios de Windows con un emulador de Bash. Los usuarios de Windows en la línea de comandos o en PowerShell deberían utilizar una sintaxis adecuada para estos sistemas. Si se ejecuta correctamente, este comando proporciona información similar a la siguiente: ``` { "commitId": "317f8570EXAMPLE", "treeId": "347a3408EXAMPLE", "filesAdded": [ { "absolutePath": "images/image1.png", "blobId": "d68ba6ccEXAMPLE", "fileMode": "NORMAL" } ], "filesUpdated": [ { "absolutePath": "file1.py", "blobId": "0a4d55a8EXAMPLE", "fileMode": "EXECUTABLE" }, { "absolutePath": "file2.txt", "blobId": "915766bbEXAMPLE", "fileMode": "NORMAL" } ], "filesDeleted": [ { "absolutePath": "ExampleSolution.py", "blobId": "4f9cebe6aEXAMPLE", "fileMode": "EXECUTABLE" }, { "absolutePath": "pictures/picture.png", "blobId": "fb12a539EXAMPLE", "fileMode": "NORMAL" } ] } ``` # Consulta los detalles de la confirmación en AWS CodeCommit Puedes usar la AWS CodeCommit consola para explorar el historial de confirmaciones de un repositorio. Esto puede ayudarle a identificar los cambios realizados en un repositorio, entre los que se incluyen: + El autor y el momento en que se han realizado los cambios + El momento en que se han combinado confirmaciones específicas en una ramificación. Ver el historial de confirmaciones de una ramificación también puede ayudar a comprender la diferencia entre las ramificaciones. Si utiliza etiquetas, también podrá ver rápidamente la confirmación etiquetada con una etiqueta y los elementos principales de dicha confirmación etiquetada. En la línea de comandos, puedes usar Git para ver detalles sobre las confirmaciones en un repositorio o CodeCommit repositorio local. ## Examinación de confirmaciones de un repositorio Puedes usar la AWS CodeCommit consola para explorar el historial de confirmaciones en un repositorio. También puede ver un gráfico de las confirmaciones del repositorio y sus ramificaciones a lo largo del tiempo. Esto puede ayudarle a comprender el historial del repositorio, incluido el momento en que se efectúan cambios. **nota** Si utiliza el comando **git rebase** para cambiar la base de un repositorio, modificará el historial de un repositorio, lo que puede provocar que las confirmaciones aparezcan desordenadas. Para obtener más información, consulte [Git Branching-Rebasing](https://git-scm.com/book/en/v2/Git-Branching-Rebasing) o la documentación de Git. **Topics** + [Examinación del historial de confirmaciones de un repositorio](#how-to-view-commit-details-console-history) + [Visualización de un gráfico del historial de confirmaciones de un repositorio](#how-to-view-commit-details-console-visualizer) ### Examinación del historial de confirmaciones de un repositorio Puede examinar el historial de confirmaciones de una ramificación específica o etiqueta del repositorio, incluida información sobre la herramienta de confirmación y sobre el mensaje de confirmación. También puede ver el código de una confirmación. **Para examinar el historial de confirmaciones** 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En **Repositories (Repositorios)**, elija el repositorio para el que desea revisar el historial de confirmaciones. 1. En el panel de navegación, elija **Commits**. En la vista del historial de confirmaciones se muestra un historial de confirmaciones del repositorio de la ramificación predeterminada en orden cronológico inverso a la fecha de la confirmación. La fecha y la hora se muestran según la hora universal coordinada (UTC). Puede ver el historial de confirmaciones de una ramificación diferente eligiendo el botón de selección de vista y, a continuación, una ramificación de la lista. Si utiliza etiquetas en el repositorio, puede ver una confirmación con una etiqueta específica y sus elementos principales marcando dicha etiqueta en el botón de selección de vista. ![\[Vista de confirmaciones en la consola\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commit-list.png) 1. Para ver la diferencia entre una confirmación y su principal, y para ver los comentarios sobre los cambios, elija el ID de la confirmación abreviado. Para obtener más información, consulte [Comparación de una confirmación con su elemento principal](how-to-compare-commits.md#how-to-compare-commits-parent) y [Comentar una confirmación](how-to-commit-comment.md). Para ver la diferencia entre una confirmación y cualquier otro especificador de confirmación, incluida una ramificación, etiqueta o ID de confirmación, consulte [Comparación de dos especificadores de confirmación](how-to-compare-commits.md#how-to-compare-commits-compare). 1. Realice una o más de las siguientes acciones: + Para ver la fecha y la hora de un cambio, pase el cursor sobre la fecha de confirmación. + Para ver el ID completo de la confirmación, copie y péguelo en un editor de texto o en otra ubicación. Para copiarlo, elija **Copy ID (Copiar ID)**. + Para ver el código como aparecía en el momento de una confirmación, elija **Browse (Examinar)**. En la vista **Code**, se muestra el contenido del repositorio en el momento de dicha confirmación. El botón de selección de vista muestra el ID de confirmación abreviado en lugar de una ramificación o etiqueta. ### Visualización de un gráfico del historial de confirmaciones de un repositorio Puede ver un gráfico de las confirmaciones realizadas en un repositorio. La vista **Commit Visualizer** es una representación de gráfico acíclico dirigido (DAG) de todas las confirmaciones realizadas en una ramificación del repositorio. Esta representación gráfica puede ayudarle a entender cuándo se añadieron o combinaron las confirmaciones y sus características asociadas. También puede ayudarle a identificar cuándo se realizó un cambio en relación con otros cambios. **nota** Las confirmaciones que se combinan mediante el método fast-forward (de avance rápido) no aparecen como líneas separadas en el gráfico de confirmaciones. **Para ver un gráfico de las confirmaciones** 1. [Abre la CodeCommit consola en codecommit/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codecommit/home) 1. En **Repositories (Repositorios)**, elija el repositorio para el que desea ver un gráfico de confirmación. 1. En el panel de navegación, seleccione **Commits (Confirmaciones)** y, a continuación, seleccione la pestaña **Commit visualizer (Confirmar visualizador)**. ![\[Vista gráfica de un repositorio de la consola\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-cv-complex1.png) En el gráfico de confirmaciones, el ID de confirmación abreviado y el asunto de cada mensaje de confirmación aparece junto a dicho punto en el gráfico. **nota** El gráfico puede mostrar hasta 35 ramificaciones en una página. Si hay más de 35 ramificaciones, el gráfico será demasiado complejo para mostrarlo. Puede simplificar la vista de dos formas: Usando el botón selector de vista para mostrar el gráfico de una ramificación específica Pegando un ID completo de la confirmación en el cuadro de búsqueda para representar el gráfico de dicha confirmación 1. Para representar un nuevo gráfico de una confirmación, elija el punto en el gráfico que corresponde a dicha confirmación. El botón de selección de vista cambia al ID de confirmación abreviado. ![\[Representación de un nuevo gráfico de una confirmación específica\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-cv-commit.png) ## Ver detalles de una confirmación (AWS CLI) Git le permite ver la información detallada de las confirmaciones. También puedes usarlo AWS CLI para ver los detalles de las confirmaciones en un repositorio local o en un CodeCommit repositorio ejecutando los siguientes comandos: + Para ver la información sobre una confirmación, ejecute **[aws codecommit get-commit](#how-to-view-commit-details-cli-commit)**. + Para ver información acerca de varias confirmaciones, ejecute **[aws codecommit batch-get-commits](#how-to-view-commit-details-cli-batch-get-commits)**. + Para ver información sobre una confirmación de combinación, ejecute **[aws codecommit get-merge-commit](#how-to-view-commit-details-cli-merge-commit)**. + Para ver información sobre los cambios de un especificador de confirmaciones (rama, etiqueta, HEAD u otras referencias totalmente cualificadas, como la confirmación IDs), ejecuta. **[aws codecommit get-differences](#how-to-view-commit-details-cli-differences)** + Ejecute **[aws codecommit get-blob](#how-to-view-commit-details-cli-blob)** para ver el contenido con codificación base64 de un objeto blob de Git en un repositorio. ### Para ver información sobre una confirmación 1. Ejecute el comando **aws codecommit get-commit**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + El ID completo de la confirmación Por ejemplo, para ver información sobre una confirmación con el ID `317f8570EXAMPLE` en un CodeCommit repositorio llamado`MyDemoRepo`: ``` aws codecommit get-commit --repository-name MyDemoRepo --commit-id 317f8570EXAMPLE ``` 1. Si se ejecuta correctamente, el resultado de este comando incluye lo siguiente: + Información sobre el autor de la confirmación (según la configuración en Git), incluida la fecha en formato de marca de hora y la diferencia respecto al tiempo universal coordinado (UTC) + Información sobre el confirmador (según la configuración en Git), incluida la fecha en formato de marca de hora y la diferencia respecto a la UTC + El ID del árbol Git donde está la confirmación + El ID de la confirmación principal + El mensaje de la confirmación A continuación se muestra un ejemplo de resultado basado en el comando del ejemplo anterior: ``` { "commit": { "additionalData": "", "committer": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1484167798 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "treeId": "347a3408EXAMPLE", "parents": [ "4c925148EXAMPLE" ], "message": "Fix incorrect variable name" } } ``` ### Para ver información sobre una confirmación de combinación 1. Ejecute el comando **get-merge-commit**, especificando: + Un especificador de confirmación para el origen de la combinación (con la opción **--source-commit-specifier**). + Un especificador de confirmación para el destino para la combinación (con la opción **--destination-commit-specifier**). + La opción de combinación que desea utilizar (con la opción **--merge-option**). + El nombre del repositorio (con la opción **--repository-name**). Por ejemplo, para ver información sobre una confirmación de fusión para la rama de origen nombrada *bugfix-bug1234* con una rama de destino denominada *main* mediante la *THREE\$1WAY\$1MERGE* estrategia en un repositorio denominado*MyDemoRepo*: ``` aws codecommit get-merge-commit --source-commit-specifier bugfix-bug1234 --destination-commit-specifier main --merge-option THREE_WAY_MERGE --repository-name MyDemoRepo ``` 1. Si se ejecuta correctamente, el resultado de este comando proporciona información similar a la siguiente: ``` { "sourceCommitId": "c5709475EXAMPLE", "destinationCommitId": "317f8570EXAMPLE", "baseCommitId": "fb12a539EXAMPLE", "mergeCommitId": "ffc4d608eEXAMPLE" } ``` ### Visualización de información acerca de varias confirmaciones 1. Ejecute el comando **batch-get-commits**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + Una lista de las confirmaciones completas IDs de todas las confirmaciones sobre las que quieras ver información. Por ejemplo, para ver información sobre las confirmaciones con IDs `317f8570EXAMPLE` y `4c925148EXAMPLE` en un CodeCommit repositorio llamado`MyDemoRepo`: ``` aws codecommit batch-get-commits --repository-name MyDemoRepo --commit-ids 317f8570EXAMPLE 4c925148EXAMPLE ``` 1. Si se ejecuta correctamente, el resultado de este comando incluye lo siguiente: + Información sobre los autores de las confirmaciones (según la configuración en Git), incluida la fecha en formato de marca de hora y la diferencia respecto al tiempo universal coordinado (UTC) + Información sobre los confirmadores (según la configuración en Git), incluida la fecha en formato de marca de hora y la diferencia respecto a la UTC + El IDs del árbol de Git donde existe la confirmación. + La confirmación IDs de la confirmación principal. + Los mensajes de la confirmación A continuación se muestra un ejemplo de resultado basado en el comando del ejemplo anterior: ``` { "commits": [ { "additionalData": "", "committer": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "author": { "date": "1508280564 -0800", "name": "Mary Major", "email": "mary_major@example.com" }, "commitId": "317f8570EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "6e147360EXAMPLE" ], "message": "Change variable name and add new response element" }, { "additionalData": "", "committer": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "author": { "date": "1508280542 -0800", "name": "Li Juan", "email": "li_juan@example.com" }, "commitId": "4c925148EXAMPLE", "treeId": "1f330709EXAMPLE", "parents": [ "317f8570EXAMPLE" ], "message": "Added new class" } } ``` ### Para ver información acerca de los cambios de un especificador de confirmación 1. Ejecute el comando **aws codecommit get-differences**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + Los especificadores de confirmación sobre los que desea obtener información. Solo se requiere `--after-commit-specifier`. Si no especifica `--before-commit-specifier`, se muestran todos los archivos actuales de `--after-commit-specifier` Por ejemplo, para ver información sobre las diferencias entre las confirmaciones IDs `317f8570EXAMPLE` y `4c925148EXAMPLE` en un CodeCommit repositorio llamado`MyDemoRepo`: ``` aws codecommit get-differences --repository-name MyDemoRepo --before-commit-specifier 317f8570EXAMPLE --after-commit-specifier 4c925148EXAMPLE ``` 1. Si se ejecuta correctamente, el resultado de este comando incluye lo siguiente: + Una lista de diferencias, incluido el tipo de cambio (A = añadido, D = eliminado y M = modificado) + El mecanismo del archivo de tipo de cambio + El ID del objeto blob Git que contiene el cambio A continuación se muestra un ejemplo de resultado basado en el comando del ejemplo anterior: ``` { "differences": [ { "afterBlob": { "path": "blob.txt", "blobId": "2eb4af3bEXAMPLE", "mode": "100644" }, "changeType": "M", "beforeBlob": { "path": "blob.txt", "blobId": "bf7fcf28fEXAMPLE", "mode": "100644" } } ] } ``` ### Visualización de información sobre un objeto blob de Git 1. Ejecute el comando **aws codecommit get-blob**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + El ID del blob Git (con la opción `--blob-id `) Por ejemplo, para ver información sobre un blob de Git con el ID de `2eb4af3bEXAMPLE` en un CodeCommit repositorio llamado`MyDemoRepo`: ``` aws codecommit get-blob --repository-name MyDemoRepo --blob-id 2eb4af3bEXAMPLE ``` 1. Si se ejecuta correctamente, el resultado de este comando incluye lo siguiente: + El contenido con codificación base64 del blob, normalmente un archivo Por ejemplo, el resultado del comando anterior puede ser similar al siguiente: ``` { "content": "QSBCaW5hcnkgTGFyToEXAMPLE=" } ``` ## Visualización de la información detallada de una confirmación (Git) Antes de seguir estos pasos, deberías haber conectado el repositorio local al CodeCommit repositorio y haber confirmado los cambios. Para obtener instrucciones, consulte [Conectarse a un repositorio](how-to-connect.md). Para mostrar los cambios de la confirmación más reciente de un repositorio, ejecute el comando **git show**. ``` git show ``` El resultado del comando debería ser similar al siguiente: ``` commit 4f8c6f9d Author: Mary Major Date: Mon May 23 15:56:48 2016 -0700 Added bumblebee.txt diff --git a/bumblebee.txt b/bumblebee.txt new file mode 100644 index 0000000..443b974 --- /dev/null +++ b/bumblebee.txt @@ -0,0 +1 @@ +A bumblebee, also written bumble bee, is a member of the bee genus Bombus, in the family Apidae. \ No newline at end of file ``` **nota** En este ejemplo y en los siguientes, se ha IDs abreviado commit. No se muestra la IDs confirmación completa. Para ver los cambios que se han producido, utilice el comando **git show** con el ID de confirmación: ``` git show 94ba1e60 commit 94ba1e60 Author: John Doe Date: Mon May 23 15:39:14 2016 -0700 Added horse.txt diff --git a/horse.txt b/horse.txt new file mode 100644 index 0000000..080f68f --- /dev/null +++ b/horse.txt @@ -0,0 +1 @@ +The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus. ``` Para ver las diferencias entre dos confirmaciones, ejecuta el **git diff** comando e incluye las dos confirmaciones IDs. ``` git diff ce22850d 4f8c6f9d ``` En este ejemplo, la diferencia entre las dos confirmaciones es que se han añadido dos archivos. El resultado del comando debería ser similar al siguiente: ``` diff --git a/bees.txt b/bees.txt new file mode 100644 index 0000000..cf57550 --- /dev/null +++ b/bees.txt @@ -0,0 +1 @@ +Bees are flying insects closely related to wasps and ants, and are known for their role in pollination and for producing honey and beeswax. diff --git a/bumblebee.txt b/bumblebee.txt new file mode 100644 index 0000000..443b974 --- /dev/null +++ b/bumblebee.txt @@ -0,0 +1 @@ +A bumblebee, also written bumble bee, is a member of the bee genus Bombus, in the family Apidae. \ No newline at end of file ``` Para utilizar Git para ver información detallada acerca de las confirmaciones en un repositorio local, ejecute el comando **git log**: ``` git log ``` Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` commit 94ba1e60 Author: John Doe Date: Mon May 23 15:39:14 2016 -0700 Added horse.txt commit 4c925148 Author: Jane Doe Date: Mon May 22 14:54:55 2014 -0700 Added cat.txt and dog.txt ``` Para mostrar solo las IDs confirmaciones y los mensajes, ejecuta el **git log --pretty=oneline** comando: ``` git log --pretty=oneline ``` Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` 94ba1e60 Added horse.txt 4c925148 Added cat.txt and dog.txt ``` Para ver más opciones, consulte la documentación de Git. # Compara las confirmaciones en AWS CodeCommit Puedes usar la CodeCommit consola para ver las diferencias entre los especificadores de confirmación de un CodeCommit repositorio. Puede ver rápidamente la diferencia entre una confirmación y su elemento primario. También puedes comparar dos referencias, incluida la confirmación IDs. **Topics** + [Comparación de una confirmación con su elemento principal](#how-to-compare-commits-parent) + [Comparación de dos especificadores de confirmación](#how-to-compare-commits-compare) ## Comparación de una confirmación con su elemento principal Puede ver rápidamente la diferencia entre una confirmación y su elemento primario para revisar el mensaje de confirmación, quién confirma y qué es lo que ha cambiado. 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En la página **Repositories (Repositorios)**, elija el repositorio en el que desea ver la diferencia entre una confirmación y su elemento principal. 1. En el panel de navegación, elija **Commits**. 1. Elija el ID de confirmación abreviado de cualquier confirmación de la lista. La vista cambia para mostrar la información de esa confirmación, incluidas las diferencias entre ella y su elemento primario. ![\[Selección del ID de confirmación abreviado para mostrar las diferencias entre esta confirmación y su principal\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commit-changes1.png) Puede mostrar los cambios de forma paralela (vista **Split**) o en línea (vista **Unified**). También puede mostrar u ocultar los cambios en los espacios en blanco. También puede añadir comentarios. Para obtener más información, consulte [Comentar una confirmación](how-to-commit-comment.md). **nota** Las preferencias para ver el código y otra configuración de la consola se guardan como cookies del navegador siempre que se modifican. Para obtener más información, consulte [Trabajo con las preferencias del usuario](user-preferences.md). ![\[Cambios mostrados en la vista Unificada, con los cambios de espacios en blanco ocultos\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commit-changes2c.png) ![\[Cambios mostrados en la vista Vista dividida, con un comentario sobre una línea\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png) **nota** En función del estilo de fin de línea, del editor de código y de otros factores, es posible que vea líneas completas añadidas o eliminadas en lugar de cambios concretos en una línea. El nivel de detalle coincide con lo que devuelven los comandos **git show** o **git diff**. 1. Para comparar una confirmación con su elemento principal desde **Commit visualizer (Visualizador de confirmación)**, seleccione el ID de confirmación abreviado. Se muestran los detalles de la confirmación, incluidos los cambios entre esta y su elemento principal. ## Comparación de dos especificadores de confirmación Puedes ver las diferencias entre cualquiera de los dos especificadores de confirmación de la consola. CodeCommit Los especificadores de confirmación son referencias, como las ramas, las etiquetas y las confirmaciones. IDs 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En la página **Repositories (Repositorios)**, seleccione el repositorio cuyas confirmaciones, ramificaciones o confirmaciones etiquetadas desea comparar. 1. En el panel de navegación, seleccione **Commits (Confirmaciones)** y haga clic en **Compare commits (Comparar confirmaciones)**. ![\[Comparación de dos especificadores de confirmación\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-compare-1.png) 1. Utilice los cuadros para comparar dos especificadores de confirmación. + Para comparar el extremo de una ramificación, seleccione el nombre de la ramificación en la lista. Esto selecciona, para la comparación, la confirmación más reciente de esa ramificación. + Para comparar una confirmación con una etiqueta específica asociada a ella, seleccione el nombre de la etiqueta en la lista, si hay alguna. Esto selecciona la confirmación etiquetada que se va a comparar. + Para comparar una confirmación específica, introduzca o pegue el ID de la confirmación en el cuadro. Para obtener el ID completo de la confirmación, elija **Commits** en la barra de navegación y, a continuación, copie el ID de confirmación que aparece en la lista. En la página **Compare commits (Comparar confirmaciones)**, pegue el ID de confirmación completo en el cuadro de texto y seleccione **Use commit ID (Usar ID de confirmación)**. ![\[Compara ramas, etiquetas o confirma IDs\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-compare-2.png) 1. Una vez seleccionados los especificadores, elija **Compare**. ![\[Vista de comparación de entre dos ramificaciones\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-compare-branches.png) Puede mostrar las diferencias de forma paralela (vista **Split**) o en línea (vista **Unified**). También puede mostrar u ocultar los cambios en los espacios en blanco. 1. Para borrar las opciones de comparación, elija **Cancel (Cancelar)**. # Comenta una confirmación en AWS CodeCommit Puedes usar la CodeCommit consola para comentar las confirmaciones en un repositorio y ver y responder a los comentarios de otros usuarios sobre las confirmaciones. Esto puede ayudarle a explicar los cambios realizados en un repositorio, entre los que se incluyen: + Por qué se han efectuado cambios. + Si se necesitan más cambios. + Si se deben combinar los cambios en otra ramificación. Puede realizar un comentario sobre una confirmación en su conjunto, un archivo en de una confirmación o una línea o un cambio específico en un archivo. También puede vincular una línea de código seleccionándola y copiando la URL resultante en el navegador. **nota** Para obtener un resultado óptimo, cree los comentarios cuando haya iniciado sesión como usuario de IAM. La funcionalidad de comentarios no está optimizada para los usuarios que inician sesión con credenciales de cuenta raíz, acceso federado o credenciales temporales. **Topics** + [Ver los comentarios de una confirmación en un repositorio](#how-to-commit-comment-view-console) + [Añadir y responder a los comentarios de una confirmación en un repositorio](#how-to-commit-comment-add-console) + [Ver, añadir, actualizar y responder a los comentarios (AWS CLI)](#how-to-commit-comment-cli) ## Ver los comentarios de una confirmación en un repositorio Puedes usar la CodeCommit consola para ver los comentarios de una confirmación. **Visualización de los comentarios sobre una confirmación** 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En **Repositories (Repositorios)**, elija el repositorio cuyos comentarios sobre las confirmaciones desea revisar. 1. En el panel de navegación, elija **Commits**. Seleccione el ID de la confirmación cuyos comentarios desea ver. Se muestra la página para esa confirmación, junto con los comentarios que tenga. ## Añadir y responder a los comentarios de una confirmación en un repositorio Puedes usar la CodeCommit consola para añadir comentarios a la comparación de una confirmación y una principal, o a la comparación entre dos confirmaciones especificadas. También puede responder a los comentarios con emojis, con sus propios comentarios o con ambos. ### Añadir y responder a los comentarios de una confirmación (consola) Puede añadir comentarios a una confirmación y responder con texto y emojis. Los comentarios y emojis se marcan como pertenecientes al usuario de IAM o el rol que utilizó para iniciar sesión en la consola. **Par añadir y responder a los comentarios de una confirmación** 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En **Repositories (Repositorios)**, elija el repositorio donde desea realizar comentarios sobre las confirmaciones. 1. En el panel de navegación, elija **Commits**. Seleccione el ID de la confirmación en la que desee agregar o responder a un comentario. Se muestra la página para esa confirmación, junto con los comentarios que tenga. 1. Para añadir un comentario, lleve a cabo alguna de las siguientes operaciones: + Para añadir un comentario general, en **Comments on changes (Comentar cambios)**, introduzca el comentario y, a continuación, elija **Save (Guardar)**. Puede utilizar [Markdown (Marcado)](https://en.wikipedia.org/wiki/Markdown) o introducir un comentario en texto sin formato. ![\[Comentario general sobre los cambios de una confirmación.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-changecomment.png) + Para añadir un comentario a un archivo de la confirmación, busque el nombre del archivo. Seleccione **Comment on file (Comentario de archivo)**, introduzca un comentario y elija **Save (Guardar)**. ![\[Añadir un comentario en un archivo de una confirmación.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-addfilecomment.png) + Para añadir un comentario en una línea modificada de la confirmación, vaya a la línea en la que aparece el cambio. Seleccione el globo de comentario ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commentbubble.png), introduzca un comentario y después elija **Save (Guardar)**. ![\[Añadir un comentario en una línea de una confirmación.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-addlinecomment.png) **nota** Puede editar su comentario después de haberlo guardado. También puede eliminar su contenido. El comentario permanecerá con un mensaje que indica que se ha eliminado el contenido. Conviene que utilice el modo **Preview markdown (Vista previa de marcado)** para el comentario antes de guardarlo. 1. Para responder a los comentarios de una confirmación, seleccione **Reply (Responder)**. Para responder a un comentario con un emoji, seleccione el emoji que quiera de la lista. Solo puede elegir un emoji por comentario. Si quiere cambiar su reacción con los emojis, seleccione otro de la lista o seleccione **Ninguno** para eliminar su reacción. ![\[Añadir respuestas y reacciones con emojis a un comentario.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commenting-commenttab.png) ### Añadir y responder a los comentarios cuando se comparan dos especificadores de confirmación Puede añadir comentarios a una comparación entre ramificaciones, etiquetas o confirmaciones. **Para añadir o responder a los comentarios cuando se comparan dos especificadores de confirmación** 1. [Abre la CodeCommit consola en codecommit/home. https://console.aws.amazon.com/codesuite/](https://console.aws.amazon.com/codesuite/codecommit/home) 1. En la página **Repositories (Repositorios)**, elija el repositorio cuyas confirmaciones, ramificaciones o confirmaciones etiquetadas desea comparar. 1. En el panel de navegación, seleccione **Commits (Confirmaciones)** y haga clic en la pestaña **Compare commits (Comparar confirmaciones)**. ![\[Comparación de dos especificadores de confirmación\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-compare-1.png) 1. Utilice los campos **Destination (Destino)** y **Source (Origen)** para comparar dos especificadores de confirmación. Usa las listas desplegables o pega la confirmación. IDs Elija **Compare**. ![\[Ejemplo del resultado de comparar un ID de confirmación con una ramificación\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-compare-4.png) 1. Realice una o más de las siguientes acciones: + Para añadir comentarios en los archivos o líneas, elija el globo de comentario ![\[The comment bubble icon that that indicates that you can leave a comment on that line of code.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-commentbubble.png) + Para añadir comentarios generales sobre los cambios comparados, vaya a **Comments on changes**. ## Ver, añadir, actualizar y responder a los comentarios (AWS CLI) Puede ver, añadir, responder, actualizar y eliminar el contenido de un comentario ejecutando los siguientes comandos: + Ejecute **[get-comments-for-compared-commit](#how-to-commit-comment-cli-get-comments)** para ver los comentarios de una comparación de dos confirmaciones. + Ejecute [**get-comment**](#how-to-commit-comment-cli-get-comment-info) para ver los detalles de un comentario específico. + Ejecute [**delete-comment-content**](#how-to-commit-comment-cli-commit-delete) para eliminar el contenido de un comentario que ha creado. + Ejecute [**post-comment-for-compared-commit**](#how-to-commit-comment-cli-comment) para crear un comentario sobre la comparación de dos confirmaciones. + Ejecute [**update-comment**](#how-to-commit-comment-cli-commit-update) para actualizar un comentario. + Para responder a un comentario, ejecute [**post-comment-reply**](#how-to-commit-comment-cli-commit-reply). + Para responder a un comentario con un emoji, ejecute [**put-comment-reaction**](#how-to-commit-comment-cli-commit-reply-emoji). + Para ver las reacciones con emojis a un comentario, ejecute [**get-comment-reactions**](#how-to-commit-comment-cli-commit-emoji-view). ### Visualización de los comentarios sobre una confirmación 1. Ejecute el comando **get-comments-for-compared-commit**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + El ID completo de la confirmación después, para establecer la direccionalidad de la comparación (con la `--after-commit-id option`). + El ID completo de la confirmación antes, para establecer la direccionalidad de la comparación (con la opción `--before-commit-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, para ver los comentarios realizados en la comparación de dos confirmaciones en un repositorio denominado *MyDemoRepo*: ``` aws codecommit get-comments-for-compared-commit --repository-name MyDemoRepo --before-commit-id 6e147360EXAMPLE --after-commit-id 317f8570EXAMPLE ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` { "commentsForComparedCommitData": [ { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comments": [ { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, not the file, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "CommentId": "123abc-EXAMPLE", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } }, { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.240, "deleted": false, "commentId": "456def-EXAMPLE", "lastModifiedDate": 1508369612.240, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } ], "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "after" }, "repositoryName": "MyDemoRepo" } ], "nextToken": "exampleToken" } ``` ### Para ver los detalles de un comentario de una confirmación 1. Ejecute el comando **get-comment** especificando el ID de comentario generado por el sistema. Por ejemplo: ``` aws codecommit get-comment --comment-id ff30b348EXAMPLEb9aa670f ``` 1. Si se ejecuta correctamente, este comando proporciona información similar a la siguiente: ``` { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "content": "Whoops - I meant to add this comment to the line, but I don't see how to delete it.", "creationDate": 1508369768.142, "deleted": false, "commentId": "", "lastModifiedDate": 1508369842.278, "callerReactions": [], "reactionCounts": { "SMILE" : 6, "THUMBSUP" : 1 } } } ``` ### Para eliminar el contenido de un comentario en una confirmación 1. Ejecute el comando **delete-comment-content** especificando el ID de comentario generado por el sistema. Por ejemplo: ``` aws codecommit delete-comment-content --comment-id ff30b348EXAMPLEb9aa670f ``` **nota** Solo puede eliminar el contenido de un comentario si ha aplicado la AWSCode CommitFullAccess política o si tiene el `DeleteCommentContent` permiso establecido en **Permitir**. 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` { "comment": { "creationDate": 1508369768.142, "deleted": true, "lastModifiedDate": 1508369842.278, "clientRequestToken": "123Example", "commentId": "ff30b348EXAMPLEb9aa670f", "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "callerReactions": [], "reactionCounts": { "CLAP" : 1 } } } ``` ### Creación de un comentario sobre una confirmación 1. Ejecute el comando **post-comment-for-compared-commit**, especificando: + El nombre del CodeCommit repositorio (con la `--repository-name` opción). + El ID completo de la confirmación después, para establecer la direccionalidad de la comparación (con la opción `--after-commit-id `). + El ID completo de la confirmación antes, para establecer la direccionalidad de la comparación (con la opción `--before-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, para añadir el comentario *"Can you add a test case for this?"* sobre el cambio al *cl\$1sample.js* archivo en la comparación entre dos confirmaciones de un repositorio llamado*MyDemoRepo*: ``` aws codecommit post-comment-for-compared-commit --repository-name MyDemoRepo --before-commit-id 317f8570EXAMPLE --after-commit-id 5d036259EXAMPLE --client-request-token 123Example --content "Can you add a test case for this?" --location filePath=cl_sample.js,filePosition=1232,relativeFileVersion=AFTER ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` { "afterBlobId": "1f330709EXAMPLE", "afterCommitId": "317f8570EXAMPLE", "beforeBlobId": "80906a4cEXAMPLE", "beforeCommitId": "6e147360EXAMPLE", "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "553b509bEXAMPLE56198325", "content": "Can you add a test case for this?", "creationDate": 1508369612.203, "deleted": false, "commentId": "abc123-EXAMPLE", "lastModifiedDate": 1508369612.203, "callerReactions": [], "reactionCounts": [] }, "location": { "filePath": "cl_sample.js", "filePosition": 1232, "relativeFileVersion": "AFTER" }, "repositoryName": "MyDemoRepo" } ``` ### Actualización de un comentario sobre una confirmación 1. Ejecute el comando **update-comment**, especificando el ID de comentario generado por el sistema y el contenido para sustituir el contenido existente. Por ejemplo, para añadir el contenido *"Fixed as requested. I'll update the pull request."* a un comentario con un identificador de*442b498bEXAMPLE5756813*: ``` aws codecommit update-comment --comment-id 442b498bEXAMPLE5756813 --content "Fixed as requested. I'll update the pull request." ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` { "comment": { "authorArn": "arn:aws:iam::111111111111:user/Li_Juan", "clientRequestToken": "", "commentId": "442b498bEXAMPLE5756813", "content": "Fixed as requested. I'll update the pull request.", "creationDate": 1508369929.783, "deleted": false, "lastModifiedDate": 1508369929.287, "callerReactions": [], "reactionCounts": { "THUMBSUP" : 2 } } } ``` ### Para responder a un comentario sobre una confirmación 1. 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, para añadir la respuesta *"Good catch. I'll remove them."* al comentario con el identificador generado por el sistema de: *abcd1234EXAMPLEb5678efgh* ``` aws codecommit post-comment-reply --in-reply-to abcd1234EXAMPLEb5678efgh --content "Good catch. I'll remove them." --client-request-token 123Example ``` 1. 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, "CommentId": "abcd1234EXAMPLEb5678efgh", "lastModifiedDate": 150836912.221, "callerReactions": [], "reactionCounts": [] } } ``` ### Para responder a un comentario sobre una confirmación con un emoji 1. Para responder a un comentario de una solicitud de cambios con un emoji o para cambiar el valor de su reacción ante un emoji, ejecute el comando **put-comment-reaction**, especificando: + El ID generado por el sistema del comentario al que desea responder con un emoji. + El valor de la reacción que quiere añadir o actualizar. Los valores aceptables incluyen emojis, códigos cortos y valores Unicode compatibles. Los emojis admiten los siguientes valores: CodeCommit **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/how-to-commit-comment.html) Por ejemplo, para añadir el emoji *:thumbsup:* al comentario con el identificador generado por el sistema de: *abcd1234EXAMPLEb5678efgh* ``` aws codecommit put-comment-reaction --comment-id abcd1234EXAMPLEb5678efgh --reaction-value :thumbsup: ``` 1. Si se ejecuta correctamente, este comando no genera ninguna salida. ### Para ver las reacciones con emojis a un comentario 1. Para ver las reacciones de los emojis a un comentario, incluidos los usuarios que reaccionaron con esos emojis, ejecute el comando **get-comment-reactions** y especifique el identificador del comentario generado por el sistema. Por ejemplo, para ver las reacciones de los emojis al comentario con el identificador generado por el sistema de: *abcd1234EXAMPLEb5678efgh* ``` aws codecommit get-comment-reactions --comment-id abcd1234EXAMPLEb5678efgh ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` { "reactionsForComment": { [ { "reaction": { "emoji:"👍", "shortCode": "thumbsup", "unicode": "U+1F44D" }, "users": [ "arn:aws:iam::123456789012:user/Li_Juan", "arn:aws:iam::123456789012:user/Mary_Major", "arn:aws:iam::123456789012:user/Jorge_Souza" ] }, { "reaction": { "emoji": "👎", "shortCode": "thumbsdown", "unicode": "U+1F44E" }, "users": [ "arn:aws:iam::123456789012:user/Nikhil_Jayashankar" ] }, { "reaction": { "emoji": "😕", "shortCode": "confused", "unicode": "U+1F615" }, "users": [ "arn:aws:iam::123456789012:user/Saanvi_Sarkar" ] } ] } } ``` # Crea una etiqueta Git en AWS CodeCommit Puede utilizar una etiqueta de Git para marcar una confirmación para ayudar así a otros usuarios a comprender su importancia. Para crear una etiqueta Git en un CodeCommit repositorio, puedes usar Git desde un repositorio local conectado al CodeCommit repositorio. Una vez que hayas creado una etiqueta Git en el repositorio local, puedes usarla **git push --tags** para subirla al CodeCommit repositorio. Para obtener más información, consulte [Visualización de información detallada de las etiquetas](how-to-view-tag-details.md). ## Uso de Git para crear una etiqueta Sigue estos pasos para usar Git desde un repositorio local para crear una etiqueta Git en un CodeCommit repositorio. En estos pasos, asumimos que ya has conectado el repositorio local al CodeCommit repositorio. Para obtener instrucciones, consulte [Conectarse a un repositorio](how-to-connect.md). 1. Ejecuta el **git tag *new-tag-name* *commit-id*** comando, donde *new-tag-name* aparece el nombre de la nueva etiqueta de Git y el ID de la confirmación que *commit-id* se va a asociar a la etiqueta de Git. Por ejemplo, el comando siguiente crea una etiqueta de Git denominada `beta` y la asocia con el ID de confirmación `dc082f9a...af873b88`: ``` git tag beta dc082f9a...af873b88 ``` 1. Para enviar la nueva etiqueta Git del repositorio local al CodeCommit repositorio, ejecuta el **git push *remote-name* *new-tag-name*** comando, donde *remote-name* está el nombre del CodeCommit repositorio y *new-tag-name* es el nombre de la nueva etiqueta Git. Por ejemplo, para enviar una nueva etiqueta de Git llamada `beta` a un CodeCommit repositorio llamado`origin`: ``` git push origin beta ``` **nota** Para enviar todas las etiquetas Git nuevas de tu repositorio local al CodeCommit repositorio, ejecuta**git push --tags**. Para asegurarte de que tu repositorio local esté actualizado con todas las etiquetas de Git del CodeCommit repositorio, ejecuta **git fetch** seguido **git fetch --tags** de. Para ver más opciones, consulte la documentación de Git. # Ver detalles de la etiqueta Git en AWS CodeCommit En Git, una etiqueta es una marca que puede aplicarse a una referencia como una confirmación para marcarla con información que puede ser importante para otros usuarios del repositorio. Por ejemplo, puede etiquetar la confirmación que fue el punto de la versión beta para un proyecto con la etiqueta **beta**. Para obtener más información, consulte [Uso de Git para crear una etiqueta](how-to-create-tag.md#how-to-create-tag-git). Las etiquetas de Git son distintas de las etiquetas de repositorio. Para obtener más información acerca de cómo usar las etiquetas de repositorio, consulte [Añadir una etiqueta a un repositorio](how-to-tag-repository-add.md). Puedes usar la AWS CodeCommit consola para ver información sobre las etiquetas de Git de tu repositorio, incluida la fecha y el mensaje de confirmación de la confirmación a la que hace referencia cada etiqueta de Git. Desde la consola, puede comparar la confirmación a la que hace referencia la etiqueta con el inicio de la ramificación predeterminada del repositorio. Al igual que cualquier otra confirmación, también puede ver el código en el punto de dicha etiqueta de Git. También puede utilizar Git desde su terminal o línea de comandos para ver detalles sobre las etiquetas de Git en un repositorio local. **Topics** + [Ver detalles de las etiquetas (consola)](#how-to-view-tag-details-console) + [Ver detalles de las etiquetas de Git (Git)](#how-to-view-tag-details-git) ## Ver detalles de las etiquetas (consola) Usa la AWS CodeCommit consola para ver rápidamente una lista de etiquetas de Git para tu repositorio y detalles sobre las confirmaciones a las que hacen referencia las etiquetas de Git. 1. Abre la CodeCommit consola en [https://console.aws.amazon.com/codesuite/codecommit/home](https://console.aws.amazon.com/codesuite/codecommit/home). 1. En **Repositories (Repositorios)**, elija el nombre del repositorio cuyas etiquetas desea ver. 1. En el panel de navegación, elija **Git tags (Etiquetas de Git)**. ![\[Vista de las etiquetas de un repositorio.\]](http://docs.aws.amazon.com/es_es/codecommit/latest/userguide/images/codecommit-tags-view.png) 1. Realice una de las siguientes acciones: + Para ver el código como aparecía en la confirmación, elija el nombre de la etiqueta de Git. + Para ver los detalles de la confirmación, incluidos el mensaje de confirmación completo, el confirmador y el autor, elija el ID de confirmación abreviado. ## Ver detalles de las etiquetas de Git (Git) Para utilizar Git para ver la información detallada acerca de las etiquetas de Git en un repositorio local, ejecute uno de los siguientes comandos: + [git tag](#how-to-view-tag-details-git-tag) para ver una lista de los nombres de etiqueta de Git + [git show](#how-to-view-tag-details-git-show) para ver información sobre una etiqueta de Git específica + [git ls-remote](#how-to-view-tag-details-git-remote) para ver información sobre las etiquetas de Git en un CodeCommit repositorio. **nota** Para asegurarte de que tu repositorio local esté actualizado con todas las etiquetas de Git del CodeCommit repositorio, ejecuta **git fetch** seguido **git fetch --tags** de. En los siguientes pasos, asumimos que ya has conectado el repositorio local a un CodeCommit repositorio. Para obtener instrucciones, consulte [Conectarse a un repositorio](how-to-connect.md). ### Para ver una lista de las etiquetas de Git en un repositorio local 1. Ejecute el comando **git tag**: ``` git tag ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` beta release ``` **nota** Si no se han definido etiquetas, **git tag** no dará ningún resultado. Para ver más opciones, consulte la documentación de Git. ### Para ver información sobre una etiqueta de Git en un repositorio local 1. Ejecute el comando **git show *tag-name***. Por ejemplo, para ver información sobre una etiqueta de Git denominada `beta`, ejecute: ``` git show beta ``` 1. Si se ejecuta correctamente, el resultado del comando será similar al siguiente: ``` commit 317f8570...ad9e3c09 Author: John Doe Date: Tue Sep 23 13:49:51 2014 -0700 Added horse.txt diff --git a/horse.txt b/horse.txt new file mode 100644 index 0000000..df42ff1 --- /dev/null +++ b/horse.txt @@ -0,0 +1 @@ +The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus \ No newline at end of file ``` **nota** Para salir del resultado de la información de la etiqueta de Git, introduzca **:q**. Para ver más opciones, consulte la documentación de Git. ### Para ver información sobre las etiquetas de Git en un CodeCommit repositorio 1. Ejecute el comando **git ls-remote --tags**. ``` git ls-remote --tags ``` 1. Si se ejecuta correctamente, este comando genera como resultado una lista de las etiquetas Git del CodeCommit repositorio: ``` 129ce87a...70fbffba refs/tags/beta 785de9bd...59b402d8 refs/tags/release ``` Si no se han definido etiquetas de Git, **git ls-remote --tags**devolverá una línea en blanco. Para ver más opciones, consulte la documentación de Git. # Eliminar una etiqueta de Git en AWS CodeCommit Para eliminar una etiqueta de Git en un CodeCommit repositorio, usa Git de un repositorio local conectado al CodeCommit repositorio. ## Uso de Git para eliminar una etiqueta de Git Sigue estos pasos para usar Git desde un repositorio local para eliminar una etiqueta de Git en un CodeCommit repositorio. Estos pasos se escriben partiendo del supuesto de que ya has conectado el repositorio local al CodeCommit repositorio. Para obtener instrucciones, consulte [Conectarse a un repositorio](how-to-connect.md). 1. Para eliminar la etiqueta Git del repositorio local, ejecuta el **git tag -d *tag-name*** comando donde *tag-name* está el nombre de la etiqueta Git que deseas eliminar. **sugerencia** Para obtener una lista de nombres de etiqueta de Git, ejecute **git tag**. Por ejemplo, para eliminar una etiqueta de Git del repositorio local denominado `beta`: ``` git tag -d beta ``` 1. Para eliminar la etiqueta Git del CodeCommit repositorio, ejecuta el **git push *remote-name* --delete *tag-name*** comando donde *remote-name* es el apodo que el repositorio local usa para el CodeCommit repositorio y *tag-name* es el nombre de la etiqueta Git que deseas eliminar del CodeCommit repositorio. **sugerencia** Para obtener una lista de los nombres de los CodeCommit repositorios y sus nombres URLs, ejecuta el **git remote -v** comando. Por ejemplo, para eliminar una etiqueta de Git denominada `beta` en el CodeCommit repositorio`origin`: ``` git push origin --delete beta ```