Tutorial de AWS CodeCommit para AWS Cloud9 - AWS Cloud9
Requisitos previosPaso 1: configurar el grupo de IAM con los permisos de acceso necesariosPaso 2: Crear un repositorio en CodeCommitPaso 3: conectar el entorno con el repositorio remotoPaso 4: clonar el repositorio remoto en su entornoPaso 5: añadir archivos al repositorioPaso 6: limpiar

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

Tutorial de AWS CodeCommit para AWS Cloud9

Puede utilizar el tutorial de AWS CodeCommit para configurar un entorno de desarrollo de AWS Cloud9 que interactúe con un repositorio de código remoto en CodeCommit. CodeCommit es un servicio de control de código fuente que permite almacenar de forma privada y administrar repositorios de Git en la Nube de AWS. Para obtener más información sobre CodeCommit, consulte la Guía del usuario de AWS CodeCommit.

El uso de este tutorial y la creación de esta muestra puede generar cargos en su Cuenta de AWS. Estos incluyen posibles cargos por servicios como Amazon EC2 y CodeCommit. Para obtener más información, consulte Precios de Amazon EC2 y Precios de AWS CodeCommit.

Requisitos previos

Antes de utilizar este ejemplo, asegúrese de que su configuración cumpla los siguientes requisitos:

  • Debe tener un entorno de desarrollo de AWS Cloud9 EC2. En este ejemplo, se da por hecho que ya tiene un entorno de EC2 que está conectado a una instancia de Amazon EC2 que ejecuta Amazon Linux o Ubuntu Server. Si tiene otro tipo de entorno o sistema operativo, es posible que tenga que adaptar las instrucciones de este ejemplo para configurar herramientas relacionadas. Para obtener más información, consulte Creación de un entorno en AWS Cloud9.

  • Ya tiene abierto el IDE de AWS Cloud9 para el entorno existente. Al abrir un entorno, AWS Cloud9 abre el IDE de ese entorno en el navegador web. Para obtener más información, consulte Apertura de un entorno en AWS Cloud9.

Paso 1: configurar el grupo de IAM con los permisos de acceso necesarios

Suponga que sus credenciales de AWS están asociadas a un usuario administrador en su Cuenta de AWS y desea utilizar ese usuario para trabajar con CodeCommit. En ese caso, vaya al Paso 2: crear un repositorio en AWS CodeCommit.

Puede completar este paso con la AWS Management Console o con la interfaz de línea de comandos de AWS (AWS CLI).

Configurar el grupo de IAM con los permisos de acceso necesarios usando la consola

  1. Si todavía no ha iniciado sesión en la AWS Management Console, hágalo ahora.

    En este paso, le recomendamos que inicie sesión con las credenciales de un usuario administrador en la Cuenta de AWS. Si no puede hacerlo, consulte con el administrador de la Cuenta de AWS.

  2. Abra la consola de IAM. Para ello, en la barra de navegación de la consola, elija Services (Servicios). A continuación, elija IAM.

  3. Elija Groups (Grupos).

  4. Elija el nombre del grupo.

  5. En la pestaña Permissions (Permisos), en Managed Policies (Políticas administradas), elija Attach Policy (Adjuntar política).

  6. En la lista con los nombres de las políticas, seleccione una de las siguientes casillas:

    • Seleccione AWSCodeCommitPowerUser para acceder a todas las funciones de CodeCommit y a los recursos relacionados con el repositorio. Sin embargo, esto no le permite eliminar repositorios de CodeCommit ni crear o eliminar los recursos relacionados con el repositorio en otros Servicios de AWS, como Eventos de Amazon CloudWatch.

    • Seleccione AWSCodeCommitFullAccess para tener el control total de los repositorios de CodeCommit y los recursos relacionados en la Cuenta de AWS. Esto incluye la capacidad de eliminar repositorios.

    Si no ve ninguno de los nombres de política en la lista, escriba los nombres de la políticas en el cuadro Filter (Filtrar) para mostrarlos.

  7. Seleccione Asociar política.

