created_at2024-03-16 09:51:25.143178
updated_at2024-05-02 18:20:02.301403
descriptionA rust ci/cd template for github
Ame (ameknite)



Rust CI/CD template

License Minimum Supported Rust Version CI

Template to maintain a rust project running CI/CD with Github Workflows.

CI Workflow



This workflow will run every time you push to main or make a pull request. You can also run the workflow manually in github.

It will run:

CD Workflow

CD-1 CD-2


This workflow will only run manually through GitHub.

It will:

  • Validate your input version with regex (e.g. v3.1.4-alpha+159).

  • Run the ci workflow.

  • Run cargo semver-checks:

    • Lint your crate API changes for semver violations.
    • This will only run if you crate is a library.
    • Uses your previous tag as a baseline.
  • Run add-notice:

    • Add header notices to your rust files.
    • Check for the NOTICEe file.
    • Auto-commit.
  • Run cargo-bump:

    • Bump the current version of the Cargo.toml file.
    • Uses the input version if provided.
    • Auto-commit.
  • Run cargo-attributions:

    • Comply with licenses distribution.
    • Add licenses, notices and metadata of your dependencies.
    • Crate an attribution folder
    • Auto-commit.
  • Create a new tag:

    • Uses the input version if provided.
    • It's created only if the tag not exists.
  • Create a new github release:

    • Uses create-gh-release-action
    • Includes your changelog if matches the same version.
    • Uses the created tag as a reference.
  • Build and Release in Github:

    • Using upload-rust-binary-action
    • And setup-cross-toolchain-action
    • Only builds if your crate contains a binary crate.
    • Uses the created tag as a reference.
    • Bundle the attribution folder with licenses and notices.
    • Create checksum with sha256.
    • It builds for linux: gnu (x86_64|aarch64|riscv64gc) and musl (x86_64|aarch64).
    • It builds for windows: msvc (x86_64|aarch64) and gnu (x86_64).
    • It builds for mac-os (x86_64|aarch64).
  • Publish the create to

    • Only if you have the secrets.CARGO_REGISTRY_TOKEN variable added to repository secrets.
    • Path: Settings -> Security -> Secrets and variables -> Actions -> Repository secrets.

How to use the Build and Release workflow

You will run this directly in your Github repo -> Section Actions -> [Main] Build & Release workflow. -> Run workflow button.

Build and Release Workflow

Here you can do three things to run the workflow:

  1. Write the new version you want to release: - The version is in the form of:

    • Version parts: ${MAJOR}.${MINOR}.${PATCH}-${PRE-RELEASE}+${BUILD}
    • Example: 3.1.4-alpha+159
  2. Select the release_type you want:

    • patch, minor and major.
    • It will use your current crate version as a baseline.
    • Keep in none if you only want the writing version.
  3. Keep all with the defaults (without version and release_type = none)

    • It will use your current crate version as a baseline.
    • Run if you already update your crate version.
    • Useful for testing when you already run the workflow.


This template includes a setup for dependabot and a workflow for auto-merge.

  • It will update packages for cargo and github-actions weekly.

  • For rust:

    • It will create pull request in groups.
    • One group for patch updates, one for minor updates and one for major updates.
    • It will auto-merge the pull request if passes ci.
  • For github-actions:

    • It will create a pull request in groups.
    • Only one group for the updates.
    • It will auto-merge the pull request if passes ci.

Other workflows

This template uses workflow call and workflow dispatch to reuse workflows and be able to run them individually. So you can run various jobs of the ci/cd workflows independently.

Some workflows to consider:

  • weekly-workflow
    • Run the ci workflow.
    • Add notices to new files.
    • Keep the licenses of your dependencies in sync with the dependabot updates.
  • msrv.yaml
    • This workflow includes a boolean to able to update your msrv.
      • It will run cargo-msrv to update your rust-version in Cargo.toml
      • If you uses the MSRV in your it will also updated it.
  • cache.yaml
    • To clean the caches generated for the workflows.
    • Run if you have problems with the cache.
  • add_notice.yaml
    • To replace and update your notices.
    • To apply notices to other kind of files.
    • To use different comment styles.
  • pre_release.yaml
    • run ci, cargo-semver-checks, add-notice, bump-version and update-attribution
  • publish.yaml
    • To publish your crate to

What to change if you want to use this template

Similar projects that might help you


SPDX-License-Identifier: CC0-1.0 OR MIT OR Apache-2.0

Licensed under a triple license at your option:

Commit count: 72

cargo fmt