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.
# Uso de repositorios de git con AWS Proton
AWS Proton usa los repositorios de git para una variedad de propósitos. La siguiente lista clasifica los tipos de repositorios asociados AWS Proton a los recursos. En el caso de AWS Proton las funciones que se conectan repetidamente a tu repositorio para enviar contenido a él o extraerlo de él, tienes que registrar un *enlace al repositorio* AWS Proton en tu AWS cuenta. Un enlace a un repositorio es un conjunto de propiedades que AWS Proton puedes usar cuando se conecta a un repositorio. AWS Proton actualmente admite GitHub GitHub Enterprise y BitBucket.
Repositorios para desarrolladores
*Repositorio de código*: un repositorio que los desarrolladores utilizan para almacenar el código de las aplicaciones. Se utiliza para la *implementación de código*. AWS Proton no interactúa directamente con este repositorio. Cuando un desarrollador aprovisiona un servicio que incluye una canalización, proporciona el nombre del repositorio y la ramificación desde la que leer el código de la aplicación. AWS Proton transfiere esta información a la canalización que aprovisiona.
Para obtener más información, consulte [Crear un servicio](ag-create-svc.md).
Repositorios de administradores
*Repositorio de plantillas*: un repositorio en el que los administradores almacenan paquetes AWS Proton de plantillas. Se utiliza para la *sincronización de plantillas*. Cuando un administrador crea una plantilla AWS Proton, puede apuntar a un repositorio de plantillas y AWS Proton mantener la nueva plantilla sincronizada con él. Cuando el administrador actualiza el paquete de plantillas en el repositorio, crea AWS Proton automáticamente una nueva versión de la plantilla. Enlaza un repositorio de plantillas AWS Proton antes de poder usarlo para la sincronización.
Para obtener más información, consulte [Configuraciones de sincronización de plantillas](ag-template-sync-configs.md).
No es necesario disponer de un repositorio de plantillas si sigues cargando tus plantillas en Amazon Simple Storage Service (Amazon S3) y llamas a AWS Proton la APIs administración de plantillas para crear nuevas plantillas o versiones de plantillas.
Repositorios de aprovisionamiento autoadministrado
*Repositorio de infraestructura*: repositorio que aloja plantillas de infraestructura representadas. Se utiliza para el *aprovisionamiento autoadministrado* de la *infraestructura de recursos*. Cuando un administrador crea un entorno para el aprovisionamiento autogestionado, proporciona un repositorio. AWS Proton envía las solicitudes de extracción (PRs) a este repositorio para crear la infraestructura del entorno y de cualquier instancia de servicio implementada en el entorno. Vincule un repositorio de infraestructura a AWS Proton antes de poder utilizarlo para el aprovisionamiento de infraestructura autoadministrado.
*Repositorio de canalizaciones*: repositorio que se utiliza para crear canalizaciones. Se utiliza para el *aprovisionamiento autoadministrado* de *canalizaciones*. El uso de un repositorio adicional para aprovisionar las canalizaciones AWS Proton permite almacenar las configuraciones de las canalizaciones de forma independiente de cualquier entorno o servicio individual. Solo necesita proporcionar un repositorio de canalización único para todos los servicios de aprovisionamiento autoadministrados. Vincula un repositorio de canalizaciones AWS Proton antes de poder usarlo para el aprovisionamiento autogestionado de canalizaciones.
Para obtener más información, consulte [¿Cómo funciona AWS el aprovisionamiento gestionado](ag-works-prov-methods.md#ag-works-prov-methods-direct).
**Topics**
+ [Creación de un enlace para el repositorio del usuario](ag-create-repo.md)
+ [Visualización de los datos del repositorio vinculado](ag-repo-view.md)
+ [Eliminación de un enlace a un repositorio](ag-repo-delete.md)
# Creación de un enlace para el repositorio del usuario
El usuario puede crear un enlace a su repositorio mediante la consola o la CLI. Cuando creas un enlace a un repositorio, AWS Proton crea un [rol vinculado a un servicio](using-service-linked-roles.md) para ti.
------
#### [ Consola de administración de AWS ]
**Cree un enlace a su repositorio como se muestra en los siguientes pasos de la consola.**
1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), seleccione **Repositorios**.
1. Elija **Create repository**.
1. En la página **Vincular nuevo repositorio**, en la sección de **Detalles del repositorio**:
1. Elija el proveedor de repositorios.
1. Elija una de las conexiones existentes. Si no tiene uno, elija **Agregar una nueva CodeStar conexión** para crear una conexión y, a continuación, vuelva a la AWS Proton consola, actualice la lista de conexiones y elija la nueva conexión.
1. Elija alguno de los repositorios de código fuente conectados.
1. *[opcional]* En la sección **Etiquetas**, seleccione **Añadir nueva etiqueta** una o más veces e introduzca los pares de **clave** y **valor**.
1. Elija **Create repository**.
1. Consulte los datos detallados del repositorio vinculado.
------
#### [ AWS CLI ]
**Cree y registre un enlace a su repositorio.**
Ejecuta el siguiente comando:
```
$ aws proton create-repository \
--name myrepos/environments \
--connection-arn "arn:aws:codestar-connections:region-id:123456789012:connection/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
--provider "GITHUB" \
--encryption-key "arn:aws:kms:region-id:123456789012:key/bPxRfiCYEXAMPLEKEY" \
--tags key=mytag1,value=value1 key=mytag2,value=value2
```
Los últimos dos parámetros, **--encryption-key** y **--tags**, son opcionales.
Respuesta:
```
{
"repository": {
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/environments",
"connectionArn": "arn:aws:codestar-connections:region-id:123456789012:connection/2ad03b28-a7c4-EXAMPLE11111",
"encryptionKey": "arn:aws:kms:region-id:123456789012:key/bPxRfiCYEXAMPLEKEY",
"name": "myrepos/environments",
"provider": "GITHUB"
}
}
```
Tras crear un enlace al repositorio, puede ver una lista de etiquetas administradas por el cliente AWS y las etiquetas, tal y como se muestra en el siguiente comando de ejemplo. AWS Proton genera automáticamente etiquetas AWS gestionadas por usted. También puede modificar y crear etiquetas administradas por el cliente mediante la AWS CLI. Para obtener más información, consulte [AWS Proton recursos y etiquetado](resources.md).
Comando:
```
$ aws proton list-tags-for-resource \
--resource-arn "arn:aws:proton:region-id:123456789012:repository/github:myrepos/environments"
```
------
# Visualización de los datos del repositorio vinculado
Puede enumerar y ver los detalles del repositorio vinculado mediante la consola o la AWS CLI. En el caso de los enlaces a los repositorios que se utilizan para sincronizar los repositorios de git AWS Proton, puedes recuperar la definición y el estado de la sincronización del repositorio mediante el AWS CLI.
------
#### [ Consola de administración de AWS ]
**Enumere y consulte los detalles de los repositorios vinculados mediante la [consola de AWS Proton](https://console.aws.amazon.com//proton/).**
1. Para ver una lista de los repositorios vinculados, seleccione **Repositorios** en el panel de navegación.
1. Para ver los datos detallados, seleccione el nombre de algún repositorio.
------
#### [ AWS CLI ]
**Enumere los repositorios vinculados.**
Ejecuta el siguiente comando:
```
$ aws proton list-repositories
```
Respuesta:
```
{
"repositories": [
{
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/templates",
"name": "myrepos/templates",
"provider": "GITHUB"
},
{
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/environments",
"name": "myrepos/environments",
"provider": "GITHUB"
}
]
}
```
**Consulte los detalles de un repositorio vinculado.**
Ejecuta el siguiente comando:
```
$ aws proton get-repository \
--name myrepos/templates \
--provider "GITHUB"
```
Respuesta:
```
{
"repository": {
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/templates",
"name": "myrepos/templates",
"provider": "GITHUB"
}
}
```
**Enumere los repositorios sincronizados.**
En el siguiente ejemplo, se enumeran los repositorios que el usuario configuró para la sincronización de plantillas.
Ejecuta el siguiente comando:
```
$ aws proton list-repository-sync-definitions \
--branch "main" \
--repository-name myrepos/templates \
--repository-provider "GITHUB" \
--sync-type "TEMPLATE_SYNC"
```
**Vea el estado de sincronización del repositorio.**
En el siguiente ejemplo se recupera el estado de sincronización de un repositorio de sincronización de plantillas.
Ejecuta el siguiente comando:
```
$ aws proton get-repository-sync-status \
--branch "main" \
--repository-name myrepos/templates \
--repository-provider "GITHUB" \
--sync-type "TEMPLATE_SYNC"
```
Respuesta:
```
{
"latestSync": {
"events": [
{
"event": "Clone started",
"time": "2021-11-21T00:26:35.883000+00:00",
"type": "CLONE_STARTED"
},
{
"event": "Updated configuration",
"time": "2021-11-21T00:26:41.894000+00:00",
"type": "CONFIG_UPDATED"
},
{
"event": "Starting syncs for commit 62c03ff86eEXAMPLE1111111",
"externalId": "62c03ff86eEXAMPLE1111111",
"time": "2021-11-21T00:26:44.861000+00:00",
"type": "STARTING_SYNC"
}
],
"startedAt": "2021-11-21T00:26:29.728000+00:00",
"status": "SUCCEEDED"
}
}
```
------
# Eliminación de un enlace a un repositorio
Puede eliminar un enlace de repositorio mediante la consola o la AWS CLI.
**nota**
Al eliminar un enlace al repositorio, solo se elimina el enlace registrado que AWS Proton esté en tu AWS cuenta. No elimina ninguna información del repositorio del usuario.
------
#### [ Consola de administración de AWS ]
**Elimine un enlace al repositorio mediante la consola.**
**En la página de detalles del repositorio.**
1. En la [consola de AWS Proton](https://console.aws.amazon.com//proton/), seleccione **Repositorios**.
1. En la lista de repositorios, elija el botón de radio a la izquierda del repositorio que desee eliminar.
1. Elija **Eliminar**.
1. Un modal le pedirá que confirme la acción de eliminación.
1. Siga las instrucciones y seleccione **Sí, eliminar**.
------
#### [ AWS CLI ]
**Elimine un enlace a un repositorio.**
Ejecuta el siguiente comando:
```
$ aws proton delete-repository \
--name myrepos/templates \
--provider"GITHUB"
```
Respuesta:
```
{
"repository": {
"arn": "arn:aws:proton:region-id:123456789012:repository/github:myrepos/templates",
"name": "myrepos/templates",
"provider": "GITHUB"
}
}
```
------