Para ver la lista de los permisos de acceso que estas políticas administradas por AWS asignan a un grupo, consulte Políticas administradas (predefinidas) por AWS para AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Vaya al Paso 2: Crear un repositorio en AWS CodeCommit.

Configurar un grupo de IAM con los permisos de acceso necesarios usando AWS CLI

Ejecute el comando attach-group-policy de IAM y especifique el nombre del grupo y el nombre de recurso de Amazon (ARN) de la política administrada por AWS que describe los permisos de acceso necesarios. La sintaxis es la siguiente.

aws iam attach-group-policy --group-name MyGroup --policy-arn POLICY_ARN

En el comando anterior, reemplace MyGroup por el nombre del grupo. Reemplace POLICY_ARN por el ARN de la política administrada por AWS:

  • arn:aws:iam::aws:policy/AWSCodeCommitPowerUser para acceder a todas las funciones de CodeCommit y a los recursos relacionados con el repositorio. Sin embargo, no le permite eliminar repositorios de CodeCommit ni crear o eliminar los recursos relacionados con el repositorio en otros Servicios de AWS, como Eventos de Amazon CloudWatch.

  • arn:aws:iam::aws:policy/AWSCodeCommitFullAccess para tener el control total de los repositorios de CodeCommit y los recursos relacionados en la Cuenta de AWS. Esto incluye la capacidad de eliminar repositorios.

Para ver la lista de los permisos de acceso que estas políticas administradas por AWS asignan a un grupo, consulte Políticas administradas (predefinidas) por AWS para AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Paso 2: Crear un repositorio en CodeCommit

En este paso, se crea un repositorio de código remoto en CodeCommit mediante la consola de CodeCommit.

Si ya tiene un repositorio de CodeCommit, vaya al Paso 3: Conectar el entorno con el repositorio remoto.

Puede completar este paso con la AWS Management Console o con la interfaz de línea de comandos de AWS (AWS CLI).

Crear un repositorio en CodeCommit usando la consola

  1. Suponga que ha iniciado sesión en la AWS Management Console como usuario administrador del paso anterior pero no desea utilizar este usuario administrador para crear el repositorio. En ese caso, cierre sesión en la AWS Management Console.

  2. Abra la consola de CodeCommit en https://console.aws.amazon.com/codecommit/.

  3. En la barra de navegación de la consola, utilice el selector de regiones para elegir la Región de AWS en la que desea crear el repositorio (por ejemplo, US East (Ohio) [Este de EE. UU [Ohio]]).

  4. Si aparece una página de bienvenida, elija Get Started Now. Si no, elija Create repository (Crear repositorio).

  5. En la página Create repository (Crear repositorio), en Repository name (Nombre del repositorio), escriba un nombre para el repositorio (por ejemplo, MyDemoCloud9Repo). Si elige otro nombre, sustitúyalo en todo este ejemplo.

  6. (Opcional) En Description (Descripción), escriba un breve texto sobre el repositorio. Por ejemplo, puede introducir: This is a demonstration repository for the AWS Cloud9 sample.

  7. Elija Create repository. Se muestra un panel Connect to your repository (Conectar con el repositorio). Seleccione Close (Cerrar), ya que se conectará a su repositorio de una forma diferente más adelante en este tema.

Salte al Paso 3: Conectar el entorno con el repositorio remoto.

Crear un repositorio en CodeCommit usando AWS CLI

Ejecute el comando AWS CodeCommit del create-repository. Especifique el nombre del repositorio, una descripción opcional y la Región de AWS en la que desea crear el repositorio.

aws codecommit create-repository --repository-name MyDemoCloud9Repo --repository-description "This is a demonstration repository for the AWS Cloud9 sample." --region us-east-2

