Plantillas de proyecto de AWS CodeStar

Las plantillas de proyectos de AWS CodeStar le permiten comenzar con una aplicación de ejemplo e implementarla con los recursos de AWS creados de modo que sea compatible con su proyecto de desarrollo. Cuando se elige una plantilla de proyecto de AWS CodeStar, el tipo de aplicación, el lenguaje de programación y la plataforma de computación se aprovisionan automáticamente para el usuario. Después de crear proyectos con las aplicaciones web, los servicios web, skills de Alexa y páginas web estáticas, puede sustituir la aplicación de ejemplo por la suya.

Una vez que AWS CodeStar crea el proyecto, puede modificar los recursos de AWS que admiten la entrega de su aplicación. AWS CodeStar trabaja con AWS CloudFormation para permitir que se utilice el código para crear servicios de soporte y plataformas con o sin servidor en la nube. AWS CloudFormation le permite modelar toda la infraestructura en un archivo de texto.

Archivos de proyectos de AWS CodeStar y recursos

Un proyecto de AWS CodeStar es una combinación de código fuente y de los recursos creados para implementar el código. El conjunto de recursos que le ayuda a crear, publicar e implementar el código se denomina recursos de la cadena de herramientas. Al crear el proyecto, una plantilla de AWS CloudFormation aprovisiona los recursos de la cadena de herramientas en una canalización de integración e implementación continuas (CI/CD).

Puede utilizar AWS CodeStar para crear proyectos en dos formas, en función de su nivel de experiencia con la creación de recursos de AWS:

• Si utiliza la consola para crear un proyecto, AWS CodeStar crea sus recursos de la cadena de herramientas, incluido el repositorio, y rellena el repositorio con código de aplicación de muestra y archivos del proyecto. Utilice la consola para configurar rápidamente proyectos de muestra en función de una serie de opciones de proyecto preconfiguradas.

• Cuando se utiliza la CLI para crear un proyecto, proporciona la plantilla de AWS CloudFormation que crea los recursos de la cadena de herramientas y también proporciona el código fuente de la aplicación. Utilice la interfaz de línea de comandos (CLI) para permitir que AWS CodeStar cree su proyecto a partir de su plantilla y, a continuación, rellene el repositorio con su código de muestra.

Un proyecto de AWS CodeStar proporciona un solo punto de administración. Puede utilizar el asistente Create project (Crear proyecto) en la consola para configurar un proyecto de muestra. A continuación, puede utilizarlo como una plataforma de colaboración para administrar permisos y recursos para su equipo. Para obtener más información, consulte ¿Qué es AWS CodeStar?. Si utiliza la consola para crear un proyecto, el código fuente se suministra como código de muestra y se crean automáticamente los recursos de la cadena de herramientas de CI/CD

Al crear un proyecto en la consola, AWS CodeStar aprovisiona los siguientes recursos:

• Un repositorio de código en GitHub o CodeCommit.

• En el repositorio del proyecto, un archivo README.md que proporciona detalles de archivos y directorios.

• En el repositorio del proyecto, un archivo template.yml que almacena la definición de la pila del tiempo de ejecución de la aplicación. Este archivo se utiliza para añadir o modificar los recursos del proyecto que no sean recursos de la cadena de herramientas, como, por ejemplo, los recursos de AWS que se utilizan para las notificaciones, el soporte para la base de datos, la supervisión y el seguimiento.

• Los servicios y recursos de AWS creados en relación con la canalización, como el bucket del artefacto de Amazon S3, Eventos de Amazon CloudWatch y roles de servicios relacionados.

• Una aplicación de muestra funcional con código fuente completo y un punto de conexión de HTTP pública.

• Un recurso informático de AWS, en función del tipo de plantilla del proyecto de AWS CodeStar:

  • Una función Lambda.

  • Una instancia de Amazon EC2.

  • Un entorno de AWS Elastic Beanstalk.

• A partir del 6 de diciembre de 2018 PDT:

  • Un límite de permisos, que es una política de IAM especializada para controlar el acceso a los recursos del proyecto. El límite de permisos está asociado de forma predeterminada a roles en el proyecto de ejemplo. Para obtener más información, consulte Límite de permisos de IAM para roles de trabajador.

  • Un rol de IAM de AWS CloudFormation para crear recursos de proyecto mediante AWS CloudFormation que incluye permisos para todos los recursos de AWS CloudFormation admitidos, incluidos roles de IAM.

  • Un rol de IAM de cadena de herramientas.

  • Roles de ejecución para Lambda definidos en la pila de aplicación y que se pueden modificar.

