Python 라이브러리를 유지 관리하는 것은 어려울 수 있으며, 특히 새 버전을 출시하는 경우에는 더욱 그렇습니다. 이 프로세스를 수동으로 수행하면 시간이 많이 걸리고 오류가 발생하기 쉽습니다. 이 게시물에서는 GitHub Actions 및 Commitizen을 사용하여 릴리스 프로세스를 자동화하는 방법을 안내하겠습니다. 이 접근 방식을 사용하면 릴리스의 일관성, 의미론적 버전 관리(semver) 준수, 변경 로그를 최신 상태로 유지하는 동시에 수동 개입을 줄일 수 있습니다.
Semantic Versioning(semver)은 MAJOR.MINOR.PATCH 형식의 세 숫자를 사용하는 버전 관리 체계입니다. 이 체계는 각 릴리스의 변경 사항을 전달하는 명확하고 예측 가능한 방법을 제공합니다.
의미적 버전 관리는 개발자가 종속성을 효과적으로 관리하는 데 도움이 되기 때문에 매우 중요합니다. 새 버전의 라이브러리에 주요 변경 사항(예: 마이너 또는 패치 업데이트)이 적용되지 않는다는 사실을 알게 되면 애플리케이션 중단에 대한 걱정 없이 자신있게 종속성을 업데이트할 수 있습니다.
semver에 대한 자세한 내용은 semver.org를 확인하세요.
Commitizen은 커밋 메시지를 표준화하고 버전 관리 및 변경 로그 생성을 자동화하는 도구입니다. 특정 커밋 메시지 형식을 적용함으로써 Commitizen은 필요한 버전 변경 유형(주, 부 또는 패치)을 결정하고 변경 로그를 자동으로 생성할 수 있습니다.
커밋 메시지 형식은 다음 구조를 따릅니다.
<commit-type>(<topic>): the commit message
예:
feat(parser): add support for parsing new file formats
fix(api): handle null values in the response
feat(api): change response of me endpoint BREAKING CHANGE: changes the API signature of the parser function
이 예에서 Feat 커밋 내의 주요 변경 사항 메모는 주요 버전 범프를 유발합니다. 이러한 일관성을 통해 버전 번호가 올바른 변경 수준을 전달할 수 있으며 이는 라이브러리를 사용하는 사용자에게 매우 중요합니다.
Commitizen을 Python 프로젝트와 통합하려면 pyproject.toml 파일에서 이를 구성해야 합니다. 다음은 추가해야 할 구성입니다.
[tool.commitizen] name = "cz_conventional_commits" version = "0.1.0" tag_format = "v$version" version_files = [ "pyproject.toml:version", ] update_changelog_on_bump = true
설명:
릴리스를 수동으로 관리하는 것은 지루하고 오류가 발생하기 쉬울 수 있으며, 특히 프로젝트가 성장함에 따라 더욱 그렇습니다. 자동화는 다음과 같은 몇 가지 주요 이점을 제공합니다.
자동화 작동 방식을 명확하게 보여주기 위해 대략적인 개요를 제공합니다.
단순성과 명확성을 위해 자동화를 두 가지 워크플로로 나누겠습니다.
This workflow handles the logic of detecting changes and bumping the version:
name: Merge to Main on: push: branches: - "main" concurrency: group: main cancel-in-progress: true jobs: bump: if: "!startsWith(github.event.head_commit.message, 'bump:')" runs-on: ubuntu-latest steps: - name: Setup Python uses: actions/setup-python@v5 with: python-version: "3.10" - name: Checkout Repository uses: actions/checkout@v4 with: token: ${{ secrets.PERSONAL_ACCESS_TOKEN }} fetch-depth: 0 - name: Create bump and changelog uses: commitizen-tools/commitizen-action@0.21.0 with: github_token: ${{ secrets.PERSONAL_ACCESS_TOKEN }} branch: main
Explanation:
This workflow is triggered when a tag is pushed, and it handles the release process:
name: On Tag Creation on: push: tags: - 'v*' concurrency: group: tag-release-${{ github.ref }} cancel-in-progress: true jobs: detect-release-parameters: runs-on: ubuntu-latest outputs: notes: ${{ steps.generate_notes.outputs.notes }} steps: - name: Setup Python uses: actions/setup-python@v5 - name: Checkout Repository uses: actions/checkout@v4 with: fetch-depth: 0 - name: Get release notes id: generate_notes uses: anmarkoulis/commitizen-changelog-reader@v1.2.0 with: tag_name: ${{ github.ref }} changelog: CHANGELOG.md release: runs-on: ubuntu-20.04 needs: detect-release-parameters steps: - name: Checkout repo uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: "3.10" - name: Install dependencies run: | python -m pip install --upgrade pip pip install poetry - name: Configure pypi token run: | poetry config pypi-token.pypi ${{ secrets.PYPI_TOKEN }} - name: Build and publish package run: | poetry publish --build release-github: runs-on: ubuntu-latest needs: [release, detect-release-parameters] steps: - name: Checkout Repository uses: actions/checkout@v4 - name: Create Release Notes File run: | echo "${{ join(fromJson(needs.detect-release-parameters.outputs.notes).notes, '') }}" > release_notes.txt - name: Create GitHub Release env: GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} VERSION: ${{ github.ref_name }} run: | gh release create ${{ github.ref }} \ --title "Release $VERSION" \ --notes-file "release_notes.txt"
Explanation:
To ensure the workflows can perform actions like creating commits and tagging releases, you’ll need to set up a Personal Access Token (PAT) in your GitHub repository:
This token is crucial because it allows the workflow to push changes (like the updated changelog and version bump) back to the repository.
After running the workflows, a CHANGELOG.md file will be generated and updated automatically. Here’s an example of what it might look like:
## v2.0.0 (2021-03-31) ### Feat - **api**: change response of me endpoint ## v1.0.1 (2021-03-30) ### Fix - **api**: handle null values in the response ## v1.0.0 (2021-03-30) ### Feat - **parser**: add support for parsing new file formats
This CHANGELOG.md is automatically updated by Commitizen each time a new version is released. It categorizes changes into different sections (e.g., Feat, Fix), making it easy for users and developers to see what's new in each version.
Finally, here’s what a GitHub release looks like after being created by the workflow:
Incorrect Token Permissions: If the workflow fails due to permission errors, ensure that the PAT has the necessary scopes (e.g., repo, workflow).
Commitizen Parsing Issues: If Commitizen fails to parse commit messages, double-check the commit format and ensure it's consistent with the expected format.
Bump Commit Conflicts: If conflicts arise when the bump commit tries to merge into the main branch, you might need to manually resolve the conflicts or adjust your workflow to handle them.
Concurrent Executions: Without proper concurrency control, multiple commits or tags being processed simultaneously can lead to issues like duplicate version bumps or race conditions. This can result in multiple commits with the same version or incomplete releases. To avoid this, we’ve added concurrency settings to both workflows to ensure only one instance runs at a time for each branch or tag.
Automating the release process of your Python library with GitHub Actions and Commitizen not only saves time but also ensures consistency and reduces human errors. With this setup, you can focus more on developing new features and less on the repetitive tasks of managing releases.
As a next step, consider extending your CI/CD pipeline to include automated testing, code quality checks, or even security scans. This would further enhance the robustness of your release process.
If you found this post helpful, please feel free to share it with others who might benefit. I’d love to hear your thoughts or any questions you might have in the comments below. Have you implemented similar workflows in your projects? Share your experiences!
위 내용은 GitHub Actions 및 Commitizen을 사용하여 Python 라이브러리 릴리스 자동화의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!