Crea una confirmación en AWS CodeCommit

Para crear la primera confirmación para un repositorio mediante el AWS CLI

1. En tu ordenador local, crea el archivo que quieres 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 incluyes un README.md archivo, su contenido se muestra automáticamente en la parte inferior de la página de códigos de tu 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 proporcionas un nombre de usuario, la CodeCommit configuración predeterminada es usar tu 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 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"
   }

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 el nombredevelopment:

   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 desde el repositorio local al CodeCommit repositorio:

   ...    
   nothing to commit, working directory clean

9. Antes de enviar la confirmación finalizada del repositorio local al CodeCommit repositorio, puedes ver lo que estás enviando ejecutandogit diff --stat remote-name/branch-name: dónde remote-name está el apodo que el repositorio local usa para el CodeCommit repositorio y el nombre de la branch-name rama que quieres 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, 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 asume 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 desde el repositorio local al CodeCommit repositorio, ejecutagit push remote-name branch-name, donde 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 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).

Creación de una confirmación

1. En su equipo local, realice los cambios que desee confirmar en repositorio de CodeCommit.

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, la CodeCommit configuración predeterminada es usar su nombre de usuario de IAM o un derivado 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 sucursal. main 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 haga cambios en los archivos con el nombre file1.py yfile2.txt, cambie el nombre de un archivo de picture.png a image1.png y lo mueva de un directorio con ese nombre pictures a otro directorio llamadoimages, y elimine un archivo con el nombre ExampleSolution.py de un repositorio llamado MyDemoRepo en una rama llamada 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"
           }
       ]
   }