As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Solução de problemas de conexões

As informações a seguir podem ajudá-lo a solucionar problemas comuns com conexões a recursos em AWS CodeBuild AWS CodeDeploy, e. AWS CodePipeline

Não consigo criar conexões

Talvez você não tenha permissões para criar uma conexão. Para obter mais informações, consulte Permissões e exemplos paraConexões de código da AWS.

Recebo um erro de permissões quando tento criar ou concluir uma conexão

A mensagem de erro a seguir pode ser retornada quando você tenta criar ou visualizar uma conexão no CodePipeline console.

Usuário: não username está autorizado a executar: permission no recurso: connection-ARN

Se essa mensagem for exibida, verifique se você tem permissões suficientes.

As permissões para criar e visualizar conexões no AWS Command Line Interface (AWS CLI) ou no Console de gerenciamento da AWS são apenas parte das permissões necessárias para criar e concluir conexões no console. As permissões necessárias para simplesmente visualizar, editar ou criar uma conexão e, em seguida, concluir a conexão pendente devem ser reduzidas para usuários que só precisam executar determinadas tarefas. Para obter mais informações, consulte Permissões e exemplos paraConexões de código da AWS.

Recebo um erro de permissões quando tento usar uma conexão

Uma ou ambas as mensagens de erro a seguir podem ser retornadas se você tentar usar uma conexão no CodePipeline console, mesmo que tenha as permissões para listar, obter e criar permissões.

Não foi possível autenticar sua conta.

Usuário: não username está autorizado a executar: codestar-connections: no recurso: UseConnection connection-ARN

Se isso ocorrer, verifique se você tem permissões suficientes.

Verifique se você tem as permissões necessárias para usar uma conexão, incluindo listar os repositórios disponíveis no local do provedor. Para obter mais informações, consulte Permissões e exemplos paraConexões de código da AWS.

A conexão não está no estado disponível ou não está mais pendente

Se o console exibir uma mensagem informando que uma conexão não está em um estado disponível, escolha Complete connection (Conexão concluída).

Se você optar por concluir a conexão e uma mensagem informando que a conexão não está em um estado pendente for exibida, você poderá cancelar a solicitação porque a conexão já está em um estado disponível.

Se sua conexão com o GitHub Enterprise Server chegar AWS pela Internet pública por meio de um proxy ou firewall, um webhook de instalação bloqueado poderá deixar a conexão no Pending estado. Consulte GitHub A conexão com o Enterprise Server permanece pendente (proxy de saída ou firewall bloqueando o webhook de instalação).

Adicionar GitClone permissões para conexões

Quando você usa uma AWS CodeStar conexão em uma ação de origem e uma CodeBuild ação, há duas maneiras pelas quais o artefato de entrada pode ser passado para a compilação:

Para adicionar permissões à sua política CodeBuild de função de serviço, você cria uma política gerenciada pelo cliente que você anexa à sua função CodeBuild de serviço. As etapas a seguir criam uma política em que a permissão UseConnection é especificada no campo action e o nome do recurso da Amazon (ARN) da conexão é especificado no campo Resource.

O host não está no estado disponível

Se o console exibir uma mensagem informando que um host não está em um estado Available, escolha Set up host (Configurar host).

A primeira etapa para a criação do host resulta no host criado agora em um estado Pending. Para mover o host para um estado Available, você deve optar por configurar o host no console. Para obter mais informações, consulte Configurar um host pendente.

Solução de problemas de um host com erros de conexão

As conexões e os hosts podem entrar no estado de erro se o GitHub aplicativo subjacente for excluído ou modificado. Hosts e conexões no estado de erro não podem ser recuperados e o host deve ser recriado.

Se o console ou a CLI retornar um host ou uma conexão relacionada a um host com um estado Error, talvez você precise executar a seguinte etapa:

Não consigo criar uma conexão para o meu host

Para criar uma conexão ou host, as condições a seguir são necessárias.

Solução de problemas de configuração da VPC para seu host

Ao criar um recurso de host, você deve fornecer informações de conexão de rede ou VPC para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada. Para solucionar problemas de configuração da VPC ou sub-rede para o host, use as informações de exemplo da VPC mostradas aqui como referência.

Neste exemplo, você usaria o processo a seguir para configurar a VPC e o servidor em que sua instância do GitHub Enterprise Server será instalada:

