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. # Cómo AWS Proton funciona Con ello AWS Proton, aprovisiona *entornos* y, posteriormente, *servicios* que se ejecutan en esos entornos. Los entornos y los servicios se basan en las *plantillas* de entorno y servicio, respectivamente, que usted elige en su biblioteca de plantillas AWS Proton versionadas. ![\[Diagrama que describe el proceso de creación de un paquete de plantillas para un conjunto de recursos de AWS Proton infraestructura.\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/works.png) ![\[Red circle with the number 1 inside, typically used as a notification icon.\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/label-one.png)Cuando, como administrador, selecciona una plantilla de entorno con AWS Proton, proporciona valores para los *parámetros de entrada* necesarios. ![\[Number 2 icon in a pink circle.\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/label-two.png) AWS Proton utiliza la plantilla de entorno y los valores de los parámetros para aprovisionar el entorno. ![\[Pink square icon with a white exclamation mark inside a circle.\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/label-three.png)Cuando usted, como desarrollador o administrador, selecciona una plantilla de servicio con AWS Proton, proporciona valores para los parámetros de entrada necesarios. También selecciona un entorno en el que implementar la aplicación o el servicio. ![\[Number 4 in a red circle icon, commonly used to indicate a notification count.\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/label-four.png) AWS Proton utiliza la plantilla de servicio y los valores de los parámetros del servicio y del entorno seleccionado para aprovisionar el servicio. Debe proporcionar valores para los parámetros de entrada a fin de personalizar la plantilla para su reutilización y para varios casos de uso, aplicaciones o servicios. Para que esto funcione, debe crear paquetes de plantillas de entorno o servicio y cargarlos en plantillas de entorno o servicio registradas, respectivamente. [Los paquetes de plantillas](ag-template-authoring.md#ag-template-bundles) contienen todo lo AWS Proton necesario para aprovisionar entornos o servicios. Al crear una plantilla de entorno o servicio, se carga un paquete de plantillas que contiene los archivos parametrizados de infraestructura en código (IaC) que se AWS Proton utilizan para aprovisionar entornos o servicios. Al seleccionar una plantilla de entorno o servicio para crear o actualizar un entorno o servicio, proporciona valores para los parámetros del archivo IaC del paquete de plantillas. **Topics** + [AWS Proton objetos](ag-works-objects.md) + [¿Cómo AWS Proton aprovisiona la infraestructura](ag-works-prov-methods.md) + [AWS Proton terminología](terminology.md) # AWS Proton objetos El siguiente diagrama muestra los AWS Proton objetos principales y su relación con otros objetos AWS y con los de terceros. Las flechas representan la dirección del flujo de datos (la dirección inversa de la dependencia). Seguimos el diagrama con breves descripciones y enlaces de referencia para estos AWS Proton objetos. ![\[Diagrama que ilustra el aprovisionamiento AWS gestionado en AWS Proton\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/object-diagram.png) + **Plantilla de entorno**: colección de versiones de plantillas de entorno que se pueden utilizar para crear entornos. AWS Proton Para obtener más información, consulte [Creación y paquetes de plantillas](ag-template-authoring.md) y [AWS Proton plantillas](ag-templates.md). + **Versión de plantilla de entorno**: versión específica de una plantilla de entorno. Toma un *paquete de plantillas* como entrada, ya sea desde un bucket de S3 o desde un repositorio de Git. El paquete especifica la infraestructura como código (IaC) y los parámetros de entrada relacionados para un AWS Proton entorno. Para obtener más información, consulte [Plantillas versionadas](ag-template-versions.md), [Registro y publicación de plantillas](template-create.md) y [Configuraciones de sincronización de plantillas](ag-template-sync-configs.md). + **Entorno**: conjunto de políticas de acceso y recursos de AWS infraestructura compartidos en los que se implementan los AWS Proton servicios. AWS los recursos se aprovisionan mediante una versión de plantilla de entorno que se invoca con valores de parámetros específicos. Las políticas de acceso se proporcionan en una función de servicio. Para obtener más información, consulte [AWS Proton entornos](ag-environments.md). + **Plantilla de servicio**: conjunto de versiones de plantillas de servicio que se pueden utilizar para crear AWS Proton servicios. Para obtener más información, consulte [Creación y paquetes de plantillas](ag-template-authoring.md) y [AWS Proton plantillas](ag-templates.md). + **Versión de plantilla de servicio**: versión específica de una plantilla de servicio. Toma un *paquete de plantillas* como entrada, ya sea desde un bucket de S3 o desde un repositorio de Git. El paquete especifica la infraestructura como código (IaC) y los parámetros de entrada relacionados para un AWS Proton servicio. Una versión de plantilla de servicio también especifica estas restricciones en las instancias de servicio en función de la versión: + **Plantillas de entorno compatibles**: las instancias solo se pueden ejecutar en entornos basados en estas plantillas de entorno compatibles. + **Fuentes de componentes compatibles**: los tipos de componentes que los desarrolladores pueden asociar a las instancias. Para obtener más información, consulte [Plantillas versionadas](ag-template-versions.md), [Registro y publicación de plantillas](template-create.md) y [Configuraciones de sincronización de plantillas](ag-template-sync-configs.md). + **Servicio**: conjunto de instancias de servicio que ejecutan una aplicación utilizando los recursos especificados en una plantilla de servicio y, opcionalmente, una CI/CD canalización que despliega el código de la aplicación en estas instancias. En el diagrama, la línea discontinua de la **plantilla de servicio** significa que el servicio pasa la plantilla a las instancias de servicio y a la canalización. Para obtener más información, consulte [AWS Proton servicios](ag-services.md). + **Instancia de servicio**: conjunto de recursos de AWS infraestructura que ejecutan una aplicación en un AWS Proton entorno específico. AWS los recursos se aprovisionan mediante una versión de plantilla de servicio que se invoca con valores de parámetros específicos. Para obtener más información, consulte [AWS Proton servicios](ag-services.md) y [Actualización de una instancia de servicio](ag-svc-instance-update.md). + **Canalización**: CI/CD canalización opcional que despliega una aplicación en las instancias de un servicio, con políticas de acceso para aprovisionar esta canalización. Las políticas de acceso se proporcionan en una función de servicio. Un servicio no siempre tiene una AWS Proton canalización asociada; puedes optar por gestionar las implementaciones de código de tu aplicación fuera de ella. AWS Proton En el diagrama, la línea discontinua que corresponde a **Service** y el recuadro discontinuo que rodea a **Pipeline** significan que si decides gestionar las CI/CD implementaciones tú mismo, es posible que no se cree la AWS Proton canalización y que la tuya propia no esté en tu cuenta. AWS Para obtener más información, consulte [AWS Proton servicios](ag-services.md) y [Actualización de una canalización de servicios](ag-svc-pipeline-update.md). + **Componente**: una extensión de una instancia de servicio definida por el desarrollador. Especifica los recursos de AWS infraestructura adicionales que una aplicación concreta podría necesitar, además de los recursos proporcionados por el entorno y la instancia de servicio. Los equipos de plataforma controlan la infraestructura que un componente puede aprovisionar al asignar una función de componente al entorno. Para obtener más información, consulte [AWS Proton componentes](ag-components.md). # ¿Cómo AWS Proton aprovisiona la infraestructura AWS Proton puede aprovisionar la infraestructura de varias maneras: + **AWS-aprovisionamiento gestionado**: AWS Proton llama al motor de aprovisionamiento en su nombre. Este método solo AWS CloudFormation admite paquetes de plantillas. Para obtener más información, consulte [CloudFormation Archivos iAC](ag-infrastructure-tmp-files-cloudformation.md). + **CodeBuild aprovisionamiento**: se AWS Proton utiliza AWS CodeBuild para ejecutar los comandos de shell que usted proporciona. Tus comandos pueden leer las entradas que AWS Proton proporcionan, y son responsables de aprovisionar o desaprovisionar la infraestructura y generar valores de salida. Un paquete de plantillas para este método incluye los comandos en un archivo de manifiesto y todos los programas, scripts u otros archivos que estos comandos puedan necesitar. Como ejemplo del uso del CodeBuild aprovisionamiento, puedes incluir un código que lo utilice AWS Cloud Development Kit (AWS CDK) para aprovisionar AWS recursos y un manifiesto que instale la CDK y ejecute el código de la CDK. Para obtener más información, consulte [CodeBuild paquete de plantillas de aprovisionamiento](ag-infrastructure-tmp-files-codebuild.md). **nota** Puede utilizar el CodeBuild aprovisionamiento con entornos y servicios. En este momento, no puede aprovisionar componentes de esta forma. + **Aprovisionamiento autogestionado**: AWS Proton envía una solicitud de cambios (PR) a un repositorio que tú proporciones, donde tu propio sistema de despliegue de infraestructuras ejecuta el proceso de aprovisionamiento. Este método solo admite paquetes de plantillas de Terraform. Para obtener más información, consulte [Archivos iAC de Terraform](ag-infrastructure-tmp-files-terraform.md). AWS Proton determina y establece el método de aprovisionamiento para cada entorno y servicio por separado. Al crear o actualizar un entorno o un servicio, AWS Proton examina el paquete de plantillas que proporciona y determina el método de aprovisionamiento que indica el paquete de plantillas. A nivel del entorno, usted proporciona los parámetros que el entorno y sus posibles servicios podrían necesitar para sus métodos de aprovisionamiento: funciones de AWS Identity and Access Management IAM, una conexión de cuentas de entorno o un repositorio de infraestructura. Los desarrolladores que suelen AWS Proton aprovisionar un servicio tienen la misma experiencia independientemente del método de aprovisionamiento. Los desarrolladores no necesitan conocer el método de aprovisionamiento ni tienen que cambiar nada en el proceso de aprovisionamiento del servicio. La plantilla de servicio establece el método de aprovisionamiento y cada entorno en el que un desarrollador implementa el servicio proporciona los parámetros necesarios para el aprovisionamiento de las instancias de servicio. En el siguiente diagrama, se resumen algunas de las características principales de los distintos métodos de aprovisionamiento. En las secciones que siguen a la tabla se proporcionan detalles sobre cada método. | Método de aprovisionamiento | Plantillas | Aprovisionado por | Estado rastreado por | | --- | --- | --- | --- | | Administradas por AWS | manifiesto, esquema, archivo IAC () CloudFormation | AWS Proton (a través de CloudFormation) | AWS Proton (a través CloudFormation) | | CodeBuild | manifiesto (con comandos), esquema, dependencias de comandos (por ejemplo, AWS CDK código) | AWS Proton (a través de CodeBuild) | AWS Proton (sus comandos devuelven el estado a través de CodeBuild) | | autoadministrado | manifiesto, esquema, archivos IaC (Terraform) | Tu código (a través de acciones de Git) | Tu código (transferido a AWS través de una llamada a la API) | ## ¿Cómo funciona AWS el aprovisionamiento gestionado Cuando un entorno o un servicio utiliza el aprovisionamiento AWS administrado, la infraestructura se aprovisiona de la siguiente manera: 1. Un AWS Proton cliente (un administrador o un desarrollador) crea el AWS Proton recurso (un entorno o un servicio). El cliente selecciona una plantilla para el recurso y proporciona los parámetros necesarios. Para obtener más información, consulte la siguiente sección,[Consideraciones sobre el aprovisionamiento gestionado AWS](#ag-works-prov-methods-direct-consider). 1. AWS Proton muestra una CloudFormation plantilla completa para el aprovisionamiento del recurso. 1. AWS Proton llama CloudFormation para iniciar el aprovisionamiento mediante la plantilla renderizada. 1. AWS Proton monitorea continuamente el CloudFormation despliegue. 1. Cuando se completa el aprovisionamiento, AWS Proton informa de los errores en caso de error y captura los resultados del aprovisionamiento, como el ID de Amazon VPC, en caso de éxito. En el siguiente diagrama se muestra que AWS Proton se encarga directamente de la mayoría de estos pasos. ![\[Diagrama que ilustra el AWS aprovisionamiento administrado en AWS Proton\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/provisioning-direct.png) ### Consideraciones sobre el aprovisionamiento gestionado AWS + *Función de aprovisionamiento de infraestructura*: cuando un entorno o alguna de las instancias de servicio que se ejecutan en él pueda utilizar el aprovisionamiento AWS administrado, el administrador debe configurar una función de IAM (directamente o como parte de la conexión de una cuenta de entorno). AWS Proton AWS Proton utiliza esta función para aprovisionar la infraestructura de estos AWS recursos de aprovisionamiento gestionados. El rol debe tener permisos para usarlos CloudFormation para crear todos los recursos que incluyen las plantillas de estos recursos. Para obtener más información, consulte [Roles de IAM](ag-environment-roles.md) y [AWS Proton Ejemplos de políticas de funciones de servicio de IAM](security_iam_service-role-policy-examples.md). + *Aprovisionamiento de servicios*: cuando un desarrollador implementa una instancia de servicio que utiliza el aprovisionamiento AWS administrado en el entorno, AWS Proton utiliza la función proporcionada a ese entorno para aprovisionar la infraestructura de la instancia de servicio. Los desarrolladores no ven este rol y no pueden cambiarlo. + *Servicio con canalización*: una plantilla de servicio que utilice el aprovisionamiento AWS administrado puede incluir una definición de canalización escrita en el esquema CloudFormation YAML. AWS Proton también crea la canalización mediante una llamada. CloudFormation La función que se AWS Proton utiliza para crear una canalización es independiente de la función de cada entorno individual. Esta función se proporciona AWS Proton por separado, solo una vez a nivel de AWS cuenta, y se usa para aprovisionar y administrar todas las canalizaciones AWS administradas. Esta función debe tener permisos para crear canalizaciones y otros recursos que tus canalizaciones necesiten. Los siguientes procedimientos muestran cómo proporcionar la función de canalización a. AWS Proton ------ #### [ AWS Proton console ] **Para proporcionar el rol de canalización** 1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), en el panel de navegación, seleccione **Configuración > Configuración de la cuenta** y, a continuación, seleccione **Configurar**. 1. Utilice la sección **Función AWS gestionada por canalización para configurar una función** de canalización nueva o existente para el aprovisionamiento AWS gestionado. ------ #### [ AWS Proton API ] **Para proporcionar el rol de canalización** 1. Usa la acción de la API [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html). 1. Proporcione el nombre de recurso de Amazon (ARN) de su rol de servicio de canalización en el `pipelineServiceRoleArn` parámetro. ------ #### [ AWS CLI ] **Para proporcionar el rol de canalización** Ejecuta el siguiente comando: ``` $ aws proton update-account-settings \ --pipeline-service-role-arn \ "arn:aws:iam::123456789012:role/my-pipeline-role" ``` ------ ## Cómo funciona el CodeBuild aprovisionamiento Cuando un entorno o un servicio utiliza el CodeBuild aprovisionamiento, la infraestructura se aprovisiona de la siguiente manera: 1. Un AWS Proton cliente (un administrador o un desarrollador) crea el AWS Proton recurso (un entorno o un servicio). El cliente selecciona una plantilla para el recurso y proporciona los parámetros necesarios. Para obtener más información, consulte la siguiente sección,[Consideraciones sobre el aprovisionamiento CodeBuild](#ag-works-prov-methods-codebuild-consider). 1. AWS Proton representa un archivo de entrada con valores de parámetros de entrada para aprovisionar el recurso. 1. AWS Proton llamadas CodeBuild para iniciar un trabajo. El CodeBuild trabajo ejecuta los comandos del shell de cliente especificados en la plantilla. Estos comandos proporcionan la infraestructura deseada y, opcionalmente, leen los valores de entrada. 1. Cuando se completa el aprovisionamiento, el comando final del cliente devuelve el estado del aprovisionamiento CodeBuild e invoca la acción de la [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API para proporcionar resultados, como el ID de Amazon VPC, si existe alguno. **importante** Asegúrese de que sus comandos devuelvan correctamente el estado de aprovisionamiento CodeBuild y proporcionen los resultados. Si no lo hacen, no AWS Proton pueden realizar un seguimiento adecuado del estado del aprovisionamiento y no pueden proporcionar los resultados correctos a las instancias de servicio. El siguiente diagrama ilustra los pasos que se llevan a AWS Proton cabo y los pasos que realizan los comandos dentro de un CodeBuild trabajo. ![\[Diagrama que ilustra el aprovisionamiento CodeBuild basado en AWS Proton\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/provisioning-codebuild.png) ### Consideraciones sobre el aprovisionamiento CodeBuild + *Función de aprovisionamiento de infraestructura*: cuando un entorno o alguna de las instancias de servicio que se ejecutan en él pueda utilizar el aprovisionamiento CodeBuild basado, el administrador debe configurar una función de IAM (directamente o como parte de la conexión de una cuenta de AWS Proton entorno). AWS Proton utiliza esta función para aprovisionar la infraestructura de estos CodeBuild recursos de aprovisionamiento. El rol debe tener permisos para usarlos CodeBuild a fin de crear todos los recursos que sus comandos proporcionan en las plantillas de estos recursos. Para obtener más información, consulte [Roles de IAM](ag-environment-roles.md) y [AWS Proton Ejemplos de políticas de funciones de servicio de IAM](security_iam_service-role-policy-examples.md). + *Aprovisionamiento de servicios*: cuando un desarrollador implementa una instancia de servicio que utiliza el CodeBuild aprovisionamiento en el entorno, AWS Proton utiliza la función proporcionada a ese entorno para aprovisionar la infraestructura de la instancia de servicio. Los desarrolladores no ven este rol y no pueden cambiarlo. + *Servicio con canalización*: una plantilla de servicio que utilice el CodeBuild aprovisionamiento puede incluir comandos para aprovisionar una canalización. AWS Proton también crea la canalización mediante una llamada CodeBuild. La función que se AWS Proton utiliza para crear una canalización es independiente de la función de cada entorno individual. Esta función se proporciona AWS Proton por separado, solo una vez a nivel de AWS cuenta, y se usa para aprovisionar y administrar todas las canalizaciones CodeBuild basadas en datos. Esta función debe tener permisos para crear canalizaciones y otros recursos que tus canalizaciones necesiten. Los siguientes procedimientos muestran cómo proporcionar la función de canalización a. AWS Proton ------ #### [ AWS Proton console ] **Para proporcionar el rol de canalización** 1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), en el panel de navegación, seleccione **Configuración > Configuración de la cuenta** y, a continuación, seleccione **Configurar**. 1. Utilice la sección de funciones de **aprovisionamiento de canalizaciones de Codebuild para configurar una función** de aprovisionamiento de canalización nueva o existente. CodeBuild ------ #### [ AWS Proton API ] **Para proporcionar el rol de canalización** 1. Usa la acción de la API [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html). 1. Proporcione el nombre de recurso de Amazon (ARN) de su rol de servicio de canalización en el `pipelineCodebuildRoleArn` parámetro. ------ #### [ AWS CLI ] **Para proporcionar el rol de canalización** Ejecuta el siguiente comando: ``` $ aws proton update-account-settings \ --pipeline-codebuild-role-arn \ "arn:aws:iam::123456789012:role/my-pipeline-role" ``` ------ ## Cómo funciona el aprovisionamiento autogestionado Cuando un entorno se configura para usar el aprovisionamiento autogestionado, la infraestructura se aprovisiona de la siguiente manera: 1. Un AWS Proton cliente (un administrador o un desarrollador) crea el AWS Proton recurso (un entorno o un servicio). El cliente selecciona una plantilla para el recurso y proporciona los parámetros necesarios. Para un entorno, el cliente también proporciona un repositorio de infraestructura vinculado. Para obtener más información, consulte la siguiente sección,[Consideraciones sobre el aprovisionamiento autoadministrado](#ag-works-prov-methods-self-consider). 1. AWS Proton representa una plantilla de Terraform completa. Consta de uno o más archivos de Terraform, posiblemente en varias carpetas, y un `.tfvars` archivo de variables. AWS Proton escribe los valores de los parámetros proporcionados en la llamada de creación del recurso en este archivo de variables. 1. AWS Proton envía un PR al repositorio de infraestructura con la plantilla Terraform renderizada. 1. Cuando el cliente (administrador o desarrollador) fusiona el PR, la automatización del cliente activa el motor de aprovisionamiento para comenzar a aprovisionar la infraestructura mediante la plantilla fusionada. **nota** Si el cliente (administrador o desarrollador) cierra el PR, lo AWS Proton reconoce como cerrado y marca el despliegue como cancelado. 1. Cuando se completa el aprovisionamiento, la automatización del cliente llama a la [NotifyResourceDeploymentStatusChange](https://docs.aws.amazon.com/proton/latest/APIReference/API_NotifyResourceDeploymentStatusChange.html) AWS Proton API a la acción para indicar que se ha completado, proporcionar el estado (correcto o incorrecto) y proporcionar resultados, como el ID de Amazon VPC, si existe alguno. **importante** Asegúrese de que el código de automatización vuelva a llamar AWS Proton con el estado del aprovisionamiento y los resultados. Si no es así, AWS Proton podrías considerar que el aprovisionamiento está pendiente durante más tiempo del debido y seguir mostrando el estado **En curso**. El siguiente diagrama ilustra los pasos que AWS Proton lleva a cabo y los pasos que lleva a cabo su propio sistema de aprovisionamiento. ![\[Diagrama que ilustra el aprovisionamiento autogestionado en AWS Proton\]](http://docs.aws.amazon.com/es_es/proton/latest/userguide/images/provisioning-self.png) ### Consideraciones sobre el aprovisionamiento autoadministrado + *Repositorio de infraestructura*: cuando un administrador configura un entorno para el aprovisionamiento autogestionado, debe proporcionar un repositorio de infraestructura vinculado. AWS Proton se envía PRs a este repositorio para aprovisionar la infraestructura del entorno y todas las instancias de servicio que se implementan en él. La acción de automatización del repositorio propiedad del cliente debe asumir una función de IAM con permisos para crear todos los recursos que incluyen las plantillas de servicio y entorno, y una identidad que refleje la cuenta de destino. AWS Para ver un ejemplo de GitHub acción que asume un rol, consulte [Asumir un rol](https://github.com/aws-actions/configure-aws-credentials#assuming-a-role) en la documentación de *Action for GitHub Actions «Configurar AWS credenciales».* + *Permisos*: el código de aprovisionamiento debe autenticarse con una cuenta según sea necesario (por ejemplo, autenticarse en una AWS cuenta) y proporcionar una autorización de aprovisionamiento de recursos (por ejemplo, proporcionar un rol). + *Aprovisionamiento de servicios*: cuando un desarrollador implementa una instancia de servicio que utiliza el aprovisionamiento autogestionado en el entorno, AWS Proton envía un PR al repositorio asociado al entorno para aprovisionar la infraestructura para la instancia de servicio. Los desarrolladores no verán el repositorio ni podrán cambiarlo. **nota** Los desarrolladores que crean servicios utilizan el mismo proceso independientemente del método de aprovisionamiento, y la diferencia se extrae de ellos. Sin embargo, con el aprovisionamiento autoadministrado, los desarrolladores pueden experimentar una respuesta más lenta, ya que tienen que esperar a que alguien (que podría no ser ellos mismos) fusione la PR en el repositorio de infraestructura para poder iniciar el aprovisionamiento. + *Servicio con canalización*: una plantilla de servicio para un entorno con aprovisionamiento autogestionado puede incluir una definición de canalización (por ejemplo, una AWS CodePipeline canalización) escrita en Terraform HCL. Para poder AWS Proton aprovisionar estas canalizaciones, un administrador proporciona un repositorio de canalizaciones enlazado a. AWS Proton Al aprovisionar una canalización, la acción de automatización propiedad del cliente en el repositorio debe asumir una función de IAM con permisos para aprovisionar la canalización y una identidad que refleje la cuenta de destino. AWS El repositorio y el rol de la canalización son independientes de los que se utilizan para cada entorno individual. El repositorio vinculado se proporciona AWS Proton por separado, solo una vez a nivel de AWS cuenta, y se usa para aprovisionar y administrar todos los canalizaciones. El rol debe tener permisos para crear canalizaciones y otros recursos que las canalizaciones necesiten. Los siguientes procedimientos muestran cómo proporcionar el repositorio y el rol de canalización a AWS Proton. ------ #### [ AWS Proton console ] **Para proporcionar el rol de canalización** 1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), en el panel de navegación, seleccione **Configuración > Configuración de la cuenta** y, a continuación, seleccione **Configurar**. 1. Utilice la sección **Repositorio de canalización de CI/CD** para configurar un enlace de repositorio nuevo o existente. ------ #### [ AWS Proton API ] **Para proporcionar el rol de canalización** 1. Usa la acción de la [UpdateAccountSettings](https://docs.aws.amazon.com/proton/latest/APIReference/API_UpdateAccountSettings.html)API. 1. Proporciona el proveedor, el nombre y la ramificación del repositorio de la canalización en el parámetro `pipelineProvisioningRepository`. ------ #### [ AWS CLI ] **Para proporcionar el rol de canalización** Ejecuta el siguiente comando: ``` $ aws proton update-account-settings \ --pipeline-provisioning-repository \ "provider=GITHUB,name=my-pipeline-repo-name,branch=my-branch" ``` ------ + *Eliminación de los recursos aprovisionados de forma autoadministrada*: los módulos de Terraform pueden incluir elementos de configuración necesarios para el funcionamiento de Terraform, además de definiciones de recursos. Por lo tanto, no se AWS Proton pueden eliminar todos los archivos de Terraform de un entorno o instancia de servicio. En su lugar, AWS Proton marca los archivos para su eliminación y actualiza una marca en los metadatos de PR. La automatización puede leer esa marca y utilizarla para activar un comando de destrucción de Terraform. # AWS Proton terminología **Plantilla de entorno** Define la infraestructura compartida, como una VPC o un clúster, que utilizan varias aplicaciones o recursos. **Paquetes de plantillas de entorno** Un conjunto de archivos que se cargan para crear y registrar una plantilla de entorno en AWS Proton. Un paquete de plantillas de entorno contiene lo siguiente: 1. Un archivo de esquema que define la infraestructura como parámetros de entrada de código. 1. Un archivo de infraestructura como código (IaC) que define la infraestructura compartida, como una VPC o un clúster, que varias aplicaciones o recursos utilizan. 1. Un archivo de manifiesto que incluye el archivo de IaC. **Entorno** Infraestructura compartida aprovisionada, como una VPC o un clúster, que utilizan varias aplicaciones o recursos. **Plantilla de servicio** Define el tipo de infraestructura que se necesita para implementar y mantener una aplicación o un microservicio en un entorno. **Paquete de plantillas de servicio** Un conjunto de archivos que se cargan para crear y registrar una plantilla de servicio de AWS Proton. Un paquete de plantillas de servicio contiene lo siguiente: 1. Un archivo de esquema que define los parámetros de entrada de la infraestructura como código (IaC). 1. Un archivo de IaC que define la infraestructura necesaria para implementar y mantener una aplicación o un microservicio en un entorno. 1. Un archivo de manifiesto que incluye el archivo de IaC. 1. Opcional 1. Un archivo de IaC que define la infraestructura de la canalización de servicios. 1. Un archivo de manifiesto que incluye el archivo de IaC. **Servicio** Infraestructura aprovisionada necesaria para implementar y mantener una aplicación o un microservicio en un entorno. **Instancia de servicio** Infraestructura aprovisionada que admite una aplicación o un microservicio en un entorno. **Canalización de servicios** Infraestructura aprovisionada que admite una canalización. **Versión de plantilla** Versión principal o secundaria de una plantilla. Para obtener más información, consulte [Plantillas versionadas](ag-template-versions.md). **Parámetros de entrada** Se define en un archivo de esquema y se utiliza en un archivo de infraestructura como código (IaC) para que el archivo de IaC se pueda utilizar de forma repetida y para una variedad de casos de uso. **Archivo de esquema** Define la infraestructura como parámetros de entrada del archivo de código. **Archivo de especificaciones** Especifica los valores de la infraestructura como parámetros de entrada de un archivo de código, tal como se define en un archivo de esquema. **Archivo de manifiesto** Muestra una infraestructura como archivo de código.