Tutorial: creación de un proyecto con un repositorio de código fuente de GitHub

Con AWS CodeStar, puede configurar su repositorio para crear, revisar y fusionar solicitudes de extracción con el equipo del proyecto.

En este tutorial, se explica cómo crear un proyecto con un ejemplo de código fuente de una aplicación web en un repositorio de GitHub, con una canalización que despliega los cambios y con instancias de EC2 en las que la aplicación está alojada en la nube. Una vez creado el proyecto, en este tutorial se muestra cómo crear y fusionar una solicitud de extracción de GitHub que realiza un cambio en la página de inicio de la aplicación web.

Paso 1: crear el proyecto y crear el repositorio de GitHub

En este paso, utilice la consola para crear el proyecto y para crear una conexión al nuevo repositorio de GitHub. Para acceder al repositorio de GitHub, cree un recurso de conexión que AWS CodeStar utiliza para administrar la autorización con GitHub. Al crear el proyecto, se aprovisionan sus recursos adicionales para el usuario.

1. Inicie sesión en la AWS Management Console y, a continuación, abra la consola de AWS CodeStar en https://console.aws.amazon.com/codestar/.

2. Elija la región de AWS donde desee crear el proyecto y sus recursos.

3. En la página AWS CodeStar, seleccione Crear proyecto.

4. En la página Elegir una plantilla de proyecto, marque las casillas de verificación Aplicación web, Node.js y Amazon EC2. A continuación, elija entre las plantillas disponibles para ese conjunto de opciones.

   Para obtener más información, consulte Plantillas de proyecto de AWS CodeStar.

5. Elija Siguiente.

6. En Project name (Nombre del proyecto), escriba un nombre para el proyecto (por ejemplo, MyTeamProject). Si elige otro nombre, asegúrese de utilizarlo durante todo el tutorial.

7. En Repositorio de proyectos, elija GitHub.

8. Si elige GitHub, tendrá que elegir o crear un recurso de conexión. Si ya tiene una conexión, selecciónela en el campo de búsqueda. De lo contrario, se creará una nueva conexión en este paso. Seleccione Conectarse a GitHub.

   Se mostrará la página Crear una conexión.

   nota

   Para crear una conexión, debe tener una cuenta de GitHub. Si va a crear una conexión para una organización, debe ser el propietario de la organización.

   

   1. En Cree una conexión de aplicación de GitHub, el nombre de la conexión aparece en Nombre de la conexión. Seleccione Conectarse a GitHub.

      Aparecerá la página Conectarse a GitHub, donde se muestra el campo Aplicaciones de GitHub.

   2. En GitHub Apps (Aplicaciones GitHub), elija la instalación de una aplicación o elija Install a new app (Instalar una aplicación nueva) para crear una.

      nota

      Se instala una aplicación para todas las conexiones a un proveedor en particular. Si ya instaló la aplicación AWS Connector for GitHub, elija la aplicación y omita este paso.

   3. En la página Instalar el conector de AWS para GitHub, elija la cuenta donde desee instalar la aplicación.

      nota

      Si instaló la aplicación previamente, puede elegir Configurar para dirigirse a una página de modificación para la instalación de la aplicación o puede utilizar el botón Atrás para volver a la consola.

   4. Si aparece la página Confirmar contraseña para continuar, introduzca su contraseña de GitHub y, a continuación, seleccione Iniciar sesión.

   5. En la página Instalar AWS Connector for GitHub, deje los valores predeterminados y elija Instalar.

   6. En la página Conectarse a GitHub, el ID de instalación para la nueva instalación aparece en Aplicaciones de GitHub.

      Una vez que la conexión se haya creado correctamente, en la página de creación del proyecto de CodeStar, aparecerá el mensaje Listo para conectarse.

      nota

      Puede ver la conexión en la sección Configuración de la consola de Herramientas para desarrolladores. Para obtener más información, consulte Introducción a las conexiones.

      

   7. Para Propietario del repositorio, seleccione la organización de GitHub o su cuenta personal de GitHub.

   8. Para Nombre del repositorio, acepte el nombre del repositorio de GitHub predeterminado o escriba otro diferente.

   9. Elija Público o Privado.

      nota

      Si desea utilizar AWS Cloud9 como entorno de desarrollo, debe elegir un repositorio público.

   10. (Opcional) En Descripción del repositorio, escriba una descripción para el repositorio de GitHub.

