워드프레스닷컴에서 GitHub 배포 사용

GitHub 배포는 GitHub 저장소를 워드프레스닷컴 사이트와 직접 통합하여 플러그인, 테마 또는 완전한 사이트 변경을 배포하기 위한 버전 제어, 자동 워크플로를 제공합니다. 이 가이드에서는 설정 프로세스와 연결된 저장소 관리 방법에 대해 설명합니다.

이 기능은 워드프레스닷컴 비즈니스 및 상거래 요금제를 이용하는 사이트에서 사용할 수 있습니다. 비즈니스 요금제를 이용하는 경우 이를 활성화해야 합니다. 무료 사이트나 개인 및 프리미엄 요금제를 사용하는 사이트의 경우 요금제를 업그레이드하여 이 기능에 접근하세요.

영어 비디오입니다.
YouTube의 자동 번역 기능을 사용하면 원하는 언어로 시청할 수 있습니다.

자동 번역 자막을 켜는 방법:

1. 비디오를 재생합니다.
2. 비디오 오른쪽 하단의 ⚙️ 설정 아이콘을 클릭합니다.
3. 자막/CC를 선택합니다.
4. 자동 번역을 선택합니다.
5. 원하는 언어를 선택합니다.

자동 더빙(실험 기능)으로 시청하는 방법:

1. ⚙️ 설정 아이콘을 클릭합니다.
2. 오디오 트랙을 선택합니다.
3. 시청하려는 언어를 선택합니다.

ℹ️ 번역과 더빙은 Google에서 자동 생성되므로 정확하지 않을 수 있으며, 자동 더빙 기능은 현재 테스트 중이라 모든 언어에서 사용할 수 있는 것은 아닙니다.

GitHub 저장소를 워드프레스닷컴 사이트에 배포하려면 먼저 다음 단계에 따라 둘 사이의 연결을 설정해야 합니다.