• Antes del 6 de diciembre de 2018 PDT:

  • Un rol de IAM de AWS CloudFormation para crear recursos de proyecto con soporte para un conjunto limitado de recursos de AWS CloudFormation.

  • Un rol de IAM para crear un recurso de CodePipeline.

  • Un rol de IAM para crear un recurso de CodeBuild.

  • Un rol de IAM para crear un recurso de CodeDeploy, si es aplicable a su tipo de proyecto.

  • Un rol de IAM para crear la aplicación web de Amazon EC2, si es aplicable a su tipo de proyecto.

  • Un rol de IAM para crear un recurso de CloudWatch Events.

  • Un rol de ejecución para Lambda que se modifica de forma dinámica para incluir un conjunto parcial de recursos.

El proyecto incluye páginas detalladas que muestran el estado y contienen enlaces a la administración del equipo y enlaces a instrucciones de configuración para los IDE o para el repositorio, así como un historial de confirmaciones de los cambios en el código fuente en el repositorio. También puede seleccionar herramientas para conectarse a herramientas de seguimiento externas, como, por ejemplo, Jira.

Introducción: elija una plantilla del proyecto

Cuando elija un proyecto de AWS CodeStar en la consola, elige desde un conjunto de opciones preconfiguradas con código de muestra y los recursos para empezar rápidamente. Estas opciones se denominan plantillas de proyecto. Cada plantilla del proyecto de AWS CodeStar consta de un lenguaje de programación, un tipo de aplicación y plataforma de computación. La combinación que seleccione determina la plantilla del proyecto.

Elegir una plataforma de computación de plantillas

Cada plantilla configura uno de los siguientes tipos de plataformas de computación:

• Al elegir un proyecto de AWS Elastic Beanstalk, realice la implementación en un entorno de AWS Elastic Beanstalk en instancias de Amazon Elastic Compute Cloud en la nube.

• Al elegir un proyecto de Amazon EC2, AWS CodeStar crea instancias de Linux EC2 para alojar su aplicación en la nube. Los miembros del equipo de su proyecto pueden acceder a las instancias y su equipo utiliza el par de claves que proporciona a SSH en sus instancias de Amazon EC2. AWS CodeStar también tiene una SSH administrada que utiliza permisos del miembro del equipo para administrar conexiones de pares de claves.

• Al elegir AWS Lambda, AWS CodeStar crea un entorno sin servidor al que se accede a través de Amazon API Gateway, sin instancias o servidores que mantener.

Elija un tipo de aplicación de plantilla

Cada plantilla configura uno de los siguientes tipos de aplicaciones:

• Servicios web

  Un servicio web se utiliza para tareas que se ejecutan en segundo plano como, por ejemplo, llamar a API. Una vez que AWS CodeStar crea su proyecto de servicio web de muestra, puede elegir la dirección URL del punto de conexión para ver "Hello World", pero el uso principal de este tipo de aplicación no es como interfaz de usuario (IU). Las plantillas de proyectos de AWS CodeStar de esta categoría admiten el desarrollo en Ruby, Java, ASP.NET, PHP, Node.js entre otros.

• Aplicación web

  Una aplicación web incluye una IU. Una vez que AWS CodeStar crea su proyecto de aplicación web de muestra, puede elegir la dirección URL del punto de conexión para ver una aplicación web interactiva. Las plantillas de proyectos de AWS CodeStar de esta categoría admiten el desarrollo en Ruby, Java, ASP.NET, PHP, Node.js entre otros.

• Página web estática

  Elija esta plantilla si desea un proyecto para un sitio web HTML. Las plantillas de proyectos de AWS CodeStar de esta categoría admiten el desarrollo en HTML5.

