Habilitar o acesso automático a GitHub.com usando o GitHub Connect

Para permitir que GitHub Actions na sua empresa use ações a partir de GitHub.com, você pode conectar a sua instância corporativa a GitHub Enterprise Cloud.

Quem pode usar esse recurso?

Enterprise owners can enable access to public GitHub.com actions.

Neste artigo

Note

No momento, não há suporte para executores hospedados no GitHub no GitHub Enterprise Server. Você pode ver mais informações sobre o suporte futuro planejado no GitHub public roadmap.

Sobre o acesso automático a ações de GitHub.com

Por padrão, os fluxos de trabalho de GitHub Actions no GitHub Enterprise Server não podem usar ações diretamente do GitHub.com ou GitHub Marketplace. Para tornar todas as ações de GitHub.com disponíveis na sua instância corporativa, você pode usar GitHub Connect para integrar o GitHub Enterprise Server ao GitHub Enterprise Cloud.

Para usar ações do GitHub.com,, o GitHub Enterprise Server e os executores auto-hospedados precisam ter a capacidade de fazer conexões de saída com o GitHub.com. Nenhuma conexão de entrada de GitHub.com é necessária. Para obter mais informações. Para obter mais informações, confira "Sobre executores auto-hospedados".

Como alternativa, se você quiser ter um controle mais rigoroso sobre as ações que são permitidas na sua empresa, faça o download e sincronize manualmente as ações na instância da sua empresa usando a ferramenta actions-sync. Para saber mais, confira Sincronizar ações do GitHub.com manualmente.

Sobre resolução para ações usando GitHub Connect

Quando um fluxo de trabalho usa uma ação, fazendo referência ao repositório onde a ação é armazenada, GitHub Actions primeiro tentará encontrar o repositório em sua instância do GitHub Enterprise Server. Se o repositório não existir em sua instância do GitHub Enterprise Server e se você tiver acesso automático para GitHub.com habilitado, GitHub Actions tentará encontrar o repositório em GitHub.com.

Se um usuário tiver criado uma organização e um repositório em sua empresa, que corresponde a uma organização e nome do repositório em GitHub.com, o repositório da sua empresa será usado em vez do repositório de GitHub.com. Para saber mais, confira Desativação automática de namespaces para ações acessadas no GitHub.com.

Habilitar o acesso automático a todas as ações públicas de GitHub.com

Antes de permitir o acesso a todas as ações públicas de GitHub.com para sua empresa, você deve :

  1. No canto superior à direita de GitHub Enterprise Server, clique na sua foto do perfil e clique em Configurações da empresa.

    Captura de tela do menu suspenso que aparece quando você clica na foto de perfil no GitHub Enterprise Server. A opção "Configurações da empresa" está realçada em um contorno laranja escuro.

  2. Na barra lateral da conta corporativa, clique em GitHub Connect .

  3. Em "Usuários podem utilizar ações do GitHub.com em execuções de fluxo de trabalho", use o menu suspenso e selecione Habilitado.

  4. Após habilitar GitHub Connect, você poderá usar políticas para restringir quais ações públicas podem ser usadas em repositórios na sua empresa. Para obter mais informações, confira "Aplicando políticas para o GitHub Actions na sua empresa".

Retirada automática de namespaces para ações acessadas em GitHub.com

Quando você habilita o GitHub Connect, os usuários não veem nenhuma alteração no comportamento dos fluxos de trabalho existentes porque o GitHub Actions procura cada ação na sua instância do GitHub Enterprise Server antes de voltar ao GitHub.com. Isso garante que todas as versões personalizadas de ações que a sua empresa criou sejam usadas em preferência para suas contrapartes em GitHub.com.

Para garantir que os fluxos de trabalho usem as ações pretendidas e bloqueiem o potencial de abuso, assim que uma ação no GitHub.com é usada pela primeira vez, o namespace associado à ação é desativado na sua empresa. Isso impede que os usuários criem uma organização e um repositório na sua empresa que correspondam ao namespace da ação no GitHub.com.

Depois de usar uma ação do GitHub.com, se você quiser criar uma ação em sua instância do GitHub Enterprise Server com o mesmo nome, primeiro precisará disponibilizar o namespace da organização e do repositório.

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

  3. Na barra lateral à esquerda, em Administrador do site, clique em Namespaces desativados.

  4. À direita do namespace que deseja usar no sua instância do GitHub Enterprise Server, clique em Cancelar desativação.

  5. Acesse a organização relevante e crie um novo repositório.

    Tip

    Quando você cancelar a desativação de um namespace, sempre crie o novo repositório com esse nome o mais rápido possível. Se um fluxo de trabalho chamar a ação associada em GitHub.com antes de criar o repositório local, o namespace será desativado novamente. Para ações usadas em fluxos de trabalho frequentemente, você pode considerar que um namespace foi desativado novamente antes de ter tempo para criar o repositório local. Neste caso, você pode desabilitar temporariamente os fluxos de trabalho relevantes até criar o novo repositório.