En el comando anterior, sustituya us-east-2 por el ID de la Región de AWS en la que se creará el repositorio. Para obtener una lista de las regiones compatibles, consulte AWS CodeCommit en la Referencia general de Amazon Web Services.

Si decide usar otro nombre para el repositorio sustitúyalo en todo este ejemplo.

Paso 3: conectar el entorno con el repositorio remoto

En este paso, utilice el IDE de AWS Cloud9 para conectarse al repositorio de CodeCommit que ha creado o identificado en el paso anterior.

nota

Si prefiere trabajar con Git a través de una interfaz visual, puede clonar el repositorio remoto. A continuación, puede añadir archivos mediante la función del panel de Git que está disponible en el IDE.

Complete uno de los siguientes conjuntos de procedimientos en función del tipo de entorno de desarrollo de AWS Cloud9 que tenga.

Tipo de entorno Siga estos procedimientos

Entorno de EC2

  1. Desde una sesión del terminal en el IDE, ejecute los dos comandos siguientes:

    git config --global credential.helper '!aws codecommit credential-helper $@'
git config --global credential.UseHttpPath true

    Para obtener más información, consulte Paso 2: Configuración del auxiliar de credenciales de AWS CLI en el entorno de desarrollo de EC2 de AWS Cloud9 en Integración de AWS Cloud9 con AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

  2. Vaya al Paso 4: clonar el repositorio remoto en su entorno, más adelante en este tema.

Entorno de SSH

  1. Si Git todavía no está instalado en el entorno, utilice una sesión del terminal en el IDE para instalarlo. Para obtener más información, consulte el Paso 2: instalar Git en Setup Steps for SSH Connections to AWS CodeCommit Repositories on Linux, macOS, or Unix (Pasos de configuración para conexiones SSH a repositorios de AWS CodeCommit en Linux, macOS o Unix) en la Guía del usuario de AWS CodeCommit.

  2. Complete el Paso 3: Configurar credenciales en Linux, macOS o Unix en Pasos de configuración para conexiones SSH a repositorios de AWS CodeCommit en Linux, macOS o Unix en la Guía del usuario de AWS CodeCommit.

    Cuando se le indique que inicie sesión en la AWS Management Console y abra la consola de IAM, le recomendamos que inicie sesión con las credenciales de un usuario administrador de IAM en su Cuenta de AWS. Si no puede hacerlo, consulte con el administrador de la Cuenta de AWS.

  3. Vaya al Paso 4: clonar el repositorio remoto en su entorno, más adelante en este tema.

Paso 4: clonar el repositorio remoto en su entorno

En este paso, se utiliza el IDE de AWS Cloud9 para clonar el repositorio remoto de CodeCommit en su entorno.

Para clonar el repositorio, ejecute el comando git clone. Reemplace CLONE_URL por la URL de clonación del repositorio.

git clone CLONE_URL

Para un entorno de EC2, se proporciona una URL de clonación HTTPS que comienza por https://. Para un entorno de SSH, se proporciona una URL de clonación SSH que comienza por ssh://.

Para obtener la URL de clonación completa del repositorio, consulte Uso de la consola de AWS CodeCommit para ver la información de los repositorios en la Guía del usuario de AWS CodeCommit.

Si su repositorio no tiene ningún archivo, se muestra un mensaje de advertencia, por ejemplo, You appear to have cloned an empty repository. Este es el comportamiento esperado. Lo veremos más adelante.

Paso 5: añadir archivos al repositorio

En este paso, se crean tres archivos simples en el repositorio clonado de su entorno de AWS Cloud9. A continuación, añada los archivos al área provisional de Git de su repositorio clonado. Por último, confirme los archivos almacenados provisionalmente y envíe la confirmación al repositorio remoto de CodeCommit.

Si el repositorio clonado ya tiene archivos, ha terminado y puede ignorar el resto de esta muestra.

