¿Qué son las conexiones?

Puede utilizar la función de conexiones de la consola de Developer Tools para conectar AWS recursos, por ejemplo, AWS CodePipeline a repositorios de código externos. Esta función tiene la suya propiaAPI, la de AWS CodeConnections APIreferencia. Cada conexión es un recurso que puedes dar a AWS los servicios para que se conecten a un repositorio de terceros, por ejemplo BitBucket. Por ejemplo, puedes añadir la conexión para CodePipeline que active tu canalización cuando se realice un cambio de código en el repositorio de código de un tercero. Cada conexión recibe un nombre y se asocia a un nombre de recurso de Amazon único (ARN) que se utiliza para hacer referencia a la conexión.

importante

Se ha cambiado el nombre del servicio AWS CodeStar Connections. Se seguirán admitiendo los recursos creados con el espacio de nombres anterior codestar-connections.

¿Qué puedo hacer con las conexiones?

Puede utilizar las conexiones para integrar los recursos de proveedores de terceros a sus recursos de AWS en herramientas para desarrolladores, incluso:

• Conéctate a un proveedor externo, como Bitbucket, y utiliza la conexión de terceros como fuente de integración con tus AWS recursos, por ejemplo. CodePipeline

• Gestiona de manera uniforme el acceso a tu conexión a todos tus recursos y CodeBuild crea proyectos, CodeDeploy aplicaciones y canalizaciones CodePipeline para tu proveedor externo.

• Utiliza una conexión ARN en tus plantillas de pila para CodeBuild crear proyectos, CodeDeploy aplicaciones y canalizaciones CodePipeline, sin necesidad de hacer referencia a los secretos o parámetros almacenados.

¿Para qué proveedores de terceros puedo crear conexiones?

Las conexiones pueden asociar tus AWS recursos con los siguientes repositorios de terceros:

• Bitbucket Cloud

• GitHub.com

• GitHub Nube empresarial

• GitHub Servidor empresarial

• GitLab.com

  importante

  El soporte de conexiones GitLab incluye la versión 15.x y posteriores.

• GitLab instalación autogestionada (para Enterprise Edition o Community Edition)

Para obtener información general acerca del flujo de trabajo de las conexiones, consulte Flujo de trabajo para crear o actualizar conexiones.

Los pasos para crear conexiones para un tipo de proveedor de nube, por ejemplo GitHub, son diferentes de los pasos para un tipo de proveedor instalado, como GitHub Enterprise Server. Para conocer los pasos de alto nivel necesarios para crear una conexión por tipo de proveedor, consulte Trabajar con conexiones.

nota

Para usar conexiones en Europa (Milán) Región de AWS, debe:

1. Instalar una aplicación específica de la región

2. Habilitar la región

Esta aplicación específica de la región está disponible en la región Europa (Milán). Se publica en el sitio del proveedor externo y es independiente de la aplicación existente que admite conexiones para otras regiones. Al instalar esta aplicación, autoriza a los proveedores externos a compartir sus datos con el servicio únicamente para esta región, y puede revocar los permisos en cualquier momento desinstalando la aplicación.

El servicio no procesará ni almacenará sus datos a menos que habilite la región. Al habilitar esta región, otorga a nuestro servicio permisos para procesar y almacenar sus datos.

Aunque la región no esté habilitada, los proveedores externos pueden compartir sus datos con nuestro servicio si la aplicación específica de la región permanece instalada, así que asegúrese de desinstalar la aplicación una vez que deshabilite la región. Para obtener más información, consulte Habilitar una región.

¿Qué se Servicios de AWS integra con las conexiones?

Puede utilizar las conexiones para integrar su repositorio de terceros con otros Servicios de AWS. Para ver las integraciones de servicios para las conexiones, consulte Integraciones de productos y servicios con AWS CodeConnections.

¿Cómo funcionan las conexiones?

Para poder crear una conexión, primero debe instalar la aplicación de autenticación de AWS en su cuenta de terceros o conceder acceso a ella. Una vez que la conexión se instaló, se puede actualizar para utilizar la instalación. Cuando crea una conexión, concede acceso al recurso de AWS de su cuenta de terceros. Esto permite que la conexión acceda al contenido, como los repositorios de fuentes, de la cuenta de terceros, en nombre de tus AWS recursos. A continuación, puedes compartir esa conexión con otras Servicios de AWS para proporcionar OAuth conexiones seguras entre los recursos.

Si desea crear una conexión a un tipo de proveedor instalado, como GitHub Enterprise Server, primero debe crear un recurso de host mediante el AWS Management Console.

Las conexiones son propiedad de Cuenta de AWS quien las crea. Las conexiones se identifican mediante un identificador de conexión ARN que contiene. El ID de conexión es un identificador UUID que no se puede cambiar ni reasignar. Al eliminar y restablecer una conexión, se obtiene un nuevo identificador de conexión y, por lo tanto, una conexión nueva. ARN Esto significa que las conexiones nunca ARNs se vuelven a utilizar.

Una conexión recién creada se encuentra en estado Pending. Se requiere un proceso de enlace (OAuthflujo) de terceros para completar la configuración de la conexión y para que pase de un Available estado Pending a otro. Una vez completado este proceso, la conexión se utiliza Available y se puede utilizar con AWS servicios como CodePipeline, por ejemplo.

