Conexões do GitHub Enterprise Server - AWS CodePipeline

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á.

Conexões do GitHub Enterprise Server

As conexões permitem que você autorize e estabeleça configurações que associam seu provedor terceirizado ao seuAWSrecursos da AWS. Para associar seu repositório de terceiros como fonte para o pipeline, você usa uma conexão.

nota

Este recurso não está disponível na região Ásia-Pacífico (Hong Kong) ou Europa (Milão). Para usar outras ações de origem disponíveis nessa região, consulteIntegrações de ações de origem.

Para adicionar uma ação de origem do GitHub Enterprise Server no CodePipeline, você pode optar por:

nota

Você também pode criar uma conexão usando o console do Developer ToolsConfigurações. ConsulteCriar uma conexão.

Antes de começar:

  • Você deve ter criado uma conta com o GitHub Enterprise Server e instalado a instância do GitHub Enterprise Server em sua infraestrutura.

  • Você já deve ter criado um repositório de código com o GitHub Enterprise Server.

Importante

AWSO CodeStar Connections não oferece suporte ao GitHub Enterprise Server versão 2.22.0 devido a um problema conhecido na versão. Para conectar, atualize para a versão 2.22.1 ou a versão mais recente disponível.

Crie uma conexão com o GitHub Enterprise Server (console)

Use estas etapas para usar oCodePipelineConsole para adicionar uma ação de conexões ao repositório do GitHub Enterprise Server.

nota

As conexões do GitHub Enterprise Server fornecem acesso somente a repositórios de propriedade da conta do GitHub Enterprise Server usada para criar a conexão.

Antes de começar:

Para uma conexão de host com o GitHub Enterprise Server, você deve ter concluído as etapas para criar um recurso de host para sua conexão. ConsulteGerenciar hosts para conexões.

Etapa 1: Crie ou edite seu pipeline

Para criar ou editar seu pipeline

  1. Faça login no console CodePipeline.

  2. Escolha uma das seguintes opções.

    • Escolha criar um pipeline. Siga as etapas emCriar um pipelinepara completar a primeira tela e escolherPróximo. NoOrigempágina, emProvedor de origem, escolhaServidor do GitHub Enterprise.

    • Escolha editar um pipeline existente. SelecioneEditee, em seguida, escolhaEdit stage. Escolha adicionar ou editar sua ação de origem. NoEditar açãopágina, emAction name (Nome da ação), insira o nome da sua ação. DentroProvedor de ação, escolhaServidor do GitHub Enterprise.

  3. Execute um destes procedimentos:

    • UNDERConexão do, se você ainda não tiver criado uma conexão com o provedor, escolhaConnect ao GitHub Enterprise Server. Prossiga para a Etapa 2: Crie uma conexão com o GitHub Enterprise Server.

    • UNDERConexão do, se você já criou uma conexão com seu provedor, escolha a conexão. Prossiga para a Etapa 3: Salve a ação de origem para sua conexão.

Crie uma conexão com o GitHub Enterprise Server.

Depois de escolher criar a conexão, oConnect ao GitHub Enterprise ServerA página é mostrada.

Importante

AWSO CodeStar Connections não oferece suporte ao GitHub Enterprise Server versão 2.22.0 devido a um problema conhecido na versão. Para conectar, atualize para a versão 2.22.1 ou a versão mais recente disponível.

Para se conectar ao GitHub Enterprise Server

  1. Em Connection name (Nome da conexão), informe um nome para a conexão.

  2. Em URL, insira o endpoint do seu servidor.

    nota

    Se o URL fornecido já tiver sido usado para configurar um GitHub Enterprise Server para uma conexão, você será avisado para escolher o ARN de recurso de host criado anteriormente para esse endpoint.

  3. Se você tiver iniciado seu servidor em uma Amazon VPC e quiser se conectar à sua VPC, escolhaUse a VPC (Usar uma VPC) e conclua as operações a seguir.

    1. Em VPC ID (ID da VPC), escolha o ID da sua VPC. Certifique-se de escolher a VPC para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou uma VPC que tenha acesso à instância do GitHub Enterprise Server instalada por meio de VPN ou Direct Connect.

    2. Em Subnet ID (ID da sub-rede), escolha Add (Adicionar). No campo, escolha o ID da sub-rede que você deseja usar para seu host. Você pode escolher até 10 sub-redes.

      Certifique-se de escolher a sub-rede para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou uma sub-rede que tenha acesso à instância do GitHub Enterprise Server instalada por meio de VPN ou Direct Connect.

    3. Em Security group IDs (IDs de grupos de segurança), escolha Add (Adicionar). No campo, escolha o grupo de segurança que você deseja usar para seu host. Você pode criar até 10 grupos de segurança.

      Certifique-se de escolher o grupo de segurança para a infraestrutura em que sua instância do GitHub Enterprise Server está instalada ou um grupo de segurança que tenha acesso à instância do GitHub Enterprise Server instalada por meio de VPN ou Direct Connect.

    4. Se você tiver uma VPC privada configurada e tiver configurado sua instância do GitHub Enterprise Server para executar a validação de TLS usando uma autoridade de certificação não pública, será necessário inserir o ID do certificado em TLS certificate (Certificado TLS). O valor do certificado TLS deve ser a chave pública do certificado.

      
                                    Captura de tela do console mostrando criar página de conexão do GitHub Enterprise Server para opções de VPC.
  4. Escolhe Connect to GitHub Enterprise Server (Conectar ao GitHub Enterprise Server). A conexão criada é mostrada com um status Pending (Pendente). Um recurso de host é criado para a conexão com as informações do servidor fornecidas. Para o nome do host, o URL é usado.

  5. Selecione Update pending connection (Atualizar conexão pendente).

  6. Se solicitado, na página de login do GitHub Enterprise, entre com suas credenciais do GitHub Enterprise.

  7. Na página Create GitHub App (Criar aplicação do GitHub), selecione um nome para a aplicação.

    
                            Captura de tela do console mostrando página de criação da aplicação.
  8. Na página de autorização do GitHub, escolha Authorize <app-name> (Autorizar <nome-da-aplicação>).

    
                            Captura de tela do console mostrando uma página de autorização de aplicação.
  9. Na página de instalação do aplicativo, uma mensagem mostra que oAWSO aplicativo CodeStar Connector está pronto para ser instalado. Se você tiver várias organizações, poderá ser solicitado a escolher a organização onde deseja instalar a aplicação.

    Escolha as configurações do repositório em que deseja instalar a aplicação. Escolha Install.

  10. A página de conexão mostra a conexão criada em um status Available (Disponível).

