Crea una confirmación en AWS CodeCommit - AWS CodeCommit

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

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.

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 y. Edición del contenido de un archivo en un repositorio de AWS CodeCommit

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.

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.

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.

  2. En el terminal o en la línea de comandos, ejecute el comando put-fileespecificando 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 IAM usuario o una derivación del inicio de sesión de la consola como nombre de autor.

    Por ejemplo, para añadir un archivo llamado README.md con, por ejemplo, el contenido de un archivo codificado en base 6 a un repositorio llamado MyDemoRepo a una rama llamada 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

    importante

    Si no ha completado la instalación, no puede conectarse al repositorio ni realizar la confirmación utilizando Git.

  2. 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 ese 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
  3. 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.
  4. 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 <file>..." to include in what will be committed) bird.txt
  5. Ejecute git add bird.txt para incluir el nuevo archivo en la confirmación pendiente.

  6. 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 <file>..." to unstage) new file: bird.txt
  7. 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.

  8. 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
  9. Antes de enviar la confirmación finalizada desde el repositorio local al CodeCommit repositorio, puedes ver qué es lo que estás insertando: git diff --stat remote-name/branch-name remote-name es el apodo que el repositorio local usa para el repositorio y CodeCommit branch-name es el nombre de la rama que se va a comparar.

    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 clonaste el repositorio, desde la perspectiva del repositorio local, remote-name no es el nombre del CodeCommit repositorio. Al clonar un repositorio, remote-name se establece automáticamente enorigin.

    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 ha conectado el repositorio local al CodeCommit repositorio. (Para obtener instrucciones, consulte Conectarse a un repositorio).

  10. Cuando estés listo para enviar la confirmación del repositorio local al CodeCommit repositorio, ejecutagit push remote-name branch-name, ¿dónde remote-name es el apodo que el repositorio local usa para el CodeCommit repositorio y branch-name es el nombre de la rama que se va a enviar al CodeCommit repositorio.

    Por ejemplo, el resultado de ejecutar git push origin main sería similar al siguiente:

    ParaHTTPS:

    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

    ParaSSH:

    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.

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

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.

Para crear una confirmación
  1. En su equipo local, realice los cambios que desee incluir en el CodeCommit repositorio.

  2. 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 IAM usuario 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 denominado MyDemoRepo en el main sucursal. El contenido del archivo está en Base64 y dice “¡Bienvenido al repositorio de nuestro equipo!”:

    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.

    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, cambia el nombre de un archivo desde picture.png a image1.png y lo mueve desde un directorio llamado pictures a un directorio llamado, images, y elimina un archivo llamado ExampleSolution.py en un repositorio denominado MyDemoRepo en una rama llamada MyFeatureBranch cuya confirmación más reciente tiene un ID 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" } ] }