Introducción a Git y AWS CodeCommit

Para crear el repositorio de CodeCommit

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

2. Use el selector de regiones para elegir la Región de AWS en la que desea crear el repositorio. Para obtener más información, consulte Regiones y puntos de conexión de Git.

3. En la página Repositorios, seleccione Crear repositorio.

4. En la página Create repository (Crear repositorio), en Repository name (Nombre del repositorio), escriba un nombre para el repositorio (por ejemplo, MyDemoRepo).

   nota

   En los nombres de los repositorios se distinguen mayúsculas de minúsculas y no pueden tener más de 100 caracteres. Para obtener más información, consulte Límites.

5. (Opcional) En Description (Descripción), introduzca una descripción (por ejemplo, My demonstration repository). Esto puede ayudarle a usted y a otros usuarios a conocer el propósito del repositorio.

6. (Opcional) Elija Add tag (Añadir etiqueta) para añadir una o más etiquetas de repositorio (una etiqueta de atributo personalizada que le ayuda a organizar y administrar sus recursos de AWS) a su repositorio. Para obtener más información, consulte Etiquetar repositorios en AWS CodeCommit.

7. (Opcional) Amplíe Configuración adicional para especificar si desea utilizar la Clave administrada de AWS predeterminada o la suya propia administrada por el cliente para cifrar y descifrar los datos de este repositorio. Si decide utilizar su propia clave gestionada por el cliente, debe asegurarse de que esté disponible en la Región de AWS lugar donde vaya a crear el repositorio y de que la clave esté activa. Para obtener más información, consulte AWS Key Management Service y cifrado de repositorios de AWS CodeCommit.

8. (Opcional) Seleccione Activar el revisor de Amazon CodeGuru para Java y Python si este repositorio va a contener código de Java o Python y desea que el revisor de CodeGuru analice ese código. El revisor de CodeGuru utiliza varios modelos de machine learning para encontrar defectos en el código y sugerir automáticamente mejoras y correcciones en las solicitudes de cambios. Para más información, consulte la guía de usuario del revisor de Amazon CodeGuru.

9. Seleccione Crear.

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

2. En el selector de regiones, seleccione la región en la que se creó el repositorio de Región de AWS. Cada Región de AWS tiene sus propios repositorios. Para obtener más información, consulte Regiones y puntos de conexión de Git.

3. Encuentre en la lista el repositorio con el que desea establecer la conexión y selecciónelo. Elija Clone URL (Clonar URL), y, a continuación, elija el protocolo que desea utilizar al clonar o conectarse al repositorio. Con esto se copia la URL clonada.

   • Copie la URL HTTPS si utiliza credenciales de Git con su usuario de IAM o el ayudante de credenciales incluido con AWS CLI.

   • Copie la dirección URL HTTPS (GRC) si utiliza el comando git-remote-codecommit en su equipo local.

   • Copie la URL SSH si utiliza un par de claves pública y privada SSH con su usuario de IAM.

   nota

   Si ve una página de Bienvenida en lugar de la lista de repositorios, es que no existen repositorios asociados a su cuenta de AWS en la Región de AWS en la que ha iniciado sesión. Para crear un repositorio, consulte Cree un repositorio AWS CodeCommit o siga los pasos del tutorial Introducción a Git y CodeCommit.

4. (Opcional) Le recomendamos que configure su cliente Git local para que main lo use como nombre de la ramificación predeterminada de su repositorio. Este es el nombre que se usa para la ramificación predeterminada en todos los ejemplos de esta guía. También es el mismo nombre de ramificación predeterminado que usa CodeCommit si realiza su primera confirmación en la consola. Ejecute el siguiente comando para configurar el nombre de ramificación predeterminado de forma global para su sistema:

   git config --global init.defaultBranch main

   Si prefiere usar un nombre de ramificación predeterminado diferente para todos sus repositorios, sustituya main por el nombre que prefiera. En este tutorial se asume que su ramificación predeterminada se denomina principal.

   Si quiere usar diferentes nombres de ramificación predeterminados para diferentes repositorios, puede configurar este atributo localmente (--local) en lugar de globalmente (--global).

