{"meta":{"title":"GitHub Packages 빠른 시작 가이드","intro":"GitHub Packages를 사용해 GitHub Actions에 게시합니다.","product":"GitHub Packages","breadcrumbs":[{"href":"/ko/enterprise-cloud@latest/packages","title":"GitHub Packages"},{"href":"/ko/enterprise-cloud@latest/packages/quickstart","title":"빠른 시작"}],"documentType":"article"},"body":"# GitHub Packages 빠른 시작 가이드\n\nGitHub Packages를 사용해 GitHub Actions에 게시합니다.\n\n##\n\n소개\n\n이 가이드에서는 GitHub Actions 워크플로를 만들어 코드를 테스트한 다음 GitHub Packages에 게시합니다.\n\n## 관리형 사용자 계정를 사용하는 경우 계정이 소유한 리포지토리에 패키지를 게시할 수 없습니다.\n\n1. 이 가이드를 따르려면 대신 GitHub.com의 개인 계정을 사용합니다.\n\n2. 패키지 게시\n\n   ```shell\n   git clone https://github.com/YOUR-USERNAME/YOUR-REPOSITORY.git\n   cd YOUR-REPOSITORY\n   ```\n\n3. GitHub에 새 리포지토리를 만들고 Node에 `.gitignore`를 추가합니다.\n\n   ```javascript copy\n   console.log(\"Hello, World!\");\n   ```\n\n4. 자세한 내용은 [새 리포지토리 만들기](/ko/enterprise-cloud@latest/repositories/creating-and-managing-repositories/creating-a-new-repository)을(를) 참조하세요. 로컬 컴퓨터에 리포지토리를 복제합니다.\n   `index.js` 파일을 만들고 “Hello world!”라는 기본 알림을 추가합니다.\n\n   ```shell\n   $ npm init\n     ...\n     package name: @YOUR-USERNAME/YOUR-REPOSITORY\n     ...\n     test command: exit 0\n     ...\n   ```\n\n5. `npm init`을 사용하여 npm 패키지를 초기화합니다.\n\n   ```shell\n   npm install\n   git add index.js package.json package-lock.json\n   git commit -m \"initialize npm package\"\n   git push\n   ```\n\n6. 패키지 초기화 마법사에서 *`@YOUR-USERNAME/YOUR-REPOSITORY`* 와 같은 이름의 패키지를 입력하고 테스트 스크립트를 `exit 0`으로 설정합니다. 그러면 패키지에 대한 정보가 포함된 `package.json` 파일이 생성됩니다.\n\n7. `npm install`을 실행하여 `package-lock.json` 파일을 생성한 다음 변경 내용을 GitHub에 푸시합니다.\n\n   ```yaml copy\n   name: Node.js Package\n\n   on:\n     release:\n       types: [created]\n\n   jobs:\n     build:\n       runs-on: ubuntu-latest\n       steps:\n         - uses: actions/checkout@v6\n         - uses: actions/setup-node@v4\n           with:\n             node-version: 20\n         - run: npm ci\n         - run: npm test\n\n     publish-gpr:\n       needs: build\n       runs-on: ubuntu-latest\n       permissions:\n         packages: write\n         contents: read\n       steps:\n         - uses: actions/checkout@v6\n         - uses: actions/setup-node@v4\n           with:\n             node-version: 20\n             registry-url: https://npm.pkg.github.com/\n         - run: npm ci\n         - run: npm publish\n           env:\n             NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}\n   ```\n\n8. `.github/workflows` 디렉터리를 만듭니다.\n   * 디렉터리에서 `release-package.yml`이라는 파일을 만듭니다.\n\n     ```shell\n     @YOUR-USERNAME:registry=https://npm.pkg.github.com\n     ```\n\n   * 다음 YAML 콘텐츠를 `release-package.yml` 파일의 이름으로 바꿉니다.\n\n     ```shell\n     \"publishConfig\": {\n       \"@YOUR-USERNAME:registry\": \"https://npm.pkg.github.com\"\n     }\n     ```\n\n9. 다음 방법 중 하나를 사용하여 패키지를 게시할 범위 및 레지스트리를 npm에 알릴 수 있습니다.\n\n   ```shell\n   $ git add .github/workflows/release-package.yml\n   # Also add the file you created or edited in the previous step.\n   $ git add .npmrc or package.json\n   $ git commit -m \"workflow to publish package\"\n   $ git push\n   ```\n\n10. 다음과 같은 콘텐츠의 루트 디렉터리에 `.npmrc` 파일을 만들어 리포지토리에 대한 npm 구성 파일을 추가합니다.\n    `package.json` 파일을 편집하고 `publishConfig` 키를 지정합니다.\n\n    변경 내용을 커밋하고 GitHub에 푸시합니다. 만든 워크플로는 리포지토리에 새 릴리스가 만들어질 때마다 실행됩니다.\n\n## 테스트가 통과하면 패키지가 GitHub Packages에 게시됩니다.\n\n이를 테스트하려면 리포지토리의 **코드** 탭으로 이동하여 새 릴리스를 만듭니다.\n\n1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.\n2. 리포지토리 오른쪽의 사이드바에서 **패키지**를 클릭합니다.\n\n   ![리포지토리 페이지의 사이드바 스크린샷. \"패키지\" 섹션이 주황색 윤곽선으로 표시됩니다.](/assets/images/help/package-registry/packages-from-repo.png)\n3. 보고 싶은 패키지의 이름을 검색한 후 그 이름을 클릭합니다.\n\n## 자세한 내용은 [리포지토리에서 릴리스 관리](/ko/enterprise-cloud@latest/github/administering-a-repository/managing-releases-in-a-repository#creating-a-release)를 참조하세요.\n\n게시된 패키지 보기 게시한 모든 패키지를 볼 수 있습니다.\n\n## 1. GitHub에서 리포지토리의 기본 페이지로 이동합니다. 1. 리포지토리 오른쪽의 사이드바에서 **패키지**를 클릭합니다.\n\n![리포지토리 페이지의 사이드바 스크린샷. \"패키지\" 섹션이 주황색 윤곽선으로 표시됩니다.](/assets/images/help/package-registry/packages-from-repo.png) 1. 보고 싶은 패키지의 이름을 검색한 후 그 이름을 클릭합니다.\n\n게시된 패키지 설치 이제 패키지를 게시했으므로 전체 프로젝트에서 종속성으로 사용할 수 있습니다. 자세한 내용은 [npm 레지스트리 작업](/ko/enterprise-cloud@latest/packages/working-with-a-github-packages-registry/working-with-the-npm-registry#installing-a-package)을(를) 참조하세요.\n\n다음 단계 방금 추가한 기본 워크플로는 리포지토리에 새 릴리스가 만들어질 때마다 실행됩니다. 그러나 이것은 GitHub Packages로 수행할 수 있는 작업의 시작에 불과합니다.\n\n* 단일 워크플로를 사용하여 여러 레지스트리에 패키지를 게시하고, 병합된 끌어오기 요청과 같은 다른 이벤트에서 실행되도록 워크플로를 트리거하고, 컨테이너를 관리하는 등 여러 작업을 할 수 있습니다.\n* GitHub Packages와 GitHub Actions를 결합하면 애플리케이션 개발 프로세스의 거의 모든 측면을 자동화할 수 있습니다.\n* 시작할 준비가 되셨나요?"}