GitHub Actions 스토리지에 대한 자격 증명 업데이트

GitHub Actions 스토리지에 연결하기 위한 자격 증명이 변경되면 GitHub Enterprise Server의 구성에서 자격 증명을 업데이트해야 합니다.

이 기사에서

스토리지 공급자에 대한 자격 증명 비밀 업데이트

스토리지 공급자GitHub Actions에 대한 GitHub Enterprise Server 자격 증명 비밀을 업데이트하려면 두 가지 옵션이 있습니다.

경고

이 프로세스는 기존 외부 스토리지 공급자에 인증하는 데 사용되는 비밀 키를 업데이트하기 위한 것입니다. 네트워킹 구성, 스토리지 공급자 및 스토리지 계정은 변경되지 않은 상태로 유지된다고 가정합니다.

관리 콘솔에서 자격 증명 기반 인증과 OIDC 기반 인증 간에 전환하려면 이 프로세스를 사용하지 마세요. 스토리지에 대한 GitHub Actions 인증 방법을 변경하면 데이터가 손실될 수 있습니다.

  1. 서버에서 유지 관리 모드를 사용하도록 설정합니다.
  2. 비밀을 업데이트하거나 스토리지 공급자로부터 업데이트된 비밀을 가져옵니다.
  3. 아래의 UI 또는 CLI 옵션을 사용하여 GitHub Actions 스토리지 공급자 자격 증명을 GitHub Enterprise Server 업데이트하세요.

관리 콘솔을 사용하여 자격 증명 비밀 업데이트

  1.        **관리 콘솔**의 작업 섹션으로 이동합니다. 자세한 내용은 [AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-web-ui/accessing-the-management-console)을(를) 참조하세요.
  2. 비밀을 업데이트하거나, Azure Blob Storage의 경우 연결 문자열 내의 비밀을 업데이트한 후, Test storage settings 버튼을 클릭하여 GitHub Enterprise Server가 스토리지에 여전히 성공적으로 연결할 수 있는지 확인합니다.
  3. 클릭하여 Save settings 서비스가 완전히 다시 시작될 때까지 기다립니다.

명령줄을 사용하여 자격 증명 비밀 업데이트

  1.        `ghe-actions-precheck` 명령을 실행하여 새 Actions 스토리지 자격 증명을 테스트하고 구성을 업데이트합니다GitHub Enterprise Server. 자세한 내용은 [AUTOTITLE](/admin/administering-your-instance/administering-your-instance-from-the-command-line/command-line-utilities#ghe-actions-precheck)을(를) 참조하세요.
  2. Actions 스토리지 연결 테스트가 성공하면 이러한 설정을 사용하여 Actions 스토리지를 입력 Yes 하거나 No 구성하라는 메시지가 표시됩니다. 입력 Yes 하고 Enter 키를 누릅니다.
  3. 기존 Actions 스토리지 구성을 덮어쓰는 방법에 대한 프롬프트가 표시됩니다. 입력 Yes 하고 Enter 키를 누릅니다.

스토리지에 대한 GitHub Actions 인증 실패 식별

잘못된 비밀 또는 연결 문자열 때문에 GitHub Enterprise Server가 GitHub Actions 스토리지 공급자에 연결할 수 없는 경우, Access Denied 예외 또는 인증 관련 예외가 표시될 수 있습니다. 이 예외는 다음 두 가지 경우에 나타날 수 있습니다.

  •         `ghe-check-blob-connection`를 실행할 때, 명령은 출력에서 인증에 실패한 것을 직접 보고합니다.

  •         `ghe-config-apply`를 실행할 때, 관리 콘솔에서 "설정 저장"을 클릭하거나 명령줄에서 `ghe-config-apply`을 수동으로 실행하여 트리거됩니다. 예외가 파일에 표시됩니다 `/data/user/common/ghe-config.log` . 이 경우 `ghe-config-apply` 완료되지 않으므로 어플라이언스의 서비스가 예기치 않게 중단될 수 있습니다.

스토리지 공급자 구성 GitHub Enterprise Server 이 올바른 비밀 또는 연결 문자열로 업데이트되면 작업을 다시 실행하고 성공적으로 완료하도록 실행할 ghe-config-apply 수 있습니다.

참고

연결 실패는 네트워크 문제 또는 잘못 구성된 스토리지 엔드포인트와 같은 다른 원인으로 인해 발생할 수도 있습니다. 오류가 인증과 관련된 것으로 보이지 않는 경우 전체 오류 출력을 검토하여 자세한 내용을 확인하세요.

자세한 내용은 ghe-check-blob-connection을 참조하세요. 자세한 내용은 ghe-config-apply을 참조하세요.