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.

Solución de problemas de conexiones

La siguiente información puede ayudarle a solucionar problemas comunes relacionados con las conexiones a los recursos en AWS CodeBuild AWS CodeDeploy, y AWS CodePipeline.

No puedo crear conexiones

Es posible que no tenga permisos para crear una conexión. Para obtener más información, consulte Permisos y ejemplos deAWS CodeConnections.

Aparece un error de permisos cuando intento crear o completar una conexión.

Es posible que aparezca el siguiente mensaje de error al intentar crear o ver una conexión en la CodePipeline consola.

Usuario: no username está autorizado a ejecutar: permission en el recurso: connection-ARN

Si aparece este mensaje, asegúrese de tener los permisos necesarios.

Los permisos para crear y ver conexiones en AWS Command Line Interface (AWS CLI) o en Consola de administración de AWS son solo una parte de los permisos que necesita para crear y completar conexiones en la consola. Los permisos necesarios para simplemente ver, editar o crear una conexión y, luego, completar la conexión pendiente deben aplicarse a los usuarios que solo necesitan realizar determinadas tareas. Para obtener más información, consulte Permisos y ejemplos deAWS CodeConnections.

Cuando intento utilizar una conexión aparece un error de permisos

Si intentas usar una conexión en la CodePipeline consola, aunque tengas los permisos para enumerar, obtener y crear permisos, es posible que aparezca uno de los siguientes mensajes de error o ambos.

You have failed to authenticate your account (No se ha podido autenticar la cuenta).

Usuario: no username está autorizado a ejecutar: codestar-connections: en el recurso: UseConnection connection-ARN

Si esto sucede, asegúrese de tener los permisos necesarios.

Asegúrese de tener los permisos para utilizar una conexión, incluida la lista de los repositorios disponibles en la ubicación del proveedor. Para obtener más información, consulte Permisos y ejemplos deAWS CodeConnections.

Connection is not in available state or is no longer pending (La conexión no está disponible o ya no está pendiente)

Si la consola muestra un mensaje que indica que una conexión no está en estado disponible, elija Complete connection (Completar conexión).

Si elige completar la conexión y aparece un mensaje que indica que la conexión no está en estado pendiente, puede cancelar la solicitud, ya que la conexión ya está disponible.

Si su conexión a GitHub Enterprise Server llega AWS a la Internet pública a través de un proxy o un firewall, un webhook de instalación bloqueado puede dejar la conexión en ese estado. Pending Consulte GitHub La conexión al servidor empresarial permanece pendiente (el proxy o firewall saliente bloquea el webhook de la instalación).

Añade GitClone permisos para las conexiones

Cuando usas una AWS CodeStar conexión en una acción de origen y en una CodeBuild acción, hay dos maneras de transferir el artefacto de entrada a la compilación:

Para agregar permisos a su política de rol de CodeBuild servicio, debe crear una política administrada por el cliente y adjuntarla a su rol CodeBuild de servicio. Los siguientes pasos crean una política en la que se especifica el permiso UseConnection en el campo action y el nombre de recurso de Amazon (ARN) de conexión se especifica en el campo Resource.

El alojamiento no está en estado disponible.

Si la consola muestra un mensaje que indica que un alojamiento no está en estado Available, elija Set up host (Configurar alojamiento).

El primer paso para la creación de un alojamiento da como resultado el alojamiento creado ahora en un estado Pending. Para que el estado del alojamiento cambie a Available, debe elegir configurar el alojamiento en la consola. Para obtener más información, consulte Configuración de un alojamiento pendiente.

Solución de problemas de un alojamiento con errores de conexión

Las conexiones y los hosts pueden pasar al estado de error si se elimina o modifica la GitHub aplicación subyacente. Los alojamientos y las conexiones en estado de error no se pueden recuperar y el alojamiento debe volver a crearse.

Si la consola o la CLI devuelve un alojamiento o una conexión relacionada a un alojamiento con un estado de Error, es posible que deba realizar el siguiente paso:

No puedo crear una conexión para mi alojamiento

Para crear una conexión o un alojamiento, se necesitan las siguientes condiciones.

Solución de problemas de la configuración de una VPC para el alojamiento

Al crear un recurso de host, debes proporcionar información sobre la conexión de red o la VPC de la infraestructura en la que está instalada tu instancia de GitHub Enterprise Server. Para solucionar problemas de configuración de la VPC o de la subred del alojamiento, utilice como referencia la información de la VPC de ejemplo que se muestra aquí.

En este ejemplo, utilizaría el siguiente proceso para configurar la VPC y el servidor donde se instalará la instancia de GitHub Enterprise Server:

La siguiente imagen muestra una instancia EC2 lanzada mediante la AMI GitHub empresarial.

Cuando usas una VPC para una conexión a un servidor GitHub empresarial, debes proporcionar lo siguiente para tu infraestructura al configurar tu host:

