cicd-setup

使用GitHub Actions为Python项目设置CI/CD流水线。包含PR检查、通过SSH部署、pre-commit钩子和电子邮件通知的模板。当用户想要为Python项目创建新的CI/CD流水线时使用此技能。

📖 中文导读:使用GitHub Actions为Python项目设置CI/CD流水线。包含PR检查、通过SSH部署、pre-commit钩子和电子邮件通知的模板。当用户想要为Python项目创建新的CI/CD流水线时使用此技能。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: cicd-setup description: "Sets up a CI/CD pipeline for Python projects using GitHub Actions. Includes templates for PR checks, deployment via SSH, pre-commit hooks, and email notifications. Use this skill when a user wants to create a new CI/CD pipeline for a Python project."

CI/CD Pipeline Setup Skill

This skill provides templates and guides to set up a CI/CD pipeline for a Python project using GitHub Actions.

Core Workflow

  1. Set up Pre-commit Hooks:

    • Copy the .pre-commit-config.yaml from assets/pre-commit/ to the root of the user's repository.
    • Guide the user to install pre-commit (pip install pre-commit) and set it up (pre-commit install).
  2. Set up GitHub Actions Workflows:

    • Create a .github/workflows/ directory in the user's repository if it doesn't exist.
    • Copy assets/github_actions/python_pr_workflow.yml to .github/workflows/. This workflow runs tests and linting on every pull request to main.
    • Copy assets/github_actions/python_deploy_workflow.yml to .github/workflows/. This workflow deploys the application when a PR is merged to main.
  3. Configure Secrets:

    • Guide the user to add the necessary secrets for deployment and notifications as described in references/secret_management.md.
  4. Set Up Branch Protection:

    • Guide the user through setting up branch protection rules for the main branch as detailed in references/branch_protection.md.

Bundled Resources

Assets

  • assets/github_actions/python_pr_workflow.yml: Workflow to run checks on pull requests.
  • assets/github_actions/python_deploy_workflow.yml: Workflow to deploy on merge to main.
  • assets/notifications/email_notification_template.txt: Template for email notifications on successful deployment.
  • assets/pre-commit/.pre-commit-config.yaml: Configuration for pre-commit hooks for Python projects.

References

  • references/secret_management.md: How to configure secrets for SSH and email.
  • references/caching_strategies.md: Explanation of caching for Python dependencies.
  • references/branch_protection.md: How to set up branch protection rules in GitHub.

Before starting, ask the user if they use requirements.txt, poetry, or pipenv for dependency management and adjust the caching steps in the workflows if necessary.