Atualizando as credenciais para o armazenamento do GitHub Actions

Se suas credenciais para se conectar ao armazenamento do GitHub Actions forem alteradas, você deverá atualizar as credenciais na configuração no GitHub Enterprise Server.

Neste artigo

Atualizando o segredo da credencial para seu provedor de armazenamento

Para atualizar o segredo de credencial para seu GitHub Actions provedor GitHub Enterprise Serverde armazenamento, você tem duas opções.

Aviso

Esse processo destina-se apenas à atualização da chave secreta usada para autenticar no provedor de armazenamento externo existente. Ele pressupõe que a configuração de rede, o provedor de armazenamento e a conta de armazenamento permaneçam inalterados.

Não use esse processo para alternar entre a autenticação baseada em credencial e o OIDC no console de gerenciamento. Alterar o método de autenticação no armazenamento GitHub Actions pode resultar em perda de dados.

  1. Habilite o modo de manutenção no servidor.
  2. Atualize o segredo ou obtenha o segredo atualizado do provedor de armazenamento.
  3. Use a opção de interface do usuário ou CLI abaixo para atualizar a credencial do GitHub Actions provedor de armazenamento para GitHub Enterprise Server.

Atualizando o segredo da credencial usando o console de gerenciamento

  1. Navegue até a seção Ações do Console de Gerenciamento. Para obter mais informações, consulte Acessando o Console de Gerenciamento.
  2. Atualize o segredo ou, no caso do Armazenamento de Blobs do Azure, o segredo dentro da cadeia de conexão e clique Test storage settings para confirmar que GitHub Enterprise Server ainda é capaz de se conectar com êxito ao armazenamento.
  3. Clique Save settings e aguarde os serviços reinicializarem completamente.

Atualizando o segredo da credencial usando a linha de comando

  1. Execute o ghe-actions-precheck comando para testar as novas credenciais de armazenamento do Actions e atualizar a configuração em seu GitHub Enterprise Server. Para saber mais, confira Utilitários de linha de comando
  2. Depois que o teste de conexão de armazenamento de Ações for bem-sucedido, você será solicitado a digitar Yes ou No configurar o armazenamento de ações com essas configurações. Digite Yes e insira.
  3. Você verá um prompt sobre como substituir a configuração de armazenamento de Ações existente. Digite Yes e insira.

Identificando falhas de autenticação para GitHub Actions armazenamento

Se GitHub Enterprise Server não puder se conectar ao seu GitHub Actions provedor de armazenamento devido a um segredo ou uma cadeia de conexão incorreta, você verá uma Access Denied exceção ou uma exceção relacionada à autenticação. Essa exceção pode aparecer em duas situações:

  • Ao executar ghe-check-blob-connection, o comando relatará a falha de autenticação diretamente em sua saída.
  • Quando ghe-config-apply é executado, seja ao clicar em "Salvar configurações" no console de gerenciamento, ou ao executar ghe-config-apply manualmente na linha de comando. A exceção será exibida no /data/user/common/ghe-config.log arquivo. Quando isso ocorre, ghe-config-apply não será concluído, o que pode causar uma interrupção inesperada dos serviços no seu dispositivo.

Depois que a configuração do provedor de armazenamento estiver GitHub Enterprise Server atualizada com o segredo ou a cadeia de conexão correta, você poderá executar ghe-config-apply para garantir que o trabalho seja executado novamente e concluído com êxito.

Observação

Falhas de conexão também podem resultar de outras causas, como problemas de rede ou pontos de extremidade de armazenamento configurados incorretamente. Se o erro não parecer relacionado à autenticação, examine a saída de erro completa para obter detalhes adicionais.

Para obter mais informações sobre ghe-check-blob-connection, consulte Utilitários de linha de comando. Para obter mais informações sobre ghe-config-apply, consulte Utilitários de linha de comando.