Para obtener más información acerca de cómo trabajar con las VPC y las subredes, consulte Tamaño de la subred y la VPC para una dirección IPv4 en la Guía del usuario de Amazon VPC.

No logro obtener un alojamiento en estado pendiente

Si su alojamiento entra en el estado VPC_CONFIG_FAILED_INITIALIZATION, es probable que esto se deba a un problema con la VPC, las subredes o los grupos de seguridad que ha seleccionado para el alojamiento.

No logro obtener un alojamiento en estado disponible

Si no puedes completar la configuración de la CodeConnections aplicación para tu host, es posible que se deba a un problema con las configuraciones de la VPC o con la instancia de GitHub Enterprise Server.

connection/host El mío estaba trabajando y ha dejado de funcionar ahora

Si una connection/host funcionaba antes y no funciona ahora, puede deberse a un cambio de configuración en su VPC o a que se modificó la GitHub aplicación. Comprueba lo siguiente:

No puedo eliminar mis interfaces de red

Si no puede detectar las interfaces de red, verifique lo siguiente:

Solución de problemas de puntos finales de VPC de webhook (PrivateLink) para GitHub conexiones a servidores empresariales

Cuando crea un alojamiento con configuración de VPC, se crea el punto de enlace de la VPC de webhook.

Cuando creas una conexión con un tipo de proveedor instalado y especificas que tu servidor está configurado en una VPC, creas tu host y se AWS CodeConnections crea automáticamente el punto final de la VPC (PrivateLink) para los webhooks. Esto permite al anfitrión enviar datos de eventos mediante webhooks a tus AWS servicios integrados a través de la red de Amazon. Para obtener más información, consulte AWS CodeConnections y puntos finales de VPC de interfaz ()AWS PrivateLink.

No puedo eliminar los puntos de enlace de la VPC de webhook

AWS CodeConnections administra el ciclo de vida de los puntos de enlace de la VPC de los webhooks de su host. Si desea eliminar el punto de enlace, debe eliminar el recurso de alojamiento correspondiente.

GitHub La conexión al servidor empresarial permanece pendiente (el proxy o firewall saliente bloquea el webhook de la instalación)

Al crear una conexión a GitHub Enterprise Server que llegue a AWS través de Internet pública, la instancia de GitHub Enterprise Server debe enviar un installation.created webhook único a. AWS Tu instancia envía este webhook después de instalar la GitHub aplicación y AWS registra la instalación de la aplicación solo cuando recibe el webhook. Si un proxy o firewall saliente situado delante de tu instancia de GitHub Enterprise Server bloquea esa solicitud, AWS nunca registrará la instalación y no podrás completar la conexión.

¿Síntomas?

Este error significa que AWS no recibió el webhook de instalación, por lo que la instalación nunca se registró. No significa que el identificador de instalación no sea válido.

Resolución

Solución de problemas de un alojamiento creado antes del 24 de noviembre de 2020

A partir del 24 de noviembre de 2020, AWS CodeConnections cuando configures tu host, tendrás configurada una compatibilidad adicional con puntos de conexión (PrivateLink) de VPC. Para los alojamientos creados antes de esta actualización, utilice esta sección de solución de problemas.

Para obtener más información, consulte AWS CodeConnections y puntos finales de VPC de interfaz ()AWS PrivateLink.

Tengo un host que se creó antes del 24 de noviembre de 2020 y quiero usar VPC endpoints () PrivateLink para los webhooks

Cuando configuras tu host para GitHub Enterprise Server, el punto final del webhook se crea automáticamente. Las conexiones ahora usan puntos finales de PrivateLink webhooks de VPC. Si creaste tu host antes del 24 de noviembre de 2020 y quieres usar los puntos de enlace de PrivateLink webhook de la VPC, primero debes eliminar el host y, a continuación, crear uno nuevo. https://docs.aws.amazon.com/dtconsole/latest/userguide/connections-host-create.html

No puedo obtener un alojamiento en estado disponible (error de la VPC)

Si tu host se creó antes del 24 de noviembre de 2020 y no puedes completar la configuración de la CodeConnections aplicación para tu host, es posible que se deba a un problema con la configuración de la VPC GitHub o con la instancia de Enterprise Server.

Tu VPC necesitará una puerta de enlace NAT (o acceso saliente a Internet) para que la instancia de GitHub Enterprise Server pueda enviar tráfico de red de salida en forma de webhooks. GitHub

No se puede crear la conexión para un repositorio GitHub

Problema:

Dado que la conexión a un GitHub repositorio utiliza el AWS conector para GitHub, necesitas permisos de propietario de la organización o permisos de administrador para acceder al repositorio para crear la conexión.