5. En el terminal o símbolo del sistema, clone el repositorio con el comando git clone y proporcione la URL de clonación que copió en el paso 3. La URL de clonación depende del protocolo y la configuración que utilice. Por ejemplo, si utiliza HTTPS con credenciales de Git para clonar un repositorio llamado MyDemoRepo en la región este de EE. UU. (Ohio):

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Si utiliza HTTPS con git-remote-codecommit:

   git clone codecommit://MyDemoRepo my-demo-repo

   Si utiliza SSH:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   nota

   Si aparece un error al intentar clonar un repositorio, es posible que no haya completado la configuración necesaria para el equipo local. Para obtener más información, consulte Configuración para AWS CodeCommit.

1. Utilice un editor de texto para crear los siguientes dos archivos de texto de ejemplo en su directorio. Asigne un nombre a los archivos cat.txt y dog.txt:

   cat.txt
   -------
   The domestic cat (Felis catus or Felis silvestris catus) is a small, usually furry, domesticated, and carnivorous mammal.

   dog.txt
   -------
   The domestic dog (Canis lupus familiaris) is a canid that is known as man's best friend.

2. Ejecute git config para agregar su nombre de usuario y dirección de correo electrónico representados por los marcadores de posición su-nombre-de-usuario y su-dirección-de-correo-electrónico a su repositorio local. Esto hace que sea más fácil identificar las confirmaciones que realice:

   git config --local user.name "your-user-name"
   git config --local user.email your-email-address

3. Si no configuró su nombre de ramificación predeterminado de forma global cuando creó el repositorio local, ejecute el siguiente comando para establecer el nombre de ramificación predeterminado como main:

   git config --local init.defaultBranch main

4. Ejecute git add para preparar el cambio:

   git add cat.txt dog.txt

5. Ejecute git commit para confirmar el cambio:

   git commit -m "Added cat.txt and dog.txt"

   sugerencia

   Para ver la información detallada acerca de la confirmación que acaba de realizar, ejecute git log.

1. Cambie al directorio /tmp o al directorio c:\temp.

2. Ejecute git clone para extraer una copia del repositorio en el repositorio compartido:

   Para HTTPS:

   git clone https://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   Para HTTPS con git-remote-codecommit:

   git clone codecommit://MyDemoRepo shared-demo-repo

   Para SSH:

   git clone ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo shared-demo-repo

   nota

   Al clonar un repositorio mediante SSH en los sistemas operativos Windows, debe agregar el ID de la clave de SSH a la cadena de conexión de la siguiente manera:

   git clone ssh://Your-SSH-Key-ID@git-codecommit.us-east-2.amazonaws.com/v1/repos/MyDemoRepo my-demo-repo

   Para obtener más información, consulte Para conexiones SSH en Windows.

   En este comando, MyDemoRepo es el nombre de su repositorio de CodeCommit. shared-demo-repo es el nombre del directorio que crea Git en el directorio /tmp o en el directorio c:\temp. Después de crear el directorio, Git extrae una copia de su repositorio en el directorio shared-demo-repo.

3. Cambie al directorio shared-demo-repo:

   (For Linux, macOS, or Unix) cd /tmp/shared-demo-repo
   (For Windows) cd c:\temp\shared-demo-repo

4. Ejecute git config para agregar otro nombre de usuario y la dirección de correo electrónico representados por los marcadores de posición otro-nombre-de-usuario y otra-dirección-de-correo-electrónico. De ese modo, resulta más sencillo identificar las confirmaciones que ha realizado el otro usuario:

   git config --local user.name "other-user-name"
   git config --local user.email other-email-address

5. Utilice un editor de texto para crear el siguiente archivo de texto de ejemplo en el directorio shared-demo-repo. Asigne el nombre horse.txt al archivo:

   horse.txt
   -------
   The horse (Equus ferus caballus) is one of two extant subspecies of Equus ferus.

6. Ejecute git add para preparar el cambio en el repositorio compartido:

   git add horse.txt

7. Ejecute git commit para confirmar el cambio en el repositorio compartido:

   git commit -m "Added horse.txt"

