

# Uso del kit de herramientas de AWS para JetBrains con AWS App Runner
<a name="using-apprunner"></a>

[AWS App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/what-is-apprunner.html) proporciona una forma rápida, sencilla y rentable de implementar desde el código fuente o una imagen de contenedor directamente hacia una aplicación web escalable y segura en la nube de AWS. Al usarla, no es necesario aprender nuevas tecnologías, decidir qué servicio informático utilizar o saber cómo aprovisionar y configurar los recursos de AWS.

Puede utilizar AWS App Runner para crear y administrar servicios basados en una *imagen de origen* o *código fuente*. Si utiliza una imagen de origen, puede elegir una imagen de contenedor pública o privada que se almacena en un repositorio de imágenes. App Runner es compatible con los siguientes proveedores de repositorios de imágenes:
+ Amazon Elastic Container Registry (Amazon ECR): almacena imágenes privadas en su cuenta de AWS.
+ Amazon Elastic Container Registry Public (Amazon ECR Public): almacena imágenes de lectura pública.

 Si elige la opción de código fuente, puede implementarla desde un repositorio de código fuente mantenido por un proveedor de repositorios compatible. Actualmente, App Runner admite [GitHub](https://github.com/) como proveedor de repositorio de código fuente. 

## Requisitos previos
<a name="apprunner-prereqs"></a>

En esta sección se asume que ya tiene una cuenta de AWS y la versión más reciente del AWS Toolkit for JetBrains, que cuenta con AWS App Runner. Además de estos requisitos básicos, asegúrese de que todos los usuarios pertinentes de IAM tengan permisos para interactuar con el servicio de App Runner. También debe obtener información específica acerca del origen del servicio, como el URI de la imagen del contenedor o la conexión al repositorio de GitHub. Necesitará esta información al crear el servicio de App Runner.

### Configuración de permisos de IAM para App Runner
<a name="app-runner-permissions"></a>

La forma más sencilla de conceder los permisos necesarios para App Runner es adjuntar una política administrada de AWS existente a la entidad de IAM pertinente, específicamente un usuario o grupo. App Runner proporciona dos políticas administradas que puede adjuntar a los usuarios de IAM:
+ `AWSAppRunnerFullAccess`: permite a los usuarios realizar todas las acciones de App Runner.
+ `AWSAppRunnerReadOnlyAccess`: permite a los usuarios publicar y ver detalles sobre los recursos de App Runner. 

Además, si elige un repositorio privado de Amazon Elastic Container Registry (Amazon ECR) como origen de servicio, debe crear el siguiente rol de acceso para su servicio de App Runner:
+ `AWSAppRunnerServicePolicyForECRAccess`: permite a App Runner acceder a imágenes de Amazon Elastic Container Registry (Amazon ECR) de su cuenta.

Puede utilizar el cuadro de diálogo **Crear servicio de App Runner** para crear este rol de IAM.

**nota**  
El rol vinculado a servicios **AWSServiceRoleForAppRunner** permite que AWS App Runner lleve a cabo las siguientes tareas:  
Insertar registros en los grupos de registros de Amazon CloudWatch Logs.
Crear reglas de Amazon CloudWatch Events para suscribirse a la inserción de imágenes de Amazon Elastic Container Registry (Amazon ECR).
No necesita crear manualmente el rol vinculado al servicio . Al crear un AWS App Runner en la Consola de administración de AWS o mediante operaciones de API a las que llama a través del AWS Toolkit for JetBrains, AWS App Runner crea este rol vinculado a servicios en su lugar. 

Para obtener más información, consulte [Identity and access management for App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/security-iam.html) (Administración de identidades y accesos para App Runner) en la *Guía para desarrolladores de AWS App Runner*.

### Obtención de orígenes de servicio para App Runner
<a name="app-runner-sources"></a>

Puede utilizar AWS App Runner para implementar servicios desde una imagen de origen o código fuente. 

------
#### [ Source image ]

Si va a implementar desde una imagen de origen, puede obtener un enlace al repositorio de esa imagen desde un registro de imágenes de AWS privado o público. 
+ Registro privado de Amazon ECR: copie el URI de un repositorio privado que utiliza la consola de Amazon ECR en [https://console.aws.amazon.com/ecr/repositories](https://console.aws.amazon.com/ecr/repositories). 
+ Registro público de Amazon ECR: copie el URI de un repositorio público que utiliza la Galería pública de Amazon ECR en [https://gallery.ecr.aws/](https://gallery.ecr.aws).

Puede especificar el URI del repositorio de imágenes al introducir los detalles del origen en el cuadro de diálogo **Crear servicio de App Runner**.

Para obtener más información, consulte [App Runner service based on a source image](https://docs.aws.amazon.com/apprunner/latest/dg/service-source-image.html) (Servicio de App Runner basado en una imagen de origen) en la *Guía para desarrolladores de AWS App Runner*.

------
#### [ Source code ]

Para que el código fuente se implemente en un servicio de AWS App Runner, ese código se debe almacenar en un repositorio Git mantenido por un proveedor de repositorios compatible. App Runner admite un proveedor de repositorio de código fuente: [GitHub](https://github.com/).

Para obtener más información sobre la configuración de un repositorio de GitHub, consulte [Getting started documentation](https://docs.github.com/en/github/getting-started-with-github) (Documentación de introducción) en GitHub.

Para implementar el código fuente en un servicio de App Runner desde un repositorio de GitHub, App Runner establece una conexión con GitHub. Si el repositorio es privado (es decir, no es de acceso público en GitHub), debe proporcionar detalles de conexión a App Runner. 

**importante**  
Para crear conexiones de GitHub, debe utilizar la consola de App Runner ([https://console.aws.amazon.com/apprunner](https://console.aws.amazon.com/apprunner)) para crear una conexión que vincule GitHub a AWS. Puede seleccionar las conexiones que están disponibles en la página **Conexiones de GitHub** cuando se utilice el cuadro de diálogo **Crear servicio de App Runner** para especificar detalles sobre el repositorio de código fuente.   
Para obtener más información, consulte [Managing App Runner connections](https://docs.aws.amazon.com/apprunner/latest/dg/manage-connections.html) (Administración de conexiones de App Runner) en la *Guía para desarrolladores de AWS App Runner*.

La instancia de servicio de App Runner proporciona un tiempo de ejecución administrado que permite crear y ejecutar el código. Actualmente, AWS App Runner admite los siguientes tiempos de ejecución:
+ Tiempo de ejecución administrado de Python 
+ Tiempo de ejecución administrado de Node.js

Mediante el cuadro de diálogo **Crear servicio de App Runner** que está disponible en AWS Toolkit for JetBrains, proporciona información sobre cómo el servicio de App Runner crea e inicia su servicio. Puede introducir la información directamente en la interfaz o especificar un [archivo de configuración de App Runner](https://docs.aws.amazon.com/apprunner/latest/dg/config-file.html) en formato YAML. Los valores de este archivo le indican a App Runner cómo crear e iniciar el servicio y proporcionan contexto de tiempo de ejecución. Esto incluye la configuración de red y las variables de entorno correspondientes. El archivo de configuración se llama `apprunner.yaml`. Se agrega de manera automática al directorio raíz del repositorio de la aplicación.

 

------

## Precios
<a name="app-runner-pricing"></a>

Se le cobrará por los recursos informáticos y de memoria que utiliza la aplicación. Además, si automatiza las implementaciones, también pagará una tarifa mensual fija por cada aplicación que cubre todas las implementaciones automatizadas de ese mes. Si opta por implementar desde el código fuente, también pagará una tarifa de compilación por el tiempo que demora App Runner en crear un contenedor a partir del código fuente.

Para obtener más información, consulte [Precios de AWS App Runner](https://aws.amazon.com/apprunner/pricing/).

**Topics**
+ [Requisitos previos](#apprunner-prereqs)
+ [Precios](#app-runner-pricing)
+ [Creación de servicios de App Runner](creating-service-apprunner.md)
+ [Administración de los servicios de App Runner](managing-service-apprunner.md)