설명서Commerce도구

Patching Automation에 대한 GitHub 통합 설정

마지막 업데이트: 2026년 8월 27일

작성 대상:

  • Experienced
  • Admin
  • Developer

Adobe Commerce Cloud 프로젝트가 GitHub 리포지토리에 연결되어 있는 경우 서비스를 사용하여 패치를 적용하거나 되돌리려면 먼저 Patching Automation GitHub 앱을 설치해야 합니다. 이 앱은 사용자를 대신하여 저장소를 변경하는 데 필요한 액세스 권한을 서비스에 부여합니다.

사전 요구 사항

  • 활성 Adobe Commerce Cloud 구독
  • GitHub 통합이(가) fetch-branches 옵션을 사용하도록 설정한 상태로 Adobe Commerce Cloud 프로젝트에 대해 이미 구성되었습니다. Patching Automation이(가) 임시 통합 환경 분기를 만들고 푸시하므로 이 옵션을 사용하지 않도록 설정하면 패치 작업에서 환경을 만들지 못합니다.
  • github.com에 호스팅된 리포지토리입니다. 사용자 정의 도메인으로 구성된 GitHub 통합은 지원되지 않습니다.
  • GitHub 조직 또는 저장소에 대한 소유자 또는 관리자 액세스

Patching Automation GitHub 앱 설치

UI에서 Install GitHub App​을(를) 클릭하여 설치 페이지로 리디렉션하거나 설치 페이지로 직접 이동하여 Patching Automation에서 설치를 시작할 수 있습니다.

  1. Patching Automation GitHub App 설치 페이지를 엽니다.
  2. Install​을(를) 클릭합니다.
  3. Adobe Commerce 저장소를 소유한 GitHub 조직을 선택합니다.
  4. Repository access​에서 Only select repositories​을(를) 선택하고 Adobe Commerce 프로젝트에 대한 저장소를 선택합니다.
  5. Install​을(를) 클릭하여 확인합니다.

설치가 완료되면 서비스는 GitHub 연결을 자동으로 감지하고 모든 패치 작업에 앱을 사용합니다. 추가 설정이 필요하지 않습니다.

연결 상태 확인 및 관리

Patching Automation UI는 GitHub 연결의 현재 상태를 표시하며 해당 상태에 따라 사용 가능한 작업을 표시합니다.

  • Refresh / Refresh status - 변경하지 않고 연결 상태를 다시 확인합니다.
  • Reinstall - 설치가 더 이상 유효하지 않은 경우(예: 일시 중단되었거나 클라우드 프로젝트에 연결된 저장소가 변경된 경우) 표시됩니다. 위에서 설명한 것과 동일한 설치 흐름을 시작합니다.
  • Unlink GitHub App - GitHub 앱에 저장된 Patching Automation의 연결을 제거합니다. 이렇게 하면 GitHub 저장소에서 앱을 제거하지​않습니다. 액세스 권한을 완전히 제거하려면 아래 제거 섹션을 참조하십시오.

Patching Automation GitHub 앱 제거

서비스가 저장소에 더 이상 액세스하지 않으려는 경우:

  1. GitHub에서 설치를 소유하는 계정에 대한 설정을 엽니다.

    • 조직 소유 저장소의 경우: Organization settings > Third-party Access > GitHub Apps.
    • personal 리포지토리의 경우: Settings > Applications > Installed GitHub Apps.

  2. adobe-commerce-patching-automation을(를) 찾아 Configure​을(를) 클릭합니다.

  3. Uninstall​을(를) 클릭하고 확인합니다.

WARNING
GitHub 앱을 제거할 때 적용 또는 되돌리기 작업이 계속 진행 중인 경우 해당 작업이 실패할 수 있습니다. 앱을 제거한 후에는 작업 버튼이 비활성화되므로 새 작업을 시작할 수도 없습니다.

관련 항목

recommendation-more-help
commerce-operations-help-tools