8. Ejecute git push para enviar la confirmación inicial a través del nombre remoto predeterminado que utiliza CodeCommit para su repositorio (origin) desde la ramificación predeterminada a su repositorio local (main):

   git push -u origin main

9. Cambie a su repositorio local y ejecute git pull para extraer en su repositorio local la confirmación que realizó el repositorio compartido en el repositorio de CodeCommit. A continuación, ejecute git log para ver la confirmación que se inició desde el repositorio compartido.

1. Desde su repositorio local, ejecute git checkout y especifique el nombre de la ramificación (por ejemplo, MyNewBranch) y el ID de la primera confirmación realizada en el repositorio local.

   Si desconoce el ID de confirmación, ejecute git log para obtenerlo. Asegúrese de que la confirmación tiene su nombre de usuario y dirección de correo electrónico, y no el nombre de usuario y la dirección de correo electrónico del otro usuario. Esto es para simular que main es una versión estable del repositorio de CodeCommit y que la ramificación de MyNewBranch es para una característica nueva, relativamente inestable:

   git checkout -b MyNewBranch commit-ID

2. Ejecute git push para enviar la nueva ramificación del repositorio local al repositorio de CodeCommit:

   git push origin MyNewBranch

3. Ahora, extraiga la ramificación en el repositorio compartido y compruebe los resultados:

   1. Cambie al directorio de repositorio compartido (shared-demo-repo).

   2. Extraiga la nueva ramificación (git fetch origin).

   3. Confirme que la ramificación se ha extraído (git branch --all muestra una lista de todas las ramificaciones del repositorio).

   4. Cambie a la nueva ramificación (git checkout MyNewBranch).

   5. Confirme que ha cambiado a la ramificación MyNewBranch ejecutando git status o git branch. El resultado muestra en qué ramificación se encuentra. En este caso debería ser MyNewBranch.

   6. Vea la lista de confirmaciones en la ramificación (git log).

   Aquí tiene la lista de comandos Git que puede llamar:

   git fetch origin
   git branch --all
   git checkout MyNewBranch
   git branch or git status
   git log

4. Vuelva a la ramificación main y consulte la lista de confirmaciones. Los comandos Git deberían tener el siguiente aspecto:

   git checkout main
   git log

5. Cambie a la ramificación main de su repositorio local. Puede ejecutar git status o git branch. El resultado muestra en qué ramificación se encuentra. En este caso debería ser main. Los comandos Git deberían tener el siguiente aspecto:

   git checkout main
   git branch or git status

1. Desde su repositorio local, ejecute git tag y especifique el nombre de la nueva etiqueta (release) y el ID de la primera confirmación realizada en el repositorio local.

   Si desconoce el ID de confirmación, ejecute git log para obtenerlo. Asegúrese de que la confirmación tiene su nombre de usuario y dirección de correo electrónico, y no el nombre de usuario y la dirección de correo electrónico del otro usuario. Estos pasos se realizan para simular que su confirmación es una versión estable del repositorio de CodeCommit:

   git tag release commit-ID

   Ejecute git tag de nuevo para etiquetar la confirmación del otro usuario con la etiqueta beta. Estos pasos se realizan para simular que la confirmación es para una característica nueva relativamente inestable:

   git tag beta commit-ID

2. Ejecute git push --tags para enviar las etiquetas al repositorio de CodeCommit.

3. Ahora, extraiga las etiquetas en el repositorio compartido y compruebe los resultados:

   1. Cambie al directorio de repositorio compartido (shared-demo-repo).

   2. Extraiga las nuevas etiquetas (git fetch origin).

   3. Confirme que las etiquetas se han extraído (git tag muestra una lista de etiquetas para el repositorio).

   4. Consulte la información sobre cada etiqueta (git log release y git log beta).

   Aquí tiene la lista de comandos Git que puede llamar:

   git fetch origin
   git tag
   git log release
   git log beta

4. Pruébelo también en el repositorio local:

   git log release
   git log beta

1. Inicie sesión en la AWS Management Console y abra la consola de IAM en https://console.aws.amazon.com/iam/.

   Asegúrese de iniciar sesión con el mismo nombre de usuario y contraseña que utilizó en Configuración .

