GitHub Marketplace에 액션 게시하기

GitHub Marketplace에 액션 게시하기

GitHub Marketplace에 액션을 게시하고 만든 액션을 GitHub 커뮤니티와 공유할 수 있어요.

출처: Publishing actions in GitHub Marketplace

본문

사전 요구사항

[!NOTE] GitHub Marketplace에 액션을 게시하려면 서비스 약관에 동의해야 해요.

액션을 게시하려면 먼저 리포지토리에 액션을 만들어야 해요. 자세한 내용은 자동화 재사용하기를 참고하세요.

액션을 GitHub Marketplace에 게시할 계획이라면 리포지토리에 액션에 필요한 메타데이터 파일, 코드, 파일만 포함되도록 해야 해요. 액션용 단일 리포지토리를 만들면 코드를 단일 단위로 태그하고 릴리스하고 패키징할 수 있어요. GitHub은 GitHub Marketplace 페이지에서 액션의 메타데이터도 사용해요.

액션은 다음 요구사항을 충족하면 즉시 GitHub Marketplace에 게시되며 GitHub이 검토하지 않아요:

  • 액션이 공개 리포지토리에 있어야 해요.
  • 각 리포지토리 루트에 단일 액션 메타데이터 파일(action.yml 또는 action.yaml)이 있어야 해요.
    • 리포지토리는 하위 폴더에 다른 액션 메타데이터 파일을 포함할 수 있지만, 마켓플레이스에 자동으로 나열되지는 않아요.
  • 액션 메타데이터 파일의 name이 고유해야 해요.
    • name은 GitHub Marketplace에 게시된 기존 액션 이름과 일치할 수 없어요.
    • name은 GitHub의 사용자 또는 조직과 일치할 수 없어요. 단, 사용자나 조직 소유자가 액션을 게시하는 경우는 예외예요. 예를 들어 github라는 액션이라면 GitHub 조직만 게시할 수 있어요.
    • name은 기존 GitHub Marketplace 카테고리와 일치할 수 없어요.
    • GitHub은 GitHub 기능의 이름을 예약해요.

액션 게시

만든 액션을 새 릴리스로 태그하고 게시하면 GitHub Marketplace에 추가할 수 있어요.

새 릴리스를 초안 작성하고 액션을 GitHub Marketplace에 게시하려면 다음 지침을 따르세요:

  1. GitHub에서 리포지토리 메인 페이지로 이동하세요.

  2. 리포지토리의 액션 메타데이터 파일(action.yml)로 이동하면 액션을 GitHub Marketplace에 게시하라는 배너가 보일 거예요. Draft a release(릴리스 초안 작성) 를 클릭하세요.

  3. "Release Action" 아래에서 Publish this Action to the GitHub Marketplace(이 액션을 GitHub Marketplace에 게시) 를 선택하세요.

    [!NOTE] 리포지토리를 소유한 계정이 아직 GitHub Marketplace Developer Agreement에 동의하지 않았다면 "Publish(게시)" 체크박스가 비활성화돼요. 리포지토리 소유자이거나 조직 소유자라면 "GitHub Marketplace Developer Agreement에 동의(accept the GitHub Marketplace Developer Agreement)" 링크를 클릭한 다음 계약에 동의하세요. 링크가 없다면 조직 소유자에게 이 "Release Action" 페이지 링크를 보내고 계약에 동의해 달라고 요청하세요.

  4. 메타데이터 파일의 라벨에 문제가 있으면 오류 메시지나 경고 메시지가 표시될 거예요. 메타데이터 파일을 업데이트해 해결하세요. 완료되면 "Everything looks good!"(모두 정상입니다!) 메시지가 보일 거예요.

  5. Primary Category(기본 카테고리) 드롭다운 메뉴를 선택하고 사람들이 GitHub Marketplace에서 액션을 찾는 데 도움이 될 카테고리를 클릭하세요.

  6. 선택적으로 Another Category(다른 카테고리) 드롭다운 메뉴를 선택하고 보조 카테고리를 클릭하세요.

  7. 태그 필드에 액션 버전을 입력하세요. 이는 사람들이 릴리스에 어떤 변경 사항이나 기능이 포함되는지 아는 데 도움이 돼요. 사람들은 액션 전용 GitHub Marketplace 페이지에서 버전을 볼 수 있어요.

  8. 제목 필드에 릴리스 제목을 입력하세요.

  9. 다른 모든 필드를 완료하고 Publish release(릴리스 게시) 를 클릭하세요. 게시하려면 2단계 인증을 사용해야 해요. 자세한 내용은 2단계 인증 구성하기를 참고하세요.

GitHub Marketplace에서 액션 제거하기

게시된 액션을 GitHub Marketplace에서 제거하려면 각 게시된 릴리스를 업데이트해야 해요. GitHub Marketplace에 게시한 액션의 각 릴리스에 대해 다음 단계를 수행하세요.

  1. GitHub에서 리포지토리 메인 페이지로 이동하세요.

  2. 파일 목록 오른쪽에서 Releases(릴리스) 를 클릭하세요.

    리포지토리 메인 페이지 스크린샷. "Releases"로 표시된 링크가 주황색 윤곽선으로 강조됨.

  3. 편집하려는 릴리스 옆에서 를 클릭하세요.

    릴리스 목록의 릴리스 스크린샷. 연필 아이콘이 주황색 윤곽선으로 강조됨.

  4. Publish this action to the GitHub Marketplace(이 액션을 GitHub Marketplace에 게시) 를 선택해서 체크박스에서 체크를 제거하세요.

  5. 페이지 하단에서 Update release(릴리스 업데이트) 를 클릭하세요.

액션 리포지토리 전송

액션 리포지토리를 다른 사용자나 조직에 전송할 수 있어요. 자세한 내용은 리포지토리 전송하기를 참고하세요.

리포지토리 관리자가 액션 리포지토리를 전송하면 GitHub은 이전 URL에서 새 URL로 리다이렉트를 자동으로 만들어줘요. 즉 영향을 받는 액션을 사용하는 워크플로는 업데이트할 필요가 없어요.

GitHub Marketplace에 게시된 액션은 고유한 name 식별자로 리포지토리와 연결돼요. 따라서 전송된 리포지토리에서 같은 GitHub Marketplace 목록 아래 액션의 새 릴리스를 게시할 수 있어요. 액션 리포지토리가 삭제되면 GitHub Marketplace 목록도 삭제되고 고유한 name 식별자가 사용 가능해져요.

[!NOTE] 조직의 GitHub 프로필에 표시되는 "Verified(검증됨)" 배지는 GitHub Marketplace의 검증된 제작자(verified creator) 배지와 달라요. 액션 리포지토리를 전송하면 새 소유자도 검증된 제작자가 아닌 한 GitHub Marketplace 목록은 검증된 제작자 배지를 잃게 돼요.

GitHub Marketplace의 배지 소개

가 있는 액션(또는 검증된 제작자 배지)은 GitHub이 액션 제작자를 파트너 조직으로 검증했음을 나타내요. 파트너는 [email protected]로 이메일을 보내 검증된 제작자 배지를 요청할 수 있어요.

검증된 제작자 배지가 있는 GitHub Actions 스크린샷.

더 알아보기 (Learn more)