Criar um host

Você pode usar o AWS Management Console ou o AWS Command Line Interface (AWS CLI) para criar uma conexão com um repositório de código de terceiros instalado na sua infraestrutura. Por exemplo, você pode ter o GitHub Enterprise Server em execução como uma máquina virtual em uma instância do Amazon EC2. Antes de criar uma conexão com o GitHub Enterprise Server, você cria um host para usar na conexão.

Consulte uma visão geral do fluxo de trabalho de criação de host para provedores instalados em Fluxo de trabalho para criar ou atualizar um host.

Antes de começar

• (Opcional) Se quiser criar o host com uma VPC, você já deverá ter criado uma rede ou uma nuvem privada virtual (VPC).

• Você já deve ter criado a instância e, se planeja se conectar com a VPC, também já deve ter iniciado o host na VPC.

  nota

  Cada VPC só pode estar associada a um host por vez.

Se preferir, você poderá configurar o host com uma VPC. Consulte mais informações sobre a configuração de rede e VPC para o recurso de host nos pré-requisitos da VPC em (Opcional) Pré-requisitos: configuração de rede ou da Amazon VPC para sua conexão e Solução de problemas de configuração da VPC para seu host.

Para usar o console para criar um host e uma conexão com o GitHub Enterprise Server, consulteCrie sua conexão com o GitHub Enterprise Server (console). O console cria seu host para você.

Para usar o console para criar um host e uma conexão GitLab autogerenciada, consulteCrie uma conexão com o GitLab autogerenciado. O console cria seu host para você.

(Opcional) Pré-requisitos: configuração de rede ou da Amazon VPC para sua conexão

Se a sua infraestrutura estiver configurada com uma conexão de rede, ignore esta seção.

Se o seu host só for acessível em uma VPC, siga estes requisitos da VPC antes de continuar.

Requisitos da VPC

Você pode optar por criar o host com uma VPC. Veja a seguir os requisitos gerais da VPC, dependendo da VPC que você configurou para sua instalação.

• Você pode configurar uma VPC pública com sub-redes públicas e privadas. Você poderá usar a VPC padrão para a sua Conta da AWS se não tiver blocos ou sub-redes CIDR preferenciais.

• Se você tiver uma VPC privada configurada e tiver configurado sua instância do GitHub Enterprise Server para realizar a validação de TLS usando uma autoridade de certificação não pública, precisará fornecer o certificado TLS para seu recurso de host.

• Quando as conexões criam seu host, o VPC endpoint (PrivateLink) para webhooks é criado para você. Para ter mais informações, consulte Conexões de código da AWS e endpoints VPC de interface ()AWS PrivateLink.

• Configuração do grupo de segurança:

  • Os grupos de segurança usados durante a criação do host precisam de regras de entrada e saída que permitam que a interface de rede se conecte à sua instância do GitHub Enterprise Server.

  • Os grupos de segurança conectados à sua instância do GitHub Enterprise Server (que não fazem parte da configuração do host) precisam de acesso de entrada e saída das interfaces de rede criadas pelas conexões.

• As sub-redes da VPC devem residir em zonas de disponibilidade diferentes na região. As zonas de disponibilidade são locais distintos e isolados de falhas em outras zonas de disponibilidade. Cada sub-rede deve residir inteiramente dentro de uma zona de disponibilidade e não pode abranger zonas.

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.

Informações da VPC que você forneceu para a configuração do host

Ao criar o recurso de host para suas conexões na próxima etapa, forneça o seguinte:

• ID da VPC: a ID da VPC do servidor em que sua instância do GitHub Enterprise Server está instalada ou de uma VPC que tem acesso à sua instância instalada do GitHub Enterprise Server por meio de VPN ou Direct Connect.

• ID ou IDs da sub-rede: A ID da sub-rede do servidor em que sua instância do GitHub Enterprise Server está instalada ou de uma sub-rede com acesso à sua instância instalada do GitHub Enterprise Server por meio de VPN ou Direct Connect.