2. En el panel de navegación, seleccione Users y después Create New Users.

3. En el primer cuadro Enter User Names (Especificar nombres de usuario), introduzca un nombre de usuario de ejemplo (por ejemplo, JaneDoe-CodeCommit). Seleccione la casilla Generate an access key for each user (Generar una clave de acceso para cada usuario) y, a continuación, haga clic en Create (Crear).

4. Elija Show User Security Credentials. Anote el ID de clave de acceso y la clave de acceso secreta o elija Download Credentials.

5. Siga las instrucciones de Para usuarios HTTPS mediante credenciales de Git para generar y proporcionar las credenciales del usuario de IAM.

   Si desea utilizar SSH, siga las instrucciones en SSH y Linux, macOS o Unix: configure las claves públicas y privadas de Git y CodeCommit o Paso 3: Configurar las claves públicas y privadas para Git y CodeCommit para configurar el usuario con claves públicas y privadas.

6. Ejecute git pull. Debería aparecer el siguiente error:

   Para HTTPS:

   fatal: unable to access 'https://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   Para SSH:

   fatal: unable to access 'ssh://git-codecommit.us-east-2.amazonaws.com/v1/repos/repository-name/': The requested URL returned error: 403.

   El error aparece porque el nuevo usuario no tiene permiso para sincronizar el repositorio compartido con el repositorio de CodeCommit.

7. Vuelva a la consola de IAM. En el panel de navegación, seleccione Policies y, a continuación, seleccione Create Policy. Si aparece el botón Empezar, selecciónelo y, a continuación, seleccione Crear política.

8. Junto a Create Your Own Policy, seleccione Select.

9. En el cuadro Policy Name (Nombre de política), introduzca un nombre (por ejemplo, CodeCommitAccess-GettingStarted).

10. En el cuadro Documento de política, introduzca lo siguiente, que permite a un usuario de IAM extraer contenido de cualquier repositorio asociado con el usuario de IAM:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull"
          ],
          "Resource": "*"
        }
      ]
    }

    sugerencia

    Si, por el contrario, desea que el usuario de IAM pueda enviar confirmaciones a cualquier repositorio asociado con el usuario de IAM, introduzca lo siguiente:

    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": [
            "codecommit:GitPull",
            "codecommit:GitPush"
          ],
          "Resource": "*"
        }
      ]
    }

    Para obtener más información sobre otros permisos de acciones y recursos de CodeCommit que puede otorgar a los usuarios, consulte Autenticación y control de acceso de AWS CodeCommit.

11. En el panel de navegación, elija Usuarios.

12. Elija el nombre de usuario de ejemplo (por ejemplo, JaneDoe-CodeCommit) al que desea asociar la política.

13. Elija la pestaña Permisos.

14. En Managed Policies, elija Attach Policy.

15. Seleccione la política CodeCommitAccess-GettingStarted que acaba de crear y, a continuación, elija Attach Policy (Asociar política).

16. Ejecute git pull. Esta vez el comando debería funcionar y debería aparecer un mensaje Already up-to-date.

17. Si utiliza HTTPS, cambie a sus credenciales Git originales o, si usa git-remote-codecommit, a su perfil habitual. Para obtener más información, consulte las instrucciones en Configuración de usuarios HTTPS mediante credenciales de Git o Pasos de configuración para conexiones HTTPS a AWS CodeCommit con git-remote-codecommit.

    Si utiliza SSH, cambie a sus claves originales. Para obtener más información, consulte SSH y Linux, macOS o Unix: configure las claves públicas y privadas de Git y CodeCommit o Paso 3: Configurar las claves públicas y privadas para Git y CodeCommit.

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

2. En la página Panel, en la lista de repositorios, seleccione MyDemoRepo.

3. En el panel de navegación, seleccione Configuración.

4. En la página Settings, en Delete repository, elija Delete repository.

5. En el cuadro junto a Type the name of the repository to confirm deletion (Escriba el nombre del repositorio para confirmar la eliminación), introduzca MyDemoRepo y, a continuación, seleccione Delete (Eliminar).