• Habilidad de Alexa

  Seleccione esta plantilla si quiere crear una habilidad de Alexa con una función AWS Lambda. Al crear el proyecto de habilidad, AWS CodeStar devuelve un Nombre de recurso de Amazon (ARN) que se puede utilizar como punto de conexión del servicio. Para obtener más información, consulte Alojar una habilidad personalizada como una función de AWS Lambda.

  nota

  Las funciones de Lambda para las habilidades de Alexa se admiten solo en las regiones Este de EE. UU. (Norte de Virginia), Oeste de EE. UU. (Oregón), UE (Irlanda) y Asia-Pacífico (Tokio).

• Regla de configuración

  Elija esta plantilla si desea que un proyecto tenga una regla de AWS Config que le permita automatizar las reglas en recursos de AWS en su cuenta. La función devuelve un ARN que puede utilizar como punto de conexión de servicio para la regla.

Elegir un lenguaje de programación de la plantilla

Cuando elija una plantilla de proyecto, seleccione un lenguaje de programación, como, por ejemplo, Ruby, Java, ASP.NET, PHP, Node.js y mucho más.

Cómo hacer cambios en su proyecto de AWS CodeStar

Puede actualizar su proyecto modificando:

• Código de muestra y recursos del lenguaje de programación para su aplicación.

• Los recursos que componen la infraestructura donde se almacena e implementa su aplicación (sistemas operativos, aplicaciones y servicios de soporte, los parámetros de implementación y la plataforma de computación en la nube). Puede modificar recursos de la aplicación en el archivo template.yml. Este es el archivo de AWS CloudFormation que crea un modelo de su entorno en tiempo de ejecución de la aplicación.

nota

Si está trabajando en un proyecto de habilidades de Alexa en AWS CodeStar, no podrá realizar cambios en dicha habilidad fuera del repositorio del código fuente de AWS CodeStar (CodeCommit o GitHub). Si edita la habilidad en el portal de desarrolladores de Alexa, el cambio no se aplica al repositorio fuente y las versiones no se sincronizan.

Cambiar código fuente de aplicación y enviar los cambios

Para modificar código fuente de muestra, scripts y otros archivos de código fuente de la aplicación, edite archivos en el repositorio de código fuente de la siguiente manera:

• Mediante el modo Editar en CodeCommit o GitHub.

• Abriendo el proyecto en un IDE, como por ejemplo AWS Cloud9.

• Clonando el repositorio a nivel local y confirmando y enviando, continuación, los cambios. Para obtener más información, consulte Paso 4: confirmar un cambio.

Cambiar recursos de aplicaciones con el archivo Template.yml

En lugar de modificar manualmente el recurso de una infraestructura, utilice AWS CloudFormation para modelar e implementar los recursos del tiempo de ejecución de la aplicación.

Puede modificar o añadir un recurso de aplicación, como, por ejemplo, una función Lambda, en su pila de tiempo de ejecución editando el archivo template.yml en su repositorio del proyecto. Puede añadir cualquier recurso que esté disponible como recurso de AWS CloudFormation.

Para cambiar el código o la configuración de una función de AWS Lambda, consulte Añadir un recurso a un proyecto.

Modifique el archivo template.yml en el repositorio del proyecto para agregar el tipo de recursos de AWS CloudFormation que son recursos de la aplicación. Al añadir el recurso de una aplicación a la sección Resources del archivo template.yml, AWS CloudFormation y AWS CodeStar crean el recurso por usted. Para obtener una lista de recursos de AWS CloudFormation y las propiedades necesarias, consulte Referencia de tipos de recursos de AWS. Para obtener más información, consulte este ejemplo en Paso 1: editar el rol de trabajador de CloudFormation en IAM.

AWS CodeStar le permite implementar prácticas recomendadas mediante la configuración y el modelado del entorno del tiempo de ejecución de la aplicación.

Cómo administrar permisos para cambiar los recursos de aplicaciones

Cuando se utiliza AWS CloudFormation para añadir recursos de la aplicación de tiempo de ejecución, como, por ejemplo, una función Lambda, el rol de empleado de AWS CloudFormation puede utilizar los permisos que ya tiene. Para algunos recursos de la aplicación de tiempo de ejecución, deberá ajustar manualmente los permisos del rol de trabajador de AWS CloudFormation antes de editar el archivo template.yml.

Para ver un ejemplo sobre cómo cambiar los permisos del rol del empleado de AWS CloudFormation, consulte Paso 5: Añadir permisos a nivel de recursos con una política insertada.