Posibles soluciones: para obtener información sobre los niveles de permisos de un GitHub repositorio, consulta https://docs.github.com/en/free-pro-team @ latest/github teams/permission /setting-up-and-managing-organizations-and- -levels-for-an-organization.

GitHub Edite los permisos de la aplicación de conexión a Enterprise Server

Si instalaste la aplicación para GitHub Enterprise Server el 23 de diciembre de 2020 o antes, es posible que tengas que dar Read-only acceso a la aplicación a los miembros de la organización. Si eres el propietario de la GitHub aplicación, sigue estos pasos para editar los permisos de la aplicación que se instaló cuando se creó el anfitrión.

Se produjo un error de conexión al conectarse a GitHub: «Se ha producido un problema, asegúrese de que las cookies estén activadas en su navegador» o «El propietario de una organización debe instalar la GitHub aplicación»

Problema:

Para crear la conexión a un GitHub repositorio, debes ser el propietario de la GitHub organización. Para los repositorios que no pertenecen a una organización, debe ser el propietario del repositorio. Cuando alguien que no sea el propietario de la organización crea una conexión, se crea una solicitud para el propietario de la organización y se muestra uno de los siguientes errores:

Se ha producido un problema, asegúrese de que las cookies estén habilitadas en el navegador

OR

El propietario de una organización debe instalar la GitHub aplicación

Posibles soluciones: en el caso de los repositorios de una GitHub organización, el propietario de la organización debe crear la conexión con el GitHub repositorio. Para los repositorios que no pertenecen a una organización, debe ser el propietario del repositorio.

Es posible que sea necesario actualizar el prefijo del servicio de conexiones en los recursos para cumplir con las políticas de IAM

El 29 de marzo de 2024, el servicio pasó a llamarse AWS CodeStar Connections a. AWS CodeConnections A partir del 1 de julio de 2024, la consola crea conexiones con codeconnections el ARN del recurso. Los recursos con ambos prefijos de servicio seguirán mostrándose en la consola. El prefijo de servicio para los recursos creados con la consola es. codeconnections Los nuevos SDK/CLI recursos se crean con codeconnections el ARN del recurso. Los recursos creados tendrán automáticamente el nuevo prefijo de servicio.

Los siguientes son los recursos que se crean en AWS CodeConnections:

Problema:

Los recursos que se hayan creado con codestar-connections el ARN no cambiarán automáticamente de nombre al nuevo prefijo de servicio del ARN del recurso. Al crear un recurso nuevo, se creará un recurso con el prefijo del servicio de conexiones. Sin embargo, las políticas de IAM con el prefijo de codestar-connections servicio no funcionarán para los recursos con el nuevo prefijo de servicio.

Posibles soluciones: Para evitar problemas de acceso o permisos para los recursos, lleve a cabo las siguientes acciones:

Actualice las acciones, los recursos y las condiciones de la política según corresponda. En el siguiente ejemplo, se actualizó el Resource campo para ambos prefijos de servicio.

JSON

{
    "Version":"2012-10-17",
    "Statement": {
        "Effect": "Allow",
        "Action": [
            "codeconnections:UseConnection"
        ],
        "Resource": [
            "arn:aws:codestar-connections:*:*:connection/*",
            "arn:aws:codeconnections:*:*:connection/*"
        ]
    }
}

Error de permisos debido al prefijo de servicio en los recursos creados con la consola

Actualmente, los recursos de conexión que se crean con la consola solo tendrán el prefijo de codestar-connections servicio. En el caso de los recursos creados mediante la consola, las acciones de las declaraciones de políticas deben incluirse codestar-connections como prefijo de servicio.

Problema:

Al crear un recurso de conexiones mediante la consola, se debe usar el prefijo de codestar-connections servicio en la política. Al usar una política con el prefijo de codeconnections servicio en la política, los recursos de conexión creados con la consola reciben el siguiente mensaje de error:

User: user_ARN is not authorized to perform: codestar-connections:action on resource: resource_ARN because no identity-based policy allows the codestar-connections:action action

Posibles soluciones: en el caso de los recursos creados con la consola, las acciones de las declaraciones de política deben incluir codestar-connections como prefijo de servicio, como se muestra en el ejemplo de política de. Ejemplo: una política de creaciónAWS CodeConnectionscon la consola

Configuración de la conexión y el host para los proveedores instalados y las organizaciones de apoyo

En el caso de los proveedores instalados que dan soporte a organizaciones, como GitHub las organizaciones, no se les permite dejar de tener un host disponible. Creas un host nuevo para cada conexión de tu organización y asegúrate de introducir la misma información en los siguientes campos de red:

Consulte los pasos relacionados para crear una conexión GHES o una conexión GitLab autogestionada.

Me gustaría aumentar los límites de conexiones

Puede solicitar un aumento del límite para ciertos límites en CodeConnections. Para obtener más información, consulte Cuotas para conexiones.