9. Configure sus instancias de Amazon EC2 en Configuración de Amazon EC2 si su proyecto se ha implementado en instancias de Amazon EC2 y desea realizar cambios. Por ejemplo, puede elegir entre los tipos de instancia disponibles para el proyecto.

   Para Par de claves, seleccione el par de claves de Amazon EC2 que ha creado en Paso 4: crear un par de claves de Amazon EC2 para proyectos de AWS CodeStar. Seleccione Confirmo que tengo acceso al archivo de clave privada.

10. Seleccione Siguiente.

11. Revise los recursos y los detalles de la configuración.

12. Seleccione Siguiente o Crear proyecto. (La selección mostrada depende de la plantilla del proyecto).

    Espere unos minutos mientras se crea el proyecto.

13. Una vez creado el proyecto, seleccione Ver la aplicación para ver la aplicación web.

Paso 2: ver el código fuente

En este paso, verá el código fuente y las herramientas que puede utilizar para el repositorio de código fuente.

1. En el panel de navegación del proyecto, seleccione Repositorio.

   Para ver una lista de las confirmaciones en GitHub, seleccione Ver las confirmaciones. Esto abrirá el historial de confirmaciones en GitHub.

   Para ver los problemas, seleccione la pestaña Problemas del proyecto. Para crear un nuevo problema en GitHub, seleccione Crear problema de GitHub. Esto abrirá el formulario de problemas del repositorio en GitHub.

2. En la pestaña Repositorio, seleccione el enlace que aparece debajo de Nombre del repositorio, y el repositorio del proyecto se abrirá en una nueva pestaña o ventana. Este repositorio contiene el código fuente de su proyecto.

Paso 3: crear una solicitud de extracción de GitHub

En este paso, se realizará un cambio menor en el código fuente y se creará una solicitud de extracción.

1. En GitHub, cree una nueva ramificación de características en el repositorio. Elija el campo desplegable de la ramificación principal e introduzca una nueva ramificación en el campo denominado feature-branch. Seleccione Crear la ramificación. La ramificación se creará y se extraerá para el usuario.

2. En GitHub, realice algún cambio en la ramificación feature-branch. Abra la carpeta pública y, a continuación, abra el archivo index.html.

3. En la consola de AWS CodeStar, en Solicitudes de extracción, para crear una solicitud de extracción en GitHub, seleccione Crear la solicitud de extracción. Esto abrirá el formulario de solicitud de extracción de repositorios en GitHub. En GitHub, seleccione el icono del lápiz para editar el archivo.

   DespuésCongratulations!, agregue la cadena Well done, <name>! y sustituya <name> por su nombre. Seleccione Confirmar cambios. El cambio se confirmará en la ramificación de características.

4. En la consola de AWS CodeStar, seleccione el proyecto. Seleccione la pestaña Repositorio. En Solicitudes de extracción, seleccione Crear la solicitud de extracción.

   El formulario se abrirá en GitHub. Deje la ramificación principal en la ramificación base. En Comparar con, elija la ramificación de características. Observe las diferencias.

5. En GitHub, seleccione Crear la solicitud de extracción. Se creará una solicitud de extracción denominada Update index.html.

6. En la consola de AWS CodeStar, consulta la nueva solicitud de extracción. Seleccione Combinar cambios para confirmar los cambios en el repositorio y combinar la solicitud de extracción con la ramificación principal de su repositorio.

7. Regrese al proyecto en AWS CodeStar y consulte la página Canalización. Debería ver la canalización implementándose.

8. Una vez creado el proyecto, seleccione Ver la aplicación para ver la aplicación web.