Un alojamiento recién creado se encuentra en un estado Pending. Se requiere un proceso de registro de terceros para completar la configuración del alojamiento y para que el estado del alojamiento pase de Pending a Available. Una vez que se completa este paso, un alojamiento está Available y se puede utilizar para conexiones con tipos de proveedores instalados.

Para obtener información general acerca del flujo de trabajo de las conexiones, consulte Flujo de trabajo para crear o actualizar conexiones. Para obtener información general sobre el flujo de trabajo de creación de hosts para proveedores instalados, consulte Flujo de trabajo para crear o actualizar un host. Para conocer los pasos de alto nivel necesarios para crear una conexión por tipo de proveedor, consulte Trabajar con conexiones.

Recursos globales en AWS CodeConnections

Las conexiones son recursos globales, lo que significa que el recurso se replica en todas las regiones de Regiones de AWS.

Aunque el ARN formato de conexión refleja el nombre de la región en la que se creó, el recurso no está restringido a ninguna región. La región donde se creó el recurso de conexión es la región donde se controlan las actualizaciones de los datos de los recursos de conexión. Algunos ejemplos de API operaciones que controlan las actualizaciones de los datos de los recursos de conexión son la creación de una conexión, la actualización de una instalación, la eliminación de una conexión o el etiquetado de una conexión.

Los recursos de alojamiento para conexiones no son recursos que están disponibles en todo el mundo. Los recursos de alojamiento solo se utilizan en la región donde se crearon.

• Solo tiene que crear una conexión una vez y, después, puede utilizarla en cualquier Región de AWS.

• Si la región en la APIs que se creó la conexión tiene problemas, esto afecta a los datos de los recursos de conexión de control, pero puede seguir utilizando la conexión correctamente en cualquier otra región.

• Cuando incluyes los recursos de conexión en la consola oCLI, la lista muestra todos los recursos de conexión asociados a tu cuenta en todas las regiones.

• Cuando incluyes los recursos del anfitrión en la consola oCLI, la lista muestra los recursos del anfitrión asociados a tu cuenta únicamente en la región seleccionada.

• Cuando una conexión con un recurso de host asociado aparece en la lista o se visualiza junto con CLI ella, el resultado devuelve el host, ARN independientemente de la CLI región configurada.

Flujo de trabajo para crear o actualizar un host

Cuando cree una conexión para un proveedor instalado, cree primero un host.

Los hosts pueden tener los siguientes estados:

• Pending: un host pending es un host que se ha creado y se debe configurar (moverse a available) para poderse utilizar.

• Available: puede usar o transferir un host available a su conexión.

Flujo de trabajo: crear o actualizar un host conCLI,SDK, o AWS CloudFormation

Se usa CreateHostAPIpara crear un host con AWS Command Line Interface (AWS CLI)SDK, o AWS CloudFormation. Una vez creada, el host se encuentra en estado pending. El proceso se completa mediante la opción Configurar de la consola.

Flujo de trabajo: creación o actualización de un host con la consola

Si va a crear una conexión a un tipo de proveedor instalado, como GitHub Enterprise Server o GitLab autogestionado, primero debe crear un host. Si se conecta a un tipo de proveedor de la nube, como Bitbucket, debe omitir la creación del alojamiento y continuar creando una conexión.

Utilice la consola para configurar el host y cambiar su estado de pending a available.

Flujo de trabajo para crear o actualizar conexiones

Cuando crea una conexión, también crea o utiliza una instalación existente para el protocolo de enlace de autenticación con el proveedor de terceros.

Las conexiones pueden tener los siguientes estados:

• Pending: una conexión pending es aquella que debe completarse (pasar a available) antes de utilizarse.

• Available: puede utilizar o pasar una conexión available a otros recursos y usuarios de su cuenta.

• Error: una conexión que tiene un estado error se vuelve a intentar de forma automática. No se puede utilizar hasta que esté available.

Flujo de trabajo: creación o actualización de una conexión conCLI,SDK, o AWS CloudFormation

Se usa CreateConnectionAPIpara crear una conexión mediante AWS Command Line Interface (AWS CLI)SDK, o AWS CloudFormation. Una vez creada, la conexión se encuentra en estado pending. El proceso se completa mediante la opción de la consola Set up pending connection (Configurar conexión pendiente). La consola solicita que se cree una instalación o que se utilice una instalación existente para la conexión. Luego, se utiliza la consola para completar el protocolo de enlace y cambiar el estado de la conexión a available con la opción Complete connection (Completar conexión) de la consola.

Flujo de trabajo: creación o actualización de una conexión con la consola

Si va a crear una conexión a un tipo de proveedor instalado, como GitHub Enterprise Server, primero debe crear un host. Si se conecta a un tipo de proveedor de la nube, como Bitbucket, debe omitir la creación del alojamiento y continuar creando una conexión.

Para crear o actualizar una conexión mediante la consola, utilice la página de acciones de CodePipeline edición de la consola para elegir su proveedor externo. La consola solicita que se cree una instalación o se utilice una instalación existente para la conexión y que luego, se utilice la consola para crear la conexión. La consola completa el protocolo de enlace y el estado de la conexión pasa de pending a available de forma automática.

¿Cómo comienzo a utilizar las conexiones?

Para empezar, aquí hay algunos temas útiles para revisar:

• Obtenga información acerca de los conceptos de las conexiones.

• Configure los recursos que necesita para comenzar a trabajar con las conexiones.

• Comience con sus primeras conexiones y conéctelas a un recurso.