A imagem a seguir mostra uma instância do EC2 executada usando a GitHub Enterprise AMI.

Ao usar uma VPC para uma conexão com o GitHub Enterprise Server, você deve fornecer o seguinte para sua infraestrutura ao configurar seu host:

Para obter mais informações sobre como trabalhar com VPCs e sub-redes, consulte Dimensionamento da VPC e sub-rede para IPv4 no Manual do usuário da Amazon VPC.

Não consigo obter um host no estado pendente

Se o host entrar no estado VPC_CONFIG_FAILED_INITIALIZATION, a causa provavelmente é um problema com a VPC, sub-redes ou grupos de segurança que você selecionou para o host.

Não consigo obter um host no estado disponível

Se você não conseguir concluir a configuração do CodeConnections aplicativo para seu host, pode ser devido a um problema com suas configurações de VPC ou sua instância do GitHub Enterprise Server.

Meu connection/host estava trabalhando e parou de trabalhar agora

Se a connection/host estava funcionando antes e não está funcionando agora, pode ser devido a uma alteração de configuração em sua VPC ou porque o GitHub aplicativo foi modificado. Verifique o seguinte:

Não consigo excluir minhas interfaces de rede

Se você não conseguir detectar suas interfaces de rede, verifique o seguinte:

Solução de problemas de endpoints VPC do webhook (PrivateLink) para GitHub conexões com o Enterprise Server

Quando você cria um host com a configuração da VPC, o endpoint da VPC do webhook é criado para você.

Quando você cria uma conexão com um tipo de provedor instalado e especifica que seu servidor está configurado em uma VPC, AWS CodeConnections cria seu host e o VPC endpoint (PrivateLink) para webhooks é criado para você. Isso permite que o organizador envie dados do evento por meio de webhooks para seus AWS serviços integrados pela rede Amazon. Para obter mais informações, consulte Conexões de código da AWS e endpoints VPC de interface ()AWS PrivateLink.

Não consigo excluir meus endpoints da VPC do webhook

AWS CodeConnections gerencia o ciclo de vida dos endpoints VPC do webhook para seu host. Se desejar excluir o endpoint, faça isso excluindo o recurso de host correspondente.

GitHub A conexão com o Enterprise Server permanece pendente (proxy de saída ou firewall bloqueando o webhook de instalação)

Quando você cria uma conexão com o GitHub Enterprise Server que alcança a AWS Internet pública, sua instância do GitHub Enterprise Server deve enviar um installation.created webhook único para. AWS Sua instância envia esse webhook depois que você instala o GitHub aplicativo e AWS registra a instalação do aplicativo somente quando recebe o webhook. Se um proxy de saída ou firewall na frente da sua instância do GitHub Enterprise Server bloquear essa solicitação, AWS nunca registrar a instalação e você não conseguir concluir a conexão.

Sintomas

Esse erro significa que AWS não recebi o webhook de instalação, portanto, a instalação nunca foi registrada. Isso não significa que o ID de instalação seja inválido.

Resolução

Solução de problemas para hosts criados antes de 24 de novembro de 2020

A partir de 24 de novembro de 2020, ao AWS CodeConnections configurar seu host, um suporte adicional de VPC endpoint (PrivateLink) será configurado para você. Para hosts criados antes desta atualização, use esta seção de solução de problemas.

Para obter mais informações, consulte Conexões de código da AWS e endpoints VPC de interface ()AWS PrivateLink.

Tenho um host que foi criado antes de 24 de novembro de 2020 e quero usar VPC endpoints (PrivateLink) para webhooks

Quando você configura seu host para o GitHub Enterprise Server, o endpoint do webhook é criado para você. As conexões agora usam endpoints de PrivateLink webhook da VPC. Se você criou seu host antes de 24 de novembro de 2020 e deseja usar endpoints de PrivateLink webhook da VPC, primeiro exclua seu host e depois crie um novo host.

Não consigo obter um host no estado disponível (erro da VPC)

Se seu host foi criado antes de 24 de novembro de 2020 e você não consegue concluir a configuração do CodeConnections aplicativo para seu host, pode ser devido a um problema com suas configurações de VPC ou sua instância do GitHub Enterprise Server.

Sua VPC precisará de um gateway NAT (ou acesso externo à Internet) para que sua instância do GitHub Enterprise Server possa enviar tráfego de rede de saída para webhooks. GitHub

Não é possível criar a conexão para um GitHub repositório

