검색
← 릴리스 노트

같은 저장소 작업을 자체 저장소 경로로 참조

깃허브 · 기능추가 · 2026.07.30

같은 저장소의 action과 reusable workflow를 새 self-repository 문법으로 checkout 없이 참조할 수 있게 됐습니다.

교안에 영향

같은 저장소의 action 참조 예시에서 `./`와 checkout을 전제로 한 안내는 더 이상 맞지 않을 수 있습니다.

요약

- self-repository syntax로 같은 저장소의 action과 reusable workflow를 참조할 수 있게 됐습니다. - `uses:` 값이 `$/`로 시작하면 실행 중인 워크플로의 저장소와 현재 커밋을 기준으로 해석됩니다. - 이 방식은 workflow steps, composite action steps, nested composition, reusable workflow calls에서 모두 사용할 수 있습니다. - 내부 참조가 현재 실행 중인 ref와 자동으로 맞춰져 commit SHA 고정 정책과의 정합성이 좋아집니다.

바뀐 것

새 기능 3

  • 같은 저장소에 있는 action과 reusable workflow를 `$/`로 시작하는 self-repository syntax로 참조할 수 있게 됐습니다.
  • `uses:` 값이 `$/`로 시작하면 checkout 없이 실행 중인 워크플로의 저장소에서 정확한 커밋을 기준으로 해석됩니다.
  • self-repository syntax가 workflow steps, composite action steps, nested composition, reusable workflow calls 전반에서 지원됩니다.

개선 2

  • 같은 저장소 안의 sibling actions와 workflows가 현재 실행 중인 ref와 자동으로 맞춰져 내부 참조의 일관성이 좋아졌습니다.
  • caller가 full-length commit SHA로 고정된 경우에도 내부 참조가 같은 ref를 따르도록 되어 commit SHA pinning 정책 적용이 쉬워졌습니다.

기타 1

  • github.com에서 사용할 수 있으며, 이 기능을 쓰려면 GitHub Actions runner 2.336.0 이상이 필요합니다.

원문 제목 · Reference same-repository actions with self-repository syntax