• Grupo ou grupos de segurança: O grupo de segurança do servidor em que sua instância do GitHub Enterprise Server está instalada ou um grupo de segurança com acesso à sua instância instalada do GitHub Enterprise Server por meio de VPN ou Direct Connect.

• Endpoint: tenha o endpoint do servidor pronto e continue até a próxima etapa.

Para obter mais informações sobre como solucionar problemas de VPC ou conexões de host, consulte Solução de problemas de configuração da VPC para seu host.

Requisitos de permissão

Como parte do processo de criação do host, Conexões de código da AWS cria recursos de rede em seu nome para facilitar a conectividade da VPC. Isso inclui uma interface de rede Conexões de código da AWS para consultar dados do seu host e um VPC endpoint ou PrivateLinkpara o host enviar dados de eventos por meio de webhooks para as conexões. Para criar esses recursos de rede, verifique se a função usada para criar o host tem as permissões a seguir:

ec2:CreateNetworkInterface
ec2:CreateTags
ec2:DescribeDhcpOptions
ec2:DescribeNetworkInterfaces
ec2:DescribeSubnets
ec2:DeleteNetworkInterface
ec2:DescribeVpcs
ec2:CreateVpcEndpoint
ec2:DeleteVpcEndpoints
ec2:DescribeVpcEndpoints

Para obter mais informações sobre como solucionar problemas de permissões ou conexões de host em uma VPC, consulte Solução de problemas de configuração da VPC para seu host.

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

Criar um host para uma conexão (console)

Para conexões para instalações, como com o GitHub Enterprise Server ou com GitLab autogerenciamento, você usa um host para representar o endpoint da infraestrutura em que seu provedor terceirizado está instalado.

nota

Atualmente, se você usar o console para criar uma conexão, isso só criará recursos dentro do codestar-connections ARN do recurso. Para criar um recurso que terá o prefixo de codeconnections serviço no ARN, use a CLI, o SDK ou o CFN. Os recursos com os dois prefixos de serviço ainda serão exibidos no console. A criação de recursos do console estará disponível a partir de 1º de julho de 2024.

Para saber mais sobre as considerações sobre a configuração de um host em uma VPC, consulte Crie uma conexão com o GitLab autogerenciado.

Para usar o console para criar um host e uma conexão com o GitHub Enterprise Server, consulteCrie sua conexão com o GitHub Enterprise Server (console). O console cria seu host para você.

Para usar o console para criar um host e uma conexão GitLab autogerenciada, consulteCrie uma conexão com o GitLab autogerenciado. O console cria seu host para você.

nota

Você só cria um host uma vez por GitHub Enterprise Server ou conta GitLab autogerenciada. Todas as suas conexões com um servidor GitHub corporativo específico ou conta GitLab autogerenciada usarão o mesmo host.

Criar um host para uma conexão (CLI)

Você pode usar o AWS Command Line Interface (AWS CLI) para criar um host para conexões instaladas.

nota

Você só cria um host uma vez por conta do GitHub Enterprise Server. Todas as suas conexões com uma conta específica do GitHub Enterprise Server usarão o mesmo host.

Você usa um host para representar o endpoint da infraestrutura em que seu provedor de terceiros está instalado. Para criar um host com a CLI, use o comando create-host. Concluída a criação do host, o host estará no status Pending (Pendente). Você então deve configurar o host para movê-lo para um status Available (Disponível). Depois que o host estiver disponível, conclua as etapas para criar uma conexão.

Importante

Um host criado por meio do Pending status AWS CLI is in por padrão. Depois de criar um host com a CLI, use o console do para configurar o host e tornar seu status Available.

Para usar o console para criar um host e uma conexão com o GitHub Enterprise Server, consulteCrie sua conexão com o GitHub Enterprise Server (console). O console cria seu host para você.

Para usar o console para criar um host e uma conexão GitLab autogerenciada, consulteCrie uma conexão com o GitLab autogerenciado. O console cria seu host para você.