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.
# Configuraciones de sincronización de plantillas
Aprende a configurar una plantilla para permitir la AWS Proton sincronización de los paquetes de plantillas ubicados en los repositorios de git registrados que tú definas. Cuando se inserta una confirmación al repositorio, AWS Proton comprueba si hay cambios en los paquetes de plantillas de dicho repositorio. Si detecta un cambio en un paquete de plantillas, se crea una nueva versión secundaria o principal de su plantilla, si la versión aún no existe. AWS Proton actualmente es compatible con GitHub GitHub Enterprise y BitBucket.
## Inserción de una confirmación a un paquete de plantillas sincronizadas
Cuando se inserta una confirmación a una ramificación a la que alguna de las plantillas está realizando un seguimiento, AWS Proton clona el repositorio y determina qué plantillas necesita sincronizar. Escanea los archivos del directorio para encontrar directorios que coincidan con la convención de `{template-name}/{major-version}/`.
Después de AWS Proton determinar qué plantillas y versiones principales están asociadas a tu repositorio y rama, comienza a intentar sincronizar todas esas plantillas en paralelo.
Durante cada sincronización con una plantilla concreta, AWS Proton primero comprueba si el contenido del directorio de plantillas ha cambiado desde la última sincronización correcta. Si el contenido no ha cambiado, AWS Proton omite el registro de un paquete duplicado. Esto garantiza la creación de una nueva versión secundaria de la plantilla si el contenido del paquete de plantillas cambia. Si el contenido del paquete de plantillas ha cambiado, el paquete se registra en él. AWS Proton
Una vez registrado el paquete de plantillas, AWS Proton supervisa el estado del registro hasta que se complete el registro.
Solo se puede realizar una sincronización con una versión secundaria y una versión principal de una plantilla determinada a la vez. Todas las confirmaciones que se hayan insertado mientras se estaba realizando una sincronización se agruparán por lotes. Las confirmaciones por lotes se sincronizan una vez finalizado el intento de sincronización anterior.
## Sincronización de plantillas de servicio
AWS Proton puede sincronizar tanto las plantillas de entorno como las de servicio desde tu repositorio de git. Para sincronizar las plantillas de servicio, añada un archivo adicional con el nombre `.template-registration.yaml` a cada directorio de versiones principales del paquete de plantillas. Este archivo contiene los detalles adicionales AWS Proton necesarios para crear una versión de plantilla de servicio para ti tras una confirmación: *entornos compatibles* y *fuentes de componentes compatibles*.
La ruta completa del archivo es `service-template-name/major-version/.template-registration.yaml`. Para obtener más información, consulte [Sincronización de plantillas de servicio](create-template-sync.md#create-template-sync-service-templates).
## Consideraciones sobre la configuración de sincronización de plantillas
Revise las siguientes consideraciones para utilizar las configuraciones de sincronización de plantillas.
+ Los repositorios no deben tener más de 250 MB.
+ Para configurar la sincronización de plantillas, primero vincule el repositorio a AWS Proton. Para obtener más información, consulte [Creación de un enlace para el repositorio del usuario](ag-create-repo.md).
+ Cuando se crea una nueva versión de la plantilla a partir de una plantilla sincronizada, tendrá el estado de `DRAFT`.
+ Se creará una nueva versión secundaria de una plantilla si se cumple alguno de los siguientes requisitos:
+ El contenido del paquete de plantillas es diferente al de la última versión secundaria de la plantilla sincronizada.
+ Se eliminó la última versión secundaria de la plantilla previamente sincronizada.
+ La sincronización no se puede pausar.
+ Tanto las nuevas versiones secundarias como las principales se sincronizan automáticamente.
+ Las configuraciones de sincronización de plantillas no pueden crear nuevas plantillas de nivel superior.
+ No se puede sincronizar una plantilla desde varios repositorios con una configuración de sincronización de plantillas.
+ No se pueden utilizar etiquetas en lugar de ramificaciones.
+ Al [crear una plantilla de servicio](template-create.md#svc-template-v1), se especifican plantillas de entorno compatibles.
+ Puede crear una plantilla de entorno y agregarla como un entorno compatible para la plantilla de servicio en la misma confirmación.
+ Las sincronizaciones con una sola versión principal de la plantilla se ejecutan de una en una. Durante una sincronización, si se detectan confirmaciones nuevas, se agruparán por lotes y se aplicarán al final de la sincronización activa. Las sincronizaciones con las diferentes versiones principales de la plantilla se realizan en paralelo.
+ Si cambia la ramificación desde la que se sincronizan las plantillas, se completará primero cualquier sincronización en curso desde la ramificación anterior. A continuación, la sincronización comenzará a partir de la nueva ramificación.
+ Si cambia el repositorio desde el que se sincronizan las plantillas, es posible que se produzca un error en las sincronizaciones en curso desde el repositorio anterior o que se ejecuten hasta completarse. Esto dependerá de la etapa de la sincronización en la que se encuentren.
Para obtener más información, consulta la [https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/proton/latest/APIReference/Welcome.html).
**Topics**
+ [
## Inserción de una confirmación a un paquete de plantillas sincronizadas
](#ag-commits)
+ [
## Sincronización de plantillas de servicio
](#syncing-service-templates)
+ [
## Consideraciones sobre la configuración de sincronización de plantillas
](#sync-considerations)
+ [
# Creación de una configuración de sincronización de plantillas
](create-template-sync.md)
+ [
# Visualización de los detalles de la configuración de sincronización de plantillas
](view-template-sync.md)
+ [
# Edición de la configuración de sincronización de una plantilla
](update-template-sync.md)
+ [
# Eliminación de una configuración sincronizada de plantillas
](delete-template-sync.md)
# Creación de una configuración de sincronización de plantillas
Aprenda a crear una configuración de sincronización de plantillas con AWS Proton.
**Requisitos previos para crear una configuración de sincronización de plantillas:**
+ Haber [vinculado un repositorio](ag-create-repo.md) con AWS Proton.
+ Que un [paquete de plantillas](ag-template-authoring.md#ag-template-bundles) se encuentre en el repositorio del usuario.
**El enlace al repositorio consta de lo siguiente:**
+ Una CodeConnections conexión que da AWS Proton permiso para acceder a tu repositorio y suscribirte a sus notificaciones.
+ Un [rol vinculado a un servicio](using-service-linked-roles.md). Al vincular el repositorio, el rol vinculado al servicio se creará para el usuario.
Antes de crear su primera configuración de sincronización de plantillas, envíe un paquete de plantillas al repositorio, tal y como se muestra en el siguiente diseño de directorios.
```
/templates/ # subdirectory (optional)
/templates/my-env-template/ # template name
/templates/my-env-template/v1/ # template version
/templates/my-env-template/v1/infrastructure/ # template bundle
/templates/my-env-template/v1/schema/
```
Tras crear la primera configuración de sincronización de plantillas, las nuevas versiones de las plantillas se crean automáticamente al insertar una confirmación que agrega un paquete de plantillas actualizadas a una versión nueva (por ejemplo, en `/my-env-template/v2/`).
```
/templates/ # subdirectory (optional)
/templates/my-env-template/ # template name
/templates/my-env-template/v1/ # template version
/templates/my-env-template/v1/infrastructure/ # template bundle
/templates/my-env-template/v1/schema/
/templates/my-env-template/v2/
/templates/my-env-template/v2/infrastructure/
/templates/my-env-template/v2/schema/
```
Puedes incluir nuevas versiones de paquetes de plantillas para una o más plantillas configuradas para la sincronización en una sola confirmación. AWS Proton crea una nueva versión de plantilla para cada nueva versión del paquete de plantillas que se incluyó en la confirmación.
Después de crear la configuración de sincronización de plantillas, aún puede crear nuevas versiones de la plantilla manualmente en la consola o con ella AWS CLI cargando paquetes de plantillas desde un bucket de S3. La sincronización de plantillas solo funciona en una dirección: desde tu repositorio hasta. AWS Proton Las versiones de plantillas creadas manualmente *no* se sincronizan.
Después de configurar una configuración de sincronización de plantillas, AWS Proton escucha los cambios en tu repositorio. Cada vez que se realiza un cambio, se busca cualquier directorio que tenga el mismo nombre que la plantilla. A continuación, busca dentro de ese directorio cualquier directorio que parezca una versión principal. AWS Proton registra el paquete de plantillas en la versión principal de la plantilla correspondiente. Las nuevas versiones están siempre en el estado `DRAFT`. Puede [publicar las nuevas versiones](template-create.md) con la consola o AWS CLI.
Por ejemplo, supongamos que tiene una plantilla llamada `my-env-template` configurada para sincronizarse desde `my-repo/templates` en una ramificación `main` con el siguiente diseño.
```
/code
/code/service.go
README.md
/templates/
/templates/my-env-template/
/templates/my-env-template/v1/
/templates/my-env-template/v1/infrastructure/
/templates/my-env-template/v1/schema/
/templates/my-env-template/v2/
/templates/my-env-template/v2/infrastructure/
/templates/my-env-template/v2/schema/
```
AWS Proton sincroniza el contenido de `/templates/my-env-template/v1/` to `my-env-template:1` y el contenido de `/templates/my-env-template/v2/` to`my-env-template:2`. Si aún no existen, se crearán estas versiones principales.
AWS Proton encontró el primer directorio que coincide con el nombre de la plantilla. Puede limitar las AWS Proton búsquedas de directorios especificando una configuración de sincronización `subdirectoryPath` al crear o editar una plantilla. Por ejemplo, puede especificar `/production-templates/` para `subdirectoryPath`.
Puede crear una configuración de sincronización de plantillas mediante la consola o la CLI.
------
#### [ Consola de administración de AWS ]
**Cree una plantilla y una configuración de sincronización de plantillas mediante la consola.**
1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), elija **Plantillas de entorno**.
1. 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 **Sincronizar plantillas de Git**.
1. Consulte la sección **Repositorio de código fuente**:
1. En **Repositorio**, seleccione el repositorio vinculado que contenga el paquete de plantillas.
1. En **Ramificación**, seleccione una ramificación del repositorio desde la que realizar la sincronización.
1. (Opcional) En **Directorio de paquetes de plantillas**, escriba el nombre de un directorio para limitar la búsqueda del paquete de plantillas.
1. En la sección **Detalles de la plantilla**.
1. Introduzca un **Nombre de plantilla**.
1. (Opcional) Introduzca un **Nombre de visualización de la plantilla**.
1. (Opcional) Introduzca una **Descripción de la plantilla** para la plantilla de entorno.
1. (Opcional) Marque la casilla **Personalización de la configuración de cifrado (avanzada)** en la sección **Configuración de cifrado** para proporcionar su propia clave de cifrado.
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 AWS administradas y administradas por el cliente. 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. En la página de detalles de la plantilla, seleccione la pestaña **Sincronizar** para ver los datos detallados de la configuración de sincronización de plantillas.
1. Seleccione la pestaña **Versiones de la plantilla** para ver las versiones de las plantillas con detalles de estado.
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 seleccionar **Publicar** en la alerta de información y omitir el siguiente paso.
1. En la sección **Versiones de la plantilla**, seleccione **Publicar**.
1. El estado de la plantilla cambiará a **Publicado**. Es la versión más reciente y **recomendada** de la plantilla.
1. En el panel de navegación, seleccione **Plantillas de entorno** para ver una lista de las plantillas de entorno y sus detalles.
El procedimiento para crear una plantilla de servicio y la configuración de sincronización de plantillas es similar.
------
#### [ AWS CLI ]
**Cree una plantilla y una configuración de sincronización de plantillas mediante la AWS CLI.**
1.
**Cree una plantilla. En este ejemplo, se crea una plantilla de entorno.**
Ejecute el comando siguiente.
```
$ aws proton create-environment-template \
--name "env-template"
```
La respuesta será como la que se muestra a continuación.
```
{
"environmentTemplate": {
"arn": "arn:aws:proton:us-east-1:123456789012:environment-template/env-template",
"createdAt": "2021-11-07T23:32:43.045000+00:00",
"displayName": "env-template",
"lastModifiedAt": "2021-11-07T23:32:43.045000+00:00",
"name": "env-template",
"status": "DRAFT",
"templateName": "env-template"
}
}
```
1.
**Cree la configuración de sincronización de su plantilla AWS CLI proporcionando lo siguiente:**
+ La plantilla con la que desee sincronizar. Una vez que haya creado la configuración de sincronización de la plantilla, podrá seguir creando nuevas versiones a partir de ella manualmente en la consola o con la AWS CLI.
+ El nombre de la plantilla.
+ El tipo de plantilla.
+ El repositorio vinculado desde el que desee sincronizar.
+ El proveedor del repositorio vinculado.
+ La ramificación en la que se encuentra el paquete de plantillas.
+ (Opcional) La ruta al directorio que contenga el paquete de plantillas. De forma predeterminada, AWS Proton busca el primer directorio que coincida con el nombre de la plantilla.
Ejecute el comando siguiente.
```
$ aws proton create-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--repository-name "myrepos/templates" \
--repository-provider "GITHUB" \
--branch "main" \
--subdirectory "env-template/"
```
La respuesta será como la que se muestra a continuación.
```
{
"templateSyncConfigDetails": {
"branch": "main",
"repositoryName": "myrepos/templates",
"repositoryProvider": "GITHUB",
"subdirectory": "templates",
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
1. **Para publicar la versión de la plantilla, consulte [Registro y publicación de plantillas](template-create.md).**
------
## Sincronización de plantillas de servicio
En los siguientes ejemplos se muestra cómo se pueden sincronizar las plantillas de entorno. Las plantillas de servicio son similares. Para sincronizar las plantillas de servicio, añada un archivo adicional con el nombre de `.template-registration.yaml` a cada directorio de versiones principales del paquete de plantillas. Este archivo contiene los detalles adicionales que se AWS Proton necesitan cuando se crea una versión de la plantilla de servicio para usted tras una confirmación. Cuando se crea de forma explícita una versión de plantilla de servicio mediante la AWS Proton consola o la API, se proporcionan estos detalles como entradas y este archivo reemplaza estas entradas para la sincronización de la plantilla.
```
./templates/ # subdirectory (optional)
/templates/my-svc-template/ # service template name
/templates/my-svc-template/v1/ # service template version
/templates/my-svc-template/v1/.template-registration.yaml # service template version properties
/templates/my-svc-template/v1/instance_infrastructure/ # template bundle
/templates/my-svc-template/v1/schema/
```
El archivo `.template-registration.yaml` contiene los siguientes detalles:
+ **Entornos compatibles** [obligatorio]: los entornos basados en estas plantillas de entorno y en las versiones principales son compatibles con los servicios basados en esta versión de la plantilla de servicio.
+ **Orígenes de componentes compatibles** [opcional]: los componentes que utilizan estos orígenes son compatibles con los servicios en función de esta versión de plantilla de servicio. Si no se especifica, los componentes no se pueden conectar a estos servicios. Para obtener más información sobre los componentes, consulte [AWS Proton componentes](ag-components.md).
La sintaxis YAML del archivo es la siguiente:
```
compatible_environments:
- env-templ-name:major-version
- ...
supported_component_sources:
- DIRECTLY_DEFINED
```
Especifique una o más combinaciones de plantillas de entorno o de versiones principales. Especificar `supported_component_sources` es opcional y el único valor admitido es `DIRECTLY_DEFINED`.
**Example .template-registration.yaml**
En este ejemplo, la versión de la plantilla de servicio es compatible con las versiones principales 1 y 2 de la plantilla de entorno `my-env-template`. También es compatible con las versiones principales 1 y 3 de la plantilla de entorno `another-env-template`. El archivo no especifica `supported_component_sources`, por lo que los componentes no se pueden conectar a los servicios basados en esta versión de la plantilla de servicio.
```
compatible_environments:
- my-env-template:1
- my-env-template:2
- another-env-template:1
- another-env-template:3
```
**nota**
Anteriormente, AWS Proton se definió un archivo diferente para especificar los entornos compatibles. `.compatible-envs` AWS Proton sigue siendo compatible con ese archivo y su formato por motivos de compatibilidad con versiones anteriores. No recomendamos seguir utilizándolo, ya que no es extensible y no admite características más nuevas como los componentes.
# Visualización de los detalles de la configuración de sincronización de plantillas
Vea los datos detallados de la configuración de sincronización de plantillas mediante la consola o la CLI.
------
#### [ Consola de administración de AWS ]
**Utilice la consola para ver detalles sobre la configuración sincronizada de plantillas.**
1. En el panel de navegación, elija **Plantillas (de entorno o de servicio)**.
1. Para ver los datos detallados, elija el nombre de la plantilla para la que creó una configuración de sincronización de plantillas.
1. En la página de detalles de la plantilla, seleccione la pestaña **Sincronización** para ver los datos detallados de la configuración de sincronización de plantillas.
------
#### [ AWS CLI ]
**Utilice AWS CLI para ver una plantilla sincronizada.**
Ejecute el comando siguiente.
```
$ aws proton get-template-sync-config \
--template-name "svc-template" \
--template-type "SERVICE"
```
La respuesta será como la que se muestra a continuación.
```
{
"templateSyncConfigDetails": {
"branch": "main",
"repositoryProvider": "GITHUB",
"repositoryName": "myrepos/myrepo",
"subdirectory": "svc-template",
"templateName": "svc-template",
"templateType": "SERVICE"
}
}
```
**Utilice AWS CLI para obtener el estado de sincronización de la plantilla.**
Para `template-version`, introduzca la versión principal de la plantilla.
Ejecute el comando siguiente.
```
$ aws proton get-template-sync-status \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--template-version "1"
```
------
# Edición de la configuración de sincronización de una plantilla
Puede editar cualquiera de los parámetros de configuración de sincronización de plantillas, excepto `template-name` y `template-type`.
Obtenga información sobre cómo editar la configuración sincronizada de plantillas mediante la consola o la CLI.
------
#### [ Consola de administración de AWS ]
Edite una ramificación de configuración de sincronización de plantillas mediante la consola.
**En la lista de plantillas.**
1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), elija **Plantillas (de entorno o de servicio)**.
1. En la lista de plantillas, elija el nombre de la plantilla con la configuración sincronizada de plantillas que desee editar.
1. En la página de detalles de la plantilla, seleccione la pestaña **Sincronización de plantillas**.
1. En la sección **Detalles de la sincronización de plantillas**, elija **Editar**.
1. En la página **Editar**, en la sección **Repositorio de código fuente**, en **Ramificación**, seleccione una ramificación y, a continuación, seleccione **Guardar configuración**.
------
#### [ AWS CLI ]
**El siguiente ejemplo de comando y respuesta muestra cómo se puede editar una `branch` de configuración de sincronización de plantillas mediante la CLI.**
Ejecute el comando siguiente.
```
$ aws proton update-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT" \
--repository-provider "GITHUB" \
--repository-name "myrepos/templates" \
--branch "fargate" \
--subdirectory "env-template"
```
La respuesta será como la que se muestra a continuación.
```
{
"templateSyncConfigDetails": {
"branch": "fargate",
"repositoryProvider": "GITHUB",
"repositoryName": "myrepos/myrepo",
"subdirectory": "templates",
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
También puede utilizarla AWS CLI para actualizar las plantillas de servicios sincronizadas.
------
# Eliminación de una configuración sincronizada de plantillas
Elimine una configuración sincronizada de plantillas mediante la consola o la CLI.
------
#### [ Consola de administración de AWS ]
**Elimine una configuración sincronizada de plantillas mediante la consola.**
1. En la página de detalles de la plantilla, seleccione la pestaña **Sincronizar**.
1. En la sección de **Detalles de sincronización**, seleccione **Desconectar**.
------
#### [ AWS CLI ]
**Los siguientes comandos y respuestas de ejemplo muestran cómo utilizarlos AWS CLI para eliminar las configuraciones de plantillas sincronizadas.**
Ejecute el comando siguiente.
```
$ aws proton delete-template-sync-config \
--template-name "env-template" \
--template-type "ENVIRONMENT"
```
La respuesta será como la que se muestra a continuación.
```
{
"templateSyncConfig": {
"templateName": "env-template",
"templateType": "ENVIRONMENT"
}
}
```
------