Problema:

Como uma conexão com um GitHub repositório usa o AWS Connector para GitHub, você precisa de permissões de proprietário da organização ou permissões de administrador no repositório para criar a conexão.

Possíveis correções: Para obter informações sobre os níveis de permissão de um GitHub repositório, consulte https://docs.github.com/en/free-pro-team @ latest/github teams/permission /setting-up-and-managing-organizations-and- -levels-for-an-organization.

Edite as permissões do aplicativo de conexão do GitHub Enterprise Server

Se você instalou o aplicativo para o GitHub Enterprise Server em ou antes de 23 de dezembro de 2020, talvez seja necessário conceder Read-only acesso ao aplicativo aos membros da organização. Se você for o proprietário do GitHub aplicativo, siga estas etapas para editar as permissões do aplicativo que foi instalado quando seu host foi criado.

Erro de conexão ao se conectar a GitHub: “Ocorreu um problema, verifique se os cookies estão habilitados em seu navegador” ou “O proprietário da organização deve instalar o GitHub aplicativo”

Problema:

Para criar a conexão para um GitHub repositório, você deve ser o proprietário da GitHub organização. Para repositórios que não estão em uma organização, você deve ser o proprietário do repositório. Quando uma conexão é criada por alguém que não seja o proprietário da organização, é criada uma solicitação para o proprietário da organização e um dos seguintes erros é exibido:

Ocorreu um problema, verifique se os cookies estão habilitados em seu navegador

OU

O proprietário da organização deve instalar o GitHub aplicativo

Possíveis correções: para repositórios em uma GitHub organização, o proprietário da organização deve criar a conexão com o repositório. GitHub Para repositórios que não estão em uma organização, você deve ser o proprietário do repositório.

O prefixo do serviço de conexões nos recursos pode precisar ser atualizado para as políticas do IAM

Em 29 de março de 2024, o serviço foi renomeado de AWS CodeStar Conexões para. AWS CodeConnections A partir de 1º de julho de 2024, o console cria conexões com codeconnections no recurso ARN. Os recursos com os dois prefixos de serviço continuarão sendo exibidos no console. O prefixo do serviço para recursos criados usando o console écodeconnections. Novos SDK/CLI recursos são criados com codeconnections o recurso ARN. Os recursos criados terão automaticamente o novo prefixo de serviço.

A seguir estão os recursos que são criados em AWS CodeConnections:

Problema:

Os recursos que foram criados com codestar-connections o ARN não serão renomeados automaticamente para o novo prefixo de serviço no ARN do recurso. A criação de um novo recurso criará um recurso com o prefixo do serviço de conexões. No entanto, as políticas do IAM com o prefixo de codestar-connections serviço não funcionarão para recursos com o novo prefixo de serviço.

Possíveis correções: para evitar problemas de acesso ou permissões para os recursos, conclua as seguintes ações:

Atualize as ações, os recursos e as condições na política conforme apropriado. No exemplo a seguir, o Resource campo foi atualizado para os dois prefixos de serviço.

JSON

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

Erro de permissão devido ao prefixo do serviço em recursos criados usando o console

Atualmente, os recursos de conexões criados usando o console terão apenas o prefixo codestar-connections de serviço. Para recursos criados usando o console, as ações da declaração de política devem ser incluídas codestar-connections como prefixo do serviço.

Problema:

Ao criar um recurso de conexões usando o console, o prefixo do codestar-connections serviço deve ser usado na política. Ao usar uma política com o prefixo codeconnections de serviço na política, os recursos de conexões criados usando o console recebem a seguinte mensagem de erro:

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

Possíveis correções: para recursos criados usando o console, as ações da declaração de política devem ser incluídas codestar-connections como prefixo do serviço, conforme mostrado no exemplo de política em. Exemplo: uma política para criarConexões de código da AWScom o console

Configuração de conexão e host para provedores instalados que apoiam organizações

Para provedores instalados que oferecem suporte a organizações, como GitHub Organizations, você não transmite um host disponível. Você cria um novo host para cada conexão em sua organização e não se esqueça de inserir as mesmas informações nos seguintes campos de rede:

Veja as etapas relacionadas para criar uma conexão GHES ou uma conexão GitLab autogerenciada.

Quero aumentar meus limites para conexões

Você pode solicitar um aumento de limite para determinados limites em CodeConnections. Para obter mais informações, consulte Cotas para conexões.