Para añadir archivos al repositorio

  1. Cree un archivo nuevo. En la barra de menús, elija File (Archivo), New File (Archivo nuevo).

  2. Escriba el contenido siguiente en el archivo y, a continuación, elija File (Archivo), Save (Guardar) para guardar el archivo como bird.txt en el directorio MyDemoCloud9Repo de su entorno de AWS Cloud9.

    bird.txt
--------
Birds are a group of endothermic vertebrates, characterized by feathers,
toothless beaked jaws, the laying of hard-shelled eggs, a high metabolic
rate, a four-chambered heart, and a lightweight but strong skeleton.
    nota

    Para confirmar que guarda el archivo en el directorio correcto, en el cuadro de diálogo Save As (Guardar como), elija la carpeta MyDemoCloud9Repo. A continuación, asegúrese de que en Folder (Carpeta) se muestre /MyDemoCloud9Repo.

  3. Cree dos archivos más, llamados insect.txt y reptile.txt, con el siguiente contenido. Guarde los archivos en el mismo directorio MyDemoCloud9Repo.

    insect.txt
----------
Insects are a class of invertebrates within the arthropod phylum that
have a chitinous exoskeleton, a three-part body (head, thorax, and abdomen),
three pairs of jointed legs, compound eyes, and one pair of antennae.
    reptile.txt
-----------
Reptiles are tetrapod (four-limbed vertebrate) animals in the class
Reptilia, comprising today's turtles, crocodilians, snakes,
amphisbaenians, lizards, tuatara, and their extinct relatives.

  4. En el terminal, ejecute el comando cd para cambiar al directorio MyDemoCloud9Repo.

    cd MyDemoCloud9Repo

  5. Confirme que el archivo se ha guardado correctamente en el directorio MyDemoCloud9Repo ejecutando el comando git status. Los tres archivos se mostrarán como archivos sin seguimiento.

    Untracked files:
  (use "git add <file>..." to include in what will be committed)

        bird.txt
        insect.txt
        reptile.txt

  6. Añada los archivos al espacio provisional de Git ejecutando el comando git add.

    git add --all

  7. Confirme que los archivos se hayan añadido correctamente al espacio provisional de Git ejecutando el comando git status de nuevo. Los tres archivos aparecen ahora como cambios por confirmar.

    Changes to be committed:
  (use "git rm --cached <file>..." to unstage)

        new file:   bird.txt
        new file:   insect.txt
        new file:   reptile.txt

  8. Confirme los archivos del espacio provisional ejecutando el comando git commit.

    git commit -m "Added information about birds, insects, and reptiles."

  9. Envíe la confirmación al repositorio remoto de CodeCommit ejecutando el comando git push.

    git push -u origin master

  10. Confirme si los archivos se han enviado correctamente. Abra la consola de CodeCommit si aún no está abierta, en https://console.aws.amazon.com/codecommit.

  11. En la barra de navegación superior, cerca del borde derecho, elija la Región de AWS en la que creó el repositorio (por ejemplo, US East (Ohio) (Este de EE. UU. [Ohio]).

  12. En la página Dashboard (Panel), seleccione MyDemoCloud9Repo. Se muestran los tres archivos.

Para continuar experimentando con el repositorio de CodeCommit, consulte Examinar el contenido del repositorio en la Guía del usuario de AWS CodeCommit.

Si es la primera vez que utiliza Git y no desea modificar el repositorio de CodeCommit, experimente con un repositorio de Git de ejemplo en el sitio web TryGit Git.

Paso 6: limpiar

Para evitar que se aplique cargos continuos en su Cuenta de AWS una vez terminado este ejemplo, le conviene eliminar el repositorio de CodeCommit. Para obtener instrucciones, consulte Eliminar un repositorio de AWS CodeCommit en la Guía del usuario de AWS CodeCommit.

Asegúrese también de eliminar el entorno. Para obtener instrucciones, consulte la sección sobre eliminación de entornos.