Aviso de fin del soporte: el 7 de octubre de 2026 AWS finalizará el soporte para AWS Proton. Después del 7 de octubre de 2026, ya no podrás acceder a la AWS Proton consola ni a AWS Proton los recursos. La infraestructura implementada permanecerá intacta. Para obtener más información, consulte la [Guía AWS Proton de obsolescencia y migración del servicio](https://docs.aws.amazon.com/proton/latest/userguide/proton-end-of-support.html). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Empezar con AWS Proton Introducción [Antes de empezar, [prepárese](ag-setting-up.md) para utilizarla AWS Proton y compruebe que cumple los requisitos previos de introducción.](getting-started-prerequisites.md) **Comience AWS Proton eligiendo una o más de las siguientes rutas:** + Siga un [ejemplo guiado de flujo de trabajo de la consola o la CLI](ag-admin-workflow.md) a través de los enlaces a la documentación. + Siga un [ejemplo guiado de flujo de trabajo de la consola](ag-getting-started-console.md). + Realice un [ejemplo de AWS CLI flujo](ag-getting-started-cli.md) de trabajo guiado. **Topics** + [ # Requisitos previos ](getting-started-prerequisites.md) + [ # Flujo de trabajo de introducción ](ag-admin-workflow.md) + [ # Cómo empezar con el Consola de administración de AWS ](ag-getting-started-console.md) + [ # Empezando con el AWS CLI ](ag-getting-started-cli.md) + [ # La biblioteca AWS Proton de plantillas ](ag-getting-started-templates.md) # Requisitos previos Antes de empezar a usarlo AWS Proton, asegúrese de que se cumplen los siguientes requisitos previos. Para obtener más información, consulte [Configuración](ag-setting-up.md). + Debe tener una cuenta de IAM con permisos de administrador. Para obtener más información, consulte [Configuración con IAM](ag-setting-up-iam.md). + Tienes el rol de AWS Proton servicio y el rol de servicio de AWS Proton canalización están asociados a tu cuenta. Para obtener más información, consulte [Configuración de funciones de AWS Proton servicio](ag-setting-up-iam.md#setting-up-cicd) y [Funciones de servicio para AWS Proton](security_iam_service-with-iam.md#security_iam_service-with-iam-roles-service). + Tienes una AWS CodeStar conexión. Para obtener más información, consulte [Configuración de una AWS CodeStar conexión](setting-up-for-service.md#setting-up-vcontrol). + Estás familiarizado con la creación de CloudFormation plantillas y la parametrización de Jinja. [Para obtener más información, consulte ¿Qué es? CloudFormation](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html) *en la Guía del CloudFormation usuario* y en el [sitio web de Jinja](https://palletsprojects.com/projects/jinja). + Tiene conocimientos básicos sobre los servicios de AWS infraestructura. + Ha iniciado sesión en su Cuenta de AWS. # Flujo de trabajo de introducción Obtenga información sobre cómo crear paquetes de plantillas, crear y registrar plantillas y crear entornos y servicios siguiendo los pasos y enlaces de ejemplo. Antes de empezar, compruebe que haya creado un [rol de servicio de AWS Proton](ag-setting-up-iam.md#setting-up-cicd). Si tu plantilla de servicio incluye una canalización de AWS Proton servicios, comprueba que has creado una [AWS CodeStar conexión](setting-up-for-service.md#setting-up-vcontrol) y una [función de servicio de AWS Proton canalización](ag-setting-up-iam.md#setting-up-cicd). Para obtener más información, consulta [La referencia de la API de AWS Proton servicio](https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html). **Ejemplo: introducción al flujo de trabajo** 1. Consulte el diagrama [Cómo AWS Proton funciona](ag-works.md) para obtener una vista general de AWS Proton las entradas y salidas. 1. [Cree un paquete de entorno y un paquete de plantillas de servicio](ag-template-authoring.md#ag-template-bundles). 1. Identifique los [parámetros de entrada](parameters.md). 1. Cree un [archivo de esquema](ag-schema.md). 1. Cree [archivos de Infraestructura como código (IaC)](ag-infrastructure-tmp-files.md). 1. Para [completar el paquete de plantillas](ag-wrap-up.md), cree un archivo de manifiesto y organice los archivos de IaC, los archivos de manifiesto y el archivo de esquema en directorios. 1. Haga que su [paquete de plantillas](ag-wrap-up.md) sea accesible para AWS Proton. 1. [Cree y registre una versión de plantilla de entorno](template-create.md) con AWS Proton. Al utilizar la consola para crear y registrar una plantilla, se crea automáticamente una versión de la plantilla. Cuando utilice el AWS CLI para crear y registrar una plantilla: 1. Cree una plantilla de entorno. 1. Cree una versión de plantilla de entorno. Para obtener más información, consulta [CreateEnvironmentTemplate](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateEnvironmentTemplate.html)y [CreateEnvironmentTemplateVersion](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateEnvironmentTemplateVersion.html)en la *referencia de la AWS Proton API*. 1. [Publique la plantilla de entorno](template-update.md) para que esté disponible para su uso. Para obtener más información, consulta [UpdateEnvironmentTemplateVersion](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateEnvironmentTemplateVersion.html)la *referencia de la AWS Proton API*. 1. Para [crear un entorno](ag-create-env.md), seleccione una versión de plantilla de entorno publicada y proporcione los valores de las entradas necesarias. Para obtener más información, consulta [CreateEnvironment](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateEnvironment.html)la *referencia de la AWS Proton API*. 1. [Cree y registre una versión de plantilla de servicio](template-create.md) con AWS Proton. Al utilizar la consola para crear y registrar una plantilla, se crea automáticamente una versión de la plantilla. Cuando utilice el AWS CLI para crear y registrar una plantilla: 1. Cree una plantilla de servicio. 1. Cree una versión de plantilla de servicio. Para obtener más información, consulta [CreateServiceTemplate](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateServiceTemplate.html)y [CreateServiceTemplateVersion](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateServiceTemplateVersion.html)en la *referencia de la AWS Proton API*. 1. [Publique la plantilla de servicio](template-update.md) para que esté disponible para su uso. Para obtener más información, consulta [UpdateServiceTemplateVersion](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateServiceTemplateVersion.html)la *referencia de la AWS Proton API*. 1. Para [crear un servicio](ag-create-svc.md), seleccione una versión de plantilla de servicio publicada y proporcione los valores de las entradas necesarias. Para obtener más información, consulta [CreateService](https://docs.aws.amazon.com/proton/latest/APIReference/API_CreateService.html)la *referencia de la AWS Proton API*. # Cómo empezar con el Consola de administración de AWS Introducción a la consola de **Comience con AWS Proton** + Cree y visualice una plantilla de entorno. + Cree, visualice y publique una plantilla de servicio que utilice la plantilla de entorno que acaba de crear. + Cree un entorno y un servicio (opcional). + Elimine la plantilla de servicio, la plantilla de entorno, el entorno y el servicio, si se crearon. ## Paso 1: Abre la AWS Proton consola + Abra la [consola de AWS Proton](https://console.aws.amazon.com//proton/). ## Paso 2: Prepararse para utilizar las plantillas de ejemplo 1. Cree una conexión de Codestar a Github y asigne un nombre a la conexión. my-proton-connection 1. Vaya a [https://github.com/aws-samples/aws-proton-cloudformation-sample-templates](https://github.com/aws-samples/aws-proton-cloudformation-sample-templates) 1. Cree una bifurcación del repositorio en su cuenta de Github. ## Paso 3: Crear una plantilla de entorno En el panel de navegación, elija **Plantillas de entorno**. 1. En la página **Plantillas de entorno**, seleccione **Crear plantilla de entorno**. 1. En la página **Crear plantilla de entorno**, en la sección **Opciones de plantilla**, seleccione **Crear una plantilla para aprovisionar nuevos entornos**. 1. En la sección **Origen del paquete de plantillas**, seleccione **Sincronización de un paquete de plantillas desde Git**. 1. En la sección **Repositorio de definiciones de plantillas**, seleccione **Elegir un repositorio de Git vinculado**. 1. Selecciona una opción **my-proton-connection**de la lista de **repositorios**. 1. Seleccione **main** en la **Lista de ramificaciones**. 1. En la sección de **Detalles de la plantilla del entorno de Proton**. 1. Introduzca el nombre de la plantilla como **fargate-env**. 1. Introduzca el nombre para mostrar de la plantilla de entorno como **My Fargate Environment**. 1. (Opcional) Escriba una descripción para la plantilla de entorno. 1. (Opcional) En la sección **Etiquetas**, seleccione **Agregar etiqueta** e introduzca una clave y un valor para crear una etiqueta administrada por el cliente. 1. Seleccione **Crear plantilla de entorno**. Ahora aparecerá una nueva página que muestra el estado y los detalles de su nueva plantilla de entorno. Estos detalles incluyen una lista de etiquetas administradas por el cliente AWS y otras etiquetas. AWS Proton genera automáticamente etiquetas AWS administradas cuando crea AWS Proton recursos. Para obtener más información, consulte [AWS Proton recursos y etiquetado](resources.md). 1. El estado de una nueva plantilla de entorno comienza en el estado **Borrador**. Usted y las personas que gocen de permisos `proton:CreateEnvironment` podrán verla y acceder a ella. Siga el siguiente paso para poner la plantilla a disposición de otras personas. 1. En la sección **Versiones de la plantilla**, seleccione el botón de radio situado a la izquierda de la versión secundaria de la plantilla que acaba de crear (1.0). Como alternativa, puede elegir **Publicar** en el banner de alerta de información y omitir el paso siguiente. 1. En la sección **Versiones de la plantilla**, seleccione **Publicar**. 1. El estado de la plantilla cambiará a **Publicado**. Como esta es la versión más reciente de la plantilla, pasará a ser la versión **Recomendada**. 1. En el panel de navegación, seleccione **Plantillas de entorno**. Una nueva página mostrará una lista de las plantillas de entorno del usuario junto con los detalles de cada plantilla. ## Paso 4: Crear una plantilla de servicio **Cree una plantilla de servicio.** 1. En el panel de navegación, elija **Plantillas de servicio**. 1. En la página **Plantillas de servicio**, elija **Crear plantilla de servicio**. 1. En la página **Crear plantilla de servicio**, en la sección **Origen del paquete de plantillas**, seleccione **Sincronización de un paquete de plantillas desde Git**. 1. En la sección **Plantilla**, seleccione **Elegir un repositorio de Git vinculado**. 1. Seleccione una opción **my-proton-connection**de la **lista de repositorios**. 1. Seleccione **main** en la **Lista de ramificaciones**. 1. En la sección de **Detalles de la plantilla de servicio de Proton**. 1. Introduzca el nombre de la plantilla de servicio como **backend-fargate-svc**. 1. Introduzca el nombre para mostrar de la plantilla de servicio como **My Fargate Service**. 1. (Opcional) Escriba una descripción para la plantilla de servicio. 1. En la sección **Plantillas de entorno compatibles**. 1. Marque la casilla de verificación situada a la izquierda de la plantilla de entorno **My Fargate Environment** para seleccionar la plantilla de entorno compatible para la nueva plantilla de servicio. 1. En **Configuración de cifrado**, utilice la configuración predeterminada. 1. En la sección **Definición de la canalización**. 1. Mantenga seleccionado el botón **Esta plantilla incluye una CI/CD canalización**. 1. Elija **Crear plantilla de servicio**. Ahora estás en una nueva página que muestra el estado y los detalles de tu nueva plantilla de servicio, incluida una lista de etiquetas gestionadas por el cliente AWS y las etiquetas gestionadas por los clientes. 1. El estado inicial de una nueva plantilla de servicio será el estado **Borrador**. Solo los administradores pueden ver la plantilla y acceder a ella. Para que la plantilla de servicio esté disponible para que la utilicen los desarrolladores, siga el siguiente paso. 1. En la sección **Versiones de la plantilla**, seleccione el botón de radio situado a la izquierda de la versión secundaria de la plantilla que acaba de crear (1.0). Como alternativa, puede elegir **Publicar** en el banner de alerta de información y omitir el paso siguiente. 1. En la sección **Versiones de la plantilla**, seleccione **Publicar**. 1. El estado de la plantilla cambiará a **Publicado**. La primera versión secundaria de la plantilla de servicio está publicada y disponible para que la utilicen los desarrolladores. Como esta es la versión más reciente de la plantilla, pasará a ser la versión **Recomendada**. 1. En el panel de navegación, elija **Plantillas de servicio**. Una nueva página muestra una lista de las plantillas de servicio del usuario y los detalles de cada una de ellas. ## Paso 5: Crear un entorno En el panel de navegación, elija **Entornos**. 1. Seleccione **Creación de entorno**. 1. En la página **Elegir una plantilla de entorno**, seleccione la plantilla que acaba de crear. Se llama **My Fargate Environment**. A continuación, seleccione **Configurar**. 1. En la página **Configurar entorno**, en la sección **Aprovisionamiento**, seleccione **Aprovisionar mediante AWS Proton**. 1. En la sección **Cuenta de implementación**, seleccione **Esta Cuenta de AWS**. 1. En **Configuración del entorno**, introduzca el nombre del entorno como **my-fargate-environment**. 1. En la sección **Funciones de entorno**, selecciona **Nueva función de servicio** o, si ya has creado una función de AWS Proton servicio, selecciona **Función de servicio existente**. 1. Seleccione **Nuevo rol de servicio** para crear un nuevo rol. 1. Introduzca el **Nombre del rol de entorno** como **MyProtonServiceRole**. 1. Marque la casilla de verificación para aceptar la creación de un rol de AWS Proton servicio con privilegios administrativos para su cuenta. 1. Seleccione un **Rol de servicio existente** para utilizar un rol existente. 1. Seleccione el rol en el campo desplegable **Nombre del rol de entorno**. 1. Elija **Siguiente**. 1. En la página **Configurar ajustes personalizados**, utilice los valores predeterminados. 1. Seleccione **Siguiente** y revise las entradas. 1. Seleccione **Crear**. Vea los detalles y el estado del entorno, así como las etiquetas AWS administradas y las etiquetas administradas por el cliente para su entorno. 1. En el panel de navegación, elija **Entornos**. Una nueva página mostrará una lista de sus entornos junto con el estado y otros detalles del entorno. ## Paso 6: (Opcional) Crear un servicio e implementar una aplicación 1. Abra la [consola de AWS Proton](https://console.aws.amazon.com//proton/). 1. En el panel de navegación, elija **Servicios**. 1. En la página **Servicios**, seleccione **Crear servicio**. 1. En la página **Elegir una plantilla de servicio**, seleccione la plantilla **My Fargate Service**; para ello, pulse el botón de radio situado en la esquina superior derecha de la tarjeta de plantilla. 1. Seleccione **Configurar** en la esquina inferior derecha de la página. 1. En la página **Configurar servicio**, en la sección **Configuración del servicio**, introduzca el nombre del servicio **my-service**. 1. (Opcional) Escriba una descripción para el servicio. 1. **En la sección **Configuración del repositorio de servicios**:** 1. Para **CodeStar conectarse**, elija su conexión de la lista. 1. En **Nombre del repositorio**, elija de la lista el nombre del repositorio del código fuente. 1. En **Nombre de la ramificación**, elija de la lista el nombre de la ramificación del repositorio de código fuente. 1. (Opcional) En la sección **Etiquetas**, seleccione **Agregar etiqueta** e introduzca una clave y un valor para crear una etiqueta administrada por el cliente. A continuación, elija **Siguiente**. 1. En la página **Configurar ajustes personalizados**, en la sección **Instancias de servicio**, en la sección **Nueva instancia**, siga los pasos siguientes para proporcionar valores personalizados para los parámetros de la instancia de servicio. 1. Introduzca el nombre de la instancia **my-app-service**. 1. Elija el entorno **my-fargate-environment** para la instancia de servicio. 1. Mantenga los valores predeterminados para el resto de parámetros de la instancia. 1. Mantenga los valores predeterminados para las **entradas de la canalización**. 1. Seleccione **Siguiente** y revise las entradas. 1. Seleccione **Crear** y consulte el estado y los detalles del servicio. 1. En la página de detalles del servicio, seleccione las pestañas **Información general** y **Canalización** para ver el estado de la instancia de servicio y de la canalización. En estas páginas también puedes ver AWS las etiquetas gestionadas por los clientes. AWS Proton crea automáticamente etiquetas AWS gestionadas para usted. Elija **Administrar etiquetas** para crear y modificar las etiquetas administradas por el cliente. Para obtener más información acerca del etiquetado, consulte [AWS Proton recursos y etiquetado](resources.md). 1. Cuando el servicio esté **activo**, en la pestaña **Descripción general**, en la sección **Instancias de servicio**, elija el nombre de la instancia de servicio **my-app-service**. Ahora se encuentra en la página de detalles de la instancia de servicio. 1. Para ver su aplicación, en la **sección Resultados**, copie el **ServiceEndpoint**enlace en su navegador. Verá un AWS Proton gráfico en la página web. 1. Una vez creado el servicio, en el panel de navegación, elija **Servicios** para ver una lista de sus servicios. ## Paso 7: Limpiar. 1. Abra la [consola de AWS Proton](https://console.aws.amazon.com//proton/). 1. **Eliminación de un servicio (si se creó alguno)** 1. En el panel de navegación, elija **Servicios**. 1. En la página **Servicios**, elija como nombre del servicio **my-service**. Ahora se encuentra en la página de detalles del servicio de **my-service**. 1. En la esquina superior derecha de la página, seleccione **Acciones** y, a continuación, **Eliminar**. 1. Un modal le pedirá que confirme la acción de eliminación. 1. Siga las instrucciones y seleccione **Sí, eliminar**. 1. **Eliminación de un entorno** 1. En el panel de navegación, elija **Entornos**. 1. En la página **Entornos**, seleccione el botón de radio a la izquierda del entorno recién creado. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. 1. Un modal le pedirá que confirme la acción de eliminación. 1. Siga las instrucciones y seleccione **Sí, eliminar**. 1. **Eliminación de una plantilla de servicio** 1. En el panel de navegación, elija **Plantillas de servicio**. 1. En la página **de plantillas de servicio**, seleccione el botón de radio situado a la izquierda de la plantilla de servicio **my-svc-template**. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. 1. Un modal le pedirá que confirme la acción de eliminación. 1. Siga las instrucciones y seleccione **Sí, eliminar**. Esto elimina la plantilla de servicio y todas sus versiones. 1. **Eliminación de una plantilla de entorno** 1. En el panel de navegación, elija **Plantillas de entorno**. 1. En la página de **plantillas de entorno**, seleccione el botón de radio situado a la izquierda de **my-env-template**. 1. Elija **Acciones** y, a continuación, elija **Eliminar**. 1. Un modal le pedirá que confirme la acción de eliminación. 1. Siga las instrucciones y seleccione **Sí, eliminar**. Esto elimina la plantilla de entorno y todas sus versiones. 1. **Eliminación de la conexión de CodeStar** # Empezando con el AWS CLI Introducción a la CLI Para empezar a AWS Proton utilizar el AWS CLI, sigue este tutorial. El tutorial muestra un AWS Proton servicio de equilibrio de carga orientado al público basado en. AWS Fargate El tutorial también proporciona una CI/CD canalización que despliega un sitio web estático con una imagen mostrada. Antes de empezar, el usuario debe asegurarse de que esté configurado correctamente. Para obtener más información, consulte [Requisitos previos](getting-started-prerequisites.md). ## Paso 1: Registrar una plantilla de entorno 1. Registro de una plantilla de entorno En este paso, como administrador, registrará una plantilla de entorno de ejemplo, que contiene un clúster de Amazon Elastic Container Service (Amazon ECS) y una Amazon Virtual Private Cloud (Amazon VPC) con dos subredes. public/private **Para registrar una plantilla de entorno** 1. Incorpore el repositorio [AWS Proton de CloudFormation plantillas de muestra](https://github.com/aws-samples/aws-proton-cloudformation-sample-templates/) a su GitHub cuenta u organización. Este repositorio incluye las plantillas de entorno y de servicio que utilizaremos en este tutorial. A continuación, registre su repositorio bifurcado en. AWS Proton Para obtener más información, consulte [Creación de un enlace para el repositorio del usuario](ag-create-repo.md). 1. Cree una plantilla de entorno. El recurso de la plantilla de entorno realiza un seguimiento de las versiones de la plantilla de entorno. ``` $ aws proton create-environment-template \ --name "fargate-env" \ --display-name "Public VPC Fargate" \ --description "VPC with public access and ECS cluster" ``` 1. Cree una configuración de sincronización de plantillas. AWS Proton establece una relación de sincronización entre el repositorio y la plantilla de entorno. A continuación, crea la versión 1.0 de la plantilla en estado `DRAFT`. ``` $ aws proton create-template-sync-config \ --template-name "fargate-env" \ --template-type "ENVIRONMENT" \ --repository-name "your-forked-repo" \ --repository-provider "GITHUB" \ --branch "your-branch" \ --subdirectory "environment-templates/fargate-env" ``` 1. Espere a que la versión de la plantilla de entorno se registre correctamente. Cuando se devuelva este comando con un estado de salida de `0`, se habrá completado el registro de la versión. Esto resulta útil en los scripts para garantizar que se pueda ejecutar correctamente el comando en el siguiente paso. ``` $ aws proton wait environment-template-version-registered \ --template-name "fargate-env" \ --major-version "1" \ --minor-version "0" ``` 1. Publique la versión de la plantilla de entorno para que esté disponible para la creación del entorno. ``` $ aws proton update-environment-template-version \ --template-name "fargate-env" \ --major-version "1" \ --minor-version "0" \ --status "PUBLISHED" ``` ## Paso 2: Registrar una plantilla de servicio 2. Registro de una plantilla de servicio En este paso, como administrador, registra una plantilla de servicio de ejemplo, que contiene todos los recursos necesarios para aprovisionar un servicio Fargate de Amazon ECS detrás de un balanceador de carga y una CI/CD canalización que utilice. AWS CodePipeline **Para registrar una plantilla de servicio** 1. Cree una plantilla de servicio. El recurso de la plantilla de servicio realiza un seguimiento de las versiones de la plantilla de servicio. ``` $ aws proton create-service-template \ --name "load-balanced-fargate-svc" \ --display-name "Load balanced Fargate service" \ --description "Fargate service with an application load balancer" ``` 1. Cree una configuración de sincronización de plantillas. AWS Proton establece una relación de sincronización entre el repositorio y la plantilla de servicio. A continuación, crea la versión 1.0 de la plantilla en estado `DRAFT`. ``` $ aws proton create-template-sync-config \ --template-name "load-balanced-fargate-svc" \ --template-type "SERVICE" \ --repository-name "your-forked-repo" \ --repository-provider "GITHUB" \ --branch "your-branch" \ --subdirectory "service-templates/load-balanced-fargate-svc" ``` 1. Espere a que la versión de la plantilla de servicio se registre correctamente. Cuando se devuelva este comando con un estado de salida de `0`, se habrá completado el registro de la versión. Esto resulta útil en los scripts para garantizar que se pueda ejecutar correctamente el comando en el siguiente paso. ``` $ aws proton wait service-template-version-registered \ --template-name "load-balanced-fargate-svc" \ --major-version "1" \ --minor-version "0" ``` 1. Publique la versión de la plantilla de servicio para que esté disponible para la creación del servicio. ``` $ aws proton update-service-template-version \ --template-name "load-balanced-fargate-svc" \ --major-version "1" \ --minor-version "0" \ --status "PUBLISHED" ``` ## Paso 3: Implementar un entorno 3. Implementación de un entorno En este paso, como administrador, crea una instancia de un AWS Proton entorno a partir de la plantilla de entorno. **Para implementar un entorno** 1. Obtenga un archivo de especificaciones de ejemplo para la plantilla de entorno que ha registrado. Puede descargar el archivo `environment-templates/fargate-env/spec/spec.yaml` desde el repositorio de ejemplos de plantillas. Como alternativa, puede obtener todo el repositorio de forma local y ejecutar el comando **create-environment** desde el directorio `environment-templates/fargate-env`. 1. Creación de un entorno. AWS Proton lee los valores de entrada de las especificaciones de su entorno, los combina con la plantilla de entorno y aprovisiona los recursos del entorno en su AWS cuenta mediante su AWS Proton función de servicio. ``` $ aws proton create-environment \ --name "fargate-env-prod" \ --template-name "fargate-env" \ --template-major-version 1 \ --proton-service-role-arn "arn:aws:iam::123456789012:role/AWS ProtonServiceRole" \ --spec "file://spec/spec.yaml" ``` 1. Espere a que el entorno se implemente correctamente. ``` $ aws proton wait environment-deployed --name "fargate-env-prod" ``` ## Paso 4: Implementar un servicio [desarrollador de aplicaciones] 4. Implementación de un servicio En los pasos anteriores, un administrador registró y publicó una plantilla de servicio e implementó un entorno. Como desarrollador de aplicaciones, ahora puede crear un AWS Proton servicio e implementarlo en el entorno AWS Proton **Para implementar un servicio** 1. Obtenga un archivo de especificaciones de ejemplo para la plantilla de servicio que registró el administrador. Puede descargar el archivo `service-templates/load-balanced-fargate-svc/spec/spec.yaml` desde el repositorio de ejemplos de plantillas. Como alternativa, puede obtener todo el repositorio de forma local y ejecutar el comando **create-service** desde el directorio `service-templates/load-balanced-fargate-svc`. 1. Incorpore el repositorio de [AWS Proton Sample Services](https://github.com/aws-samples/aws-proton-sample-services/) a su GitHub cuenta u organización. Este repositorio incluye el código fuente de la aplicación que utilizamos en este tutorial. 1. Cree un servicio. AWS Proton lee los valores de entrada de la especificación de servicio, los combina con la plantilla de servicio y aprovisiona los recursos de servicio de su AWS cuenta en el entorno especificado en la especificación. Una AWS CodePipeline canalización despliega el código de la aplicación desde el repositorio que especifique en el comando. ``` $ aws proton create-service \ --name "static-website" \ --repository-connection-arn \ "arn:aws:codestar-connections:us-east-1:123456789012:connection/your-codestar-connection-id" \ --repository-id "your-GitHub-account/aws-proton-sample-services" \ --branch-name "main" \ --template-major-version 1 \ --template-name "load-balanced-fargate-svc" \ --spec "file://spec/spec.yaml" ``` 1. Espere a que el servicio se implemente correctamente. ``` $ aws proton wait service-created --name "static-website" ``` 1. Recupere las salidas y consulte el nuevo sitio web. Use el siguiente comando: ``` $ aws proton list-service-instance-outputs \ --service-name "static-website" \ --service-instance-name load-balanced-fargate-svc-prod ``` La salida del comando debería ser similar a la siguiente: ``` { "outputs": [ { "key": "ServiceURL", "valueString": "http://your-service-endpoint.us-east-1.elb.amazonaws.com" } ] } ``` El valor de la salida de la instancia `ServiceURL` es el punto de conexión del nuevo sitio web del servicio. Utilice el navegador para navegar hasta él. Debería ver el siguiente gráfico en una página estática: ![\[Un navegador web que muestre el sitio de imágenes estáticas resultante del procedimiento inicial de la CLI\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/getting-started-static-site.png) ## Paso 5: Limpieza (opcional) 5. Limpieza En este paso, cuando haya terminado de explorar los AWS recursos que creó como parte de este tutorial y, para ahorrar en los costos asociados a estos recursos, los eliminará. **Para eliminar los recursos del tutorial** 1. Para eliminar el servicio, ejecute el comando siguiente: ``` $ aws proton delete-service --name "static-website" ``` 1. Para eliminar el entorno, ejecute el siguiente comando: ``` $ aws proton delete-environment --name "fargate-env-prod" ``` 1. Para eliminar la plantilla de servicio, ejecute los siguientes comandos: ``` $ aws proton delete-template-sync-config \ --template-name "load-balanced-fargate-svc" \ --template-type "SERVICE" $ aws proton delete-service-template --name "load-balanced-fargate-svc" ``` 1. Para eliminar la plantilla de entorno, ejecute los siguientes comandos: ``` $ aws proton delete-template-sync-config \ --template-name "fargate-env" \ --template-type "ENVIRONMENT" $ aws proton delete-environment-template --name "fargate-env" ``` # La biblioteca AWS Proton de plantillas Biblioteca de plantillas El AWS Proton equipo mantiene una biblioteca de ejemplos de plantillas en GitHub. La biblioteca incluye ejemplos de archivos de infraestructura como código (IaC) para muchos escenarios comunes de infraestructura de aplicaciones y entornos. La biblioteca de plantillas se almacena en dos GitHub repositorios: + [aws-proton-cloudformation-sample-templates](https://github.com/aws-samples/aws-proton-cloudformation-sample-templates/): ejemplos de paquetes de plantillas que utilizan Jinja como *AWS CloudFormation*lenguaje IaC. Puede utilizar estos ejemplos para entornos [AWS-aprovisionamiento gestionado](ag-works-prov-methods.md#ag-works-prov-methods-direct). + [aws-proton-terraform-sample-templates](https://github.com/aws-samples/aws-proton-terraform-sample-templates/)*: ejemplos de paquetes de plantillas que utilizan Terraform como lenguaje IaC.* Puede utilizar estos ejemplos para entornos [Aprovisionamiento autoadministrado](ag-works-prov-methods.md#ag-works-prov-methods-self). Cada uno de estos repositorios tiene un archivo `README` con información completa sobre el contenido y la estructura del repositorio. Cada ejemplo contiene información sobre el caso de uso que cubre la plantilla, la arquitectura del ejemplo y los parámetros de entrada que utiliza la plantilla. Puedes usar las plantillas de esta biblioteca directamente bifurcando uno de los repositorios de la biblioteca en tu cuenta. GitHub Como alternativa, utilice estos ejemplos como punto de partida para desarrollar sus plantillas de entorno y servicio.