Etapa 3: Salve sua ação de origem do GitHub Enterprise Server

Use estas etapas no assistente ouEditar açãopara salvar sua ação de origem com as informações de conexão.

Para concluir e salvar sua ação de origem com sua conexão

  1. Em Repository name (Nome do repositório), escolha o nome do repositório de terceiros. Em Branch name (Nome da ramificação), escolha a ramificação onde deseja que o pipeline detecte alterações de origem.

  2. Em Output artifact format (Formato de artefato de saída), você deve escolher o formato para seus artefatos.

    • Para armazenar artefatos de saída da ação do GitHub Enterprise Server usando o método padrão, escolhaPadrão CodePipeline. A ação acessa os arquivos do repositório do GitHub Enterprise Server e armazena os artefatos em um arquivo ZIP no armazenamento de artefatos do pipeline.

    • Para armazenar um arquivo JSON que contém uma referência de URL ao repositório para que as ações downstream possam executar comandos Git diretamente, escolha Full clone (Clone completo). Esta opção só pode ser usada por ações downstream do CodeBuild.

  3. SelecionePróximono assistente ouSalvarnoEditar ação.

Criar um host e conexão com o GitHub Enterprise Server (CLI)

É possível usar a AWS Command Line Interface (AWS CLI) para criar uma conexão.

Para fazer isso, use o comando create-connection.

Importante

Uma conexão criada por meio da AWS CLI ou do AWS CloudFormation permanece no status PENDING por padrão. Depois de criar uma conexão com a CLI ou o AWS CloudFormation, use o console para editar a conexão e tornar seu status AVAILABLE.

Você pode usar a 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. Depois de concluir a criação do host com a CLI, o host estará emPendenteStatus. Em seguida, você configura ou registra o host para movê-lo para umDisponívelStatus. Depois que o host estiver disponível, conclua as etapas para criar uma conexão.

Para fazer isso, use o comando create-host.

Importante

Um host criado por meio da AWS CLI permanece no status Pending por padrão. Depois de criar um host com a CLI, use o console ou a CLI para configurar o host para tornar seu statusAvailable.

Para criar um host

  1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use a AWS CLI para executar o comando create-host, especificando o --name, o --provider-type e o --provider-endpoint para sua conexão. Neste exemplo, o nome do provedor de terceiros é GitHubEnterpriseServer e o endpoint é my-instance.dev.

    aws codestar-connections create-host --name MyHost --provider-type GitHubEnterpriseServer --provider-endpoint "https://my-instance.dev"

    Se o comando for bem-sucedido, ele retornará as informações de nome do recurso da Amazon (ARN) do host semelhantes às mostradas a seguir.

    { "HostArn": "arn:aws:codestar-connections:us-west-2:account_id:host/My-Host-28aef605" }

    Após esta etapa, o host estará no status PENDING.

  2. Use o console para concluir a configuração do host e mova o host para um status Available.

Para criar uma conexão com o GitHub Enterprise Server

  1. Abra um terminal (Linux, macOS ou Unix) ou um prompt de comando (Windows). Use a AWS CLI para executar o comando create-connection, especificando o --host-arn e o --connection-name para sua conexão.

    aws codestar-connections create-connection --host-arn arn:aws:codestar-connections:us-west-2:account_id:host/MyHost-234EXAMPLE --connection-name MyConnection

    Se tiver êxito, esse comando gerará as informações do ARN de conexão semelhantes às seguintes.

    { "ConnectionArn": "arn:aws:codestar-connections:us-west-2:account_id:connection/aEXAMPLE-8aad" }
  2. Use o console para configurar a conexão pendente.