1. 사이트 페이지(https://wordpress.com/sites/)를 방문합니다.
2. 사이트 이름을 클릭하여 사이트 개요를 봅니다.
3. 배포 탭을 클릭합니다.
4. “저장소 연결” 버튼을 클릭합니다. 그런 다음 나열된 저장소가 보이면 이미 GitHub 계정이 연결된 것입니다. 11단계로 계속합니다.
5. “워드프레스닷컴 앱 설치” 버튼을 클릭합니다.
6. 새 창이 열리고 아직 로그인하지 않은 경우 GitHub 계정에 로그인하라는 메시지가 표시됩니다. 그러면 다음과 같은 화면이 표시됩니다.

7. “개발자용 워드프레스닷컴 인증” 버튼을 클릭합니다.
8. 저장소가 위치한 GitHub 조직 또는 계정을 선택합니다.
9. 연결할 저장소를 선택합니다.
   • 모든 저장소: 이 옵션을 선택하면 선택한 GitHub 계정이 소유한 모든 현재 및 미래 저장소에 대한 워드프레스닷컴 접근 권한이 부여됩니다. 읽기 전용인 공개 저장소가 포함됩니다.
   • 선택한 저장소만: 이 옵션을 선택하면 선택한 GitHub 계정에서 워드프레스닷컴에서 접근할 수 있는 저장소를 선택할 수 있습니다. 
10. 옵션을 선택했으면 설치 버튼을 클릭합니다.
11. 새 창이 닫히고 워드프레스닷컴 사이트로 돌아갑니다. 선택한 저장소가 해당 저장소와 연결된 GitHub 계정과 함께 나열될 것입니다.

12. 연결하려는 저장소 옆에 있는 선택을 클릭합니다.

이 시점에서 인증된 GitHub 앱 및 설치된 GitHub 앱에서 개발자용 워드프레스닷컴이 보여야 합니다.

저장소를 선택하면 배포 설정을 조정해야 합니다.

• 배포 분기: 저장소의 기본 분기(일반적으로 메인)로 기본 설정되지만 사용하려는 분기로 변경할 수 있습니다.
• 대상 디렉터리: 파일을 배포하려는 서버 폴더입니다. 플러그인의 경우 /wp-content/plugins/my-plugin-name이 됩니다. 테마의 경우 /wp-content/themes/my-theme-name이 됩니다. 부분 사이트 배포(즉, 여러 플러그인 또는 테마)의 경우 /wp-content를 사용할 수 있습니다. 저장소의 콘텐츠는 지정된 디렉터리에 있는 워드프레스 사이트의 기존 콘텐츠와 병합됩니다.
• 자동 배포: 워드프레스닷컴에 배포하는 두 가지 방법이 있습니다.
  • 자동: 코드가 커밋되면 워드프레스닷컴 사이트에 배포됩니다. 스테이징 사이트에는 자동 배포를 권장합니다.
  • 수동: 배포를 요청하면 코드가 배포됩니다. 프로덕션 사이트에는 수동 배포가 권장됩니다.
• 배포 모드: 두 가지 배포 유형이 있습니다.
  • 단순: 이 모드에서는 저장소의 분기에서 사이트로 모든 파일을 복사하고 사후 처리 없이 배포합니다.
  • 고급: 이 모드에서는 워크플로우 스크립트를 사용하여 Composer 종속성 설치, 배포 전 코드 테스트 수행, 파일 배포 제어와 같은 사용자 정의 빌드 단계를 사용할 수 있습니다. Composer 또는 Node 소프트웨어가 필요한 저장소에 적합합니다. 자세한 내용은 아래의 고급 배포를 참조하세요.

모든 설정이 구성되었으면 연결 버튼을 클릭합니다. 저장소가 추가됩니다.

첫 번째 배포는 자동 또는 수동으로 트리거해야 합니다. 그런 다음 “저장소 연결” 버튼을 클릭하여 언제든지 다른 저장소를 연결할 수 있습니다.

고급 배포에서는 배포 전에 저장소의 파일을 처리하는 워크플로우 스크립트를 제공할 수 있습니다. 이를 통해 팀의 코딩 표준을 충족하는지 코드를 확인하고, 단위 테스트를 실행하고, 배포에서 파일을 제외하고, 종속성을 설치하는 등 많은 가능성이 열립니다. 시작하려면 워크플로우 레시피를 확인하세요.

고급 배포를 설정하려면 다음 단계를 따르세요.

1. 배포를 구성할 수 있는 양식이 나타납니다.
2. 저장소 이름을 클릭하여 연결을 관리합니다.
3. 오른쪽의 “배포 모드 선택“에서 고급을 선택합니다.

4. 저장소에 이미 워크플로 파일이 있으면 여기에서 선택할 수 있습니다. 시스템에서 파일에 오류가 있는지 확인합니다. 오류를 찾을 수 없으면 7단계로 진행합니다.
5. “새 워크플로 생성” 옵션을 선택하여 사전 구성된 워크플로 파일을 추가할 수도 있습니다. 이 옵션을 선택하면 wpcom.yml 워크플로 파일이 저장소에 이미 있는 경우 덮어씁니다.
6. “나를 위해 워크플로 설치” 버튼을 클릭하여 워크플로 파일을 저장소에 커밋합니다.
7. 워크플로가 추가되고 확인되었으면 업데이트를 누릅니다. 이제 저장소에서 고급 배포를 사용합니다.

GitHub 저장소를 사이트에 연결한 후, 다음 단계는 실제로 코드를 배포하는 것입니다. 사용 가능한 배포 방법으로는 자동 및 수동이 있습니다.

저장소의 코드 변경 사항이 GitHub에서 라이브 사이트로 자동으로 배포되므로 라이브 프로덕션 사이트에는 자동 배포를 권장하지 않습니다. 대신 스테이징 사이트에 자동 배포를 설정하고 준비되면 프로덕션에 동기화하는 것을 고려해 보세요.

수동 배포에서는 각 배포를 수동으로 트리거해야 하므로 코드 변경 사항이 실시간으로 푸시되는 시기를 더 많이 제어할 수 있습니다. 스테이징 사이트를 사용하지 않으려면 수동 배포를 권장합니다.

수동 배포 트리거

1. 사이트 페이지(https://wordpress.com/sites/)를 방문합니다.
2. 사이트 이름을 클릭하여 사이트 개요를 봅니다.
3. 배포 탭을 클릭합니다.
4. 배포하려는 저장소에서 줄임표 메뉴(⋮)를 클릭합니다.
5. “수동 배포 트리거“를 선택합니다. “배포 실행이 생성되었습니다”라는 배너 알림이 표시되어야 하며 배포 상태가 “대기 중”으로 변경됩니다.
6. 배포가 완료될 때까지 기다립니다(상태가 “배포됨”으로 변경됨).

7. 다시 줄임표 메뉴(⋮)를 클릭하고 “배포 실행 보기“를 선택합니다. 
8. 배포 실행 로그에 작성자 및 배포된 커밋이 표시됩니다. 배포 실행 항목을 클릭하면 추가 정보를 볼 수 있습니다.

기존 GitHub 저장소 연결을 관리하려면 다음 단계를 따르세요.

1. 사이트 페이지(https://wordpress.com/sites/)를 방문합니다.
2. 사이트 이름을 클릭하여 사이트 개요를 봅니다.
3. 배포 탭을 클릭합니다.
4. 그러면 연결 목록이 표시됩니다. 

GitHub 저장소와 사이트 사이에 연결이 하나 이상 있으면 연결 목록이 표시됩니다. 이 목록에는 저장소 이름 및 분기, 사이트에 배포된 마지막 커밋, 발생 시점, 코드가 배치된 위치, 배포 실행 시간 및 상태 등 각 연결에 대한 관련 정보가 포함됩니다.

줄임표 메뉴(⋮)를 클릭한 후에 사용할 수 있는 추가 작업은 다음과 같습니다.

• 수동 배포 트리거: 구성된 분기의 최신 커밋에서 배포 실행을 시작합니다.
• 배포 실행 보기: 연결된 저장소의 배포 실행 로그 보기를 엽니다.
• 연결 구성: 저장소의 연결 관리 보기를 엽니다.
• 저장소 연결 해제: 저장소와 사이트 사이의 연결을 제거합니다.

배포 실행 로그는 자동 또는 수동으로 트리거되었는지 여부에 관계없이 각 배포의 상세한 단계별 레코드를 제공합니다. 이 로그는 변경 사항을 추적하고, 배포 상태를 모니터링하며, 발생하는 문제를 해결하는 데 도움이 됩니다. 30일 이내에 실행된 최근 10회의 로그에 대한 접근을 통해 각 배포 도중에 발생한 일을 쉽게 검토하고 모든 것이 원활하게 실행되는지 확인할 수 있습니다.

배포 로그를 확인하는 방법은 다음과 같습니다.

1. 사이트 페이지(https://wordpress.com/sites/)를 방문합니다.
2. 사이트 이름을 클릭하여 사이트 개요를 봅니다.
3. 배포 탭을 클릭합니다.
4. 로그를 보려는 저장소 옆의 줄임표 메뉴(⋮)를 클릭합니다.
5. “배포 실행 보기“를 선택합니다.
6. 배포 실행 목록 보기에는 사이트에 배포된 커밋, 배포 상태, 날짜 및 기간이 표시됩니다.
7. 실행 중 아무 곳이나 클릭하여 배포에 대한 자세한 정보를 확장하고 확인합니다.

로그는 GitHub에서 코드를 가져오는 것부터 대상 디렉터리에 배치하는 것까지 실행된 모든 명령의 레코드를 제공합니다. “더 보기“를 클릭하여 로그 라인을 확장하여 더 많은 정보를 볼 수있습니다.

사이트에서 GitHub 저장소 연결을 해제하면 앞으로 저장소에 대한 변경 사항이 더 이상 사이트에 영향을 미치지 않습니다. 기본적으로 배포된 파일은 사이트에 남아 있지만 연결 해제 프로세스 중에 제거할 수 있습니다.

저장소를 제거하려면 다음 단계를 따르세요.

1. 사이트 페이지(https://wordpress.com/sites/)를 방문합니다.
2. 사이트 이름을 클릭하여 사이트 개요를 봅니다.
3. 배포 탭을 클릭합니다.
4. 저장소에서 줄임표 메뉴(⋮)를 클릭합니다.
5. “저장소 연결 해제“를 선택합니다.
6. 대화 상자 창이 나타납니다. 사이트에서 관련 파일을 제거하려면 스위치를 클릭합니다.
7. “저장소 연결 해제“를 클릭하여 대화 상자를 닫고 저장소 연결을 해제합니다.

개발자용 워드프레스닷컴은 설치된 GitHub 앱과 인증된 GitHub 앱에 계속 표시됩니다. 워드프레스닷컴은 여전히 저장소에 접근할 수 있지만, 연결이 삭제되었기 때문입니다.

GitHub 계정에 대한 워드프레스닷컴의 접근 권한을 취소할 수도 있습니다. 언제든지 GitHub의 애플리케이션 설정 을 방문하여 이를 수행 할 수 있습니다. 

GitHub 계정에 대한 승인된 앱 접근 권한을 취소하려면 다음 단계를 따르세요.

1. 인증된 GitHub 앱으로 이동합니다.
2. 개발자용 워드프레스닷컴 옆의 취소를 클릭합니다.
3. “네, 접근 권한을 취소합니다” 버튼을 클릭합니다.

인증된 앱 접근 권한을 취소하더라도 선택한 계정에 개발자용 워드프레스닷컴 앱이 설치된 상태로 유지되므로 코드를 배포할 수 있습니다.

워드프레스닷컴 설치 접근 권한을 취소하고 워드프레스닷컴 사이트에 코드를 배포하는 기능을 비활성화하려면 다음 단계를 따르세요.

1. 설치된 GitHub 앱으로 이동합니다.
2. 개발자용 워드프레스닷컴 옆의 구성을 클릭합니다.
3. 위험 구역 영역에서 제거를 클릭한 다음 메시지가 표시되면 확인을 클릭합니다.

인증된 앱 목록에서 워드프레스닷컴을 제거한다고 해서 저장소가 삭제되거나 작동이 중지되는 것은 아닙니다. 워드프레스닷컴의 접근 권한을 취소한 후에도 저장소는 GitHub에 계속 존재하지만 워드프레스닷컴에서는 더 이상 코드를 배포할 수 없습니다.