GitHub Marketplace 앱으로 개발자들의 GitHub 워크플로우를 한 단계 발전시키고 싶으신가요? GitHub Marketplace는 개발자들이 무료·유료 도구를 자유롭게 활용할 수 있는 공간입니다. 이 플랫폼은 Actions와 Apps 등 다양한 유형의 도구를 제공하며, 각 도구마다 플랫폼에 등록하는 절차가 조금씩 다릅니다. 이 글에서는 GitHub Marketplace를 시작하는 방법을 단계별로 자세히 살펴보겠습니다.
게시자 인증(Publisher Verification) 신청하기
GitHub 화면 오른쪽 상단에서 프로필 사진을 클릭한 후 Your organizations(내 조직)를 선택합니다. 조직 옆의 Settings(설정)를 클릭하고, 왼쪽 사이드바에서 Developer settings(개발자 설정)로 이동합니다. 그다음 "Developer settings" 아래에서 Publisher Verification을 클릭하세요. 체크리스트의 정보를 모두 입력한 뒤 Request Verification 버튼을 누르면, GitHub이 세부 정보를 검토한 후 게시자 인증이 완료되었을 때 결과를 알려줍니다.
목록 지표(Metrics) 확인하기
GitHub Marketplace Insights에 접근하려면, 사이트 오른쪽 상단의 프로필 사진을 클릭하고 드롭다운 메뉴에서 Settings를 선택한 뒤, 왼쪽 사이드바 메뉴에서 Developer settings를 클릭합니다.
관리하려는 Marketplace 목록에 따라 OAuth Apps 또는 GitHub Apps를 클릭합니다. 앱 설정 랜딩 페이지에서 아래로 스크롤해 Marketplace 섹션으로 이동한 후 List in Marketplace를 클릭하세요. 이미 Marketplace 초안 목록으로 저장되어 있다면 Edit Marketplace listing을 클릭하면 됩니다.
Insights 탭을 클릭하면, Insights 페이지 오른쪽 상단의 Period 드롭다운을 통해 다양한 조회 기간을 선택하며 데이터를 확인할 수 있습니다.
목록 거래 내역(Transaction) 확인하기
GitHub Marketplace 거래 내역에 접근하려면, 아무 페이지에서나 오른쪽 상단의 프로필 사진을 클릭한 뒤 Settings를 선택하고, 왼쪽 사이드바에서 Developer settings를 클릭합니다.
왼쪽 사이드바에서 관리하려는 GitHub Marketplace 목록에 따라 OAuth Apps 또는 GitHub Apps를 선택할 수 있습니다. GitHub Marketplace 앱을 직접 만든 경우라면, 거래 내역을 확인하려는 GitHub App을 반드시 선택해야 합니다.
앱 설정 랜딩 페이지에서 아래로 스크롤해 Marketplace 섹션으로 이동한 후 List in Marketplace를 클릭합니다. 이미 Marketplace 초안 목록이 있다면 Edit Marketplace listing을 클릭하세요. 참고로, 앱 등록 시 모든 사용자 또는 조직의 설치를 허용하도록 설정했다면 Marketplace 섹션이 화면에 표시됩니다.
이어서 Transaction 탭을 클릭합니다. Transactions 페이지 오른쪽 상단의 Period 드롭다운을 클릭하면 원하는 기간별로 거래 데이터를 선택해 볼 수 있습니다.
앱 테스트하기
GitHub Marketplace 초안 목록을 활용하면 실제 출시 전에 각 결제 흐름(billing flow)을 시뮬레이션해 볼 수 있습니다. 테스트 시나리오에 따라 무료 체험을 제공하는 목록 플랜을 설정하거나, 무료 구독과 유료 구독 간 전환 과정을 점검해야 할 수도 있습니다.
또한 GitHub은 "Apply Pending Change"라는 개발자 전용 기능을 제공합니다. 초안 상태의 Marketplace 목록을 보류 중인 주기(pending cycle) 페이지(https://github.com/settings/billing#pending-cycle)에서 앱의 Apply Pending Change에 접근할 수 있습니다.
앱 초안 목록(Draft Listing) 작성하기
왼쪽 사이드바에서 Developer settings 섹션을 클릭합니다. 이후 왼쪽 사이드바에서 GitHub Marketplace에 게시하려는 앱 종류에 따라 OAuth Apps 또는 GitHub Apps를 선택하고, Marketplace에 추가하려는 앱을 고릅니다.
앱 설정 랜딩 페이지에서 아래로 스크롤해 Marketplace 섹션으로 이동한 후 List in Marketplace를 클릭합니다. 이미 초안 목록을 만들어 두었다면 언제든 편집할 수 있습니다.
초안 목록을 생성하고 나면, GitHub Marketplace 목록을 완성하기 전에 진행해야 할 섹션들이 하나의 개요로 정리되어 표시됩니다.
목록 요금제 설정하기
GitHub Marketplace 목록에 대한 요금제를 만들려면, Marketplace 목록 페이지 왼쪽 사이드바에서 Plans and pricing을 클릭합니다.
만약 특정 요금제가 더 이상 필요하지 않거나 가격 세부 정보를 조정해야 한다면, 해당 요금제를 삭제할 수도 있습니다.
목록 게시 신청하기
앱 목록이 GitHub Marketplace의 요건을 충족했다면 이제 앱을 제출할 차례입니다. 앱 목록 페이지 왼쪽 상단에서 Overview를 클릭합니다.
완성된 앱 목록을 제출하려면 Request review를 클릭하세요. 제출이 완료되면 GitHub의 온보딩 전문가가 추가 정보와 함께 연락을 드립니다.
마무리
GitHub Marketplace는 개발자들이 무료·유료의 다양한 도구와 애플리케이션으로 GitHub 워크플로우를 확장하고 개선할 수 있도록 돕는 오픈소스 배포 채널입니다. 여러분이 이 플랫폼에 만들고 게시한 도구가 다른 개발자들에게 어떤 도움을 주었는지, 여러분의 경험을 들려주시면 좋겠습니다.
Github 자체를 이제 막 시작하셨다면, 시리즈의 이전 글들도 함께 확인해 보세요. Getting Started with GitHub – Hello World, Getting Started with GitHub – 소스 컨트롤의 기본기, Getting Started with GitHub – 무료 vs 유료 계정 비교, Getting Started with GitHub – 팁과 요령, 그리고 Windows 앱 수익화를 위한 GitHub Sponsors 프로그램 시작하기까지 준비되어 있습니다. GitHub Marketplace에 대해 더 궁금한 점이 있다면 공식 문서를 참고해 보세요.