Ansys actions

A repository containing a collection of GitHub Workflows to be reused by projects in the Ansys ecosystem.

For more information on available actions and how to use them, see actions.docs.ansys.com.

Recommended workflow strategy

The different actions provided by ansys/actions can be used to create a simple but effective workflow.

The following lines describe the suggested workflows for various events, such as pushing a new commit to a pull request, merging a commit to the main branch of a repository, and performing a new release. Each image showcases the distinct job steps declared in a YML file. Jobs highlighted in green signify that they execute, while those with a blue background indicate that they do not execute.

For additional in-depth information refer to the poster CI/CD pipelines for scientists.

Recommended workflow when pushing a new commit to a pull-request

This workflow is recommended to ensure that the code ready to be merged is compliant with the project style, its code integrity, and that it is capable of successfully generating all the desired library artifacts.

graph LR
    A(Doc style) --> B(Doc build)
    C(Code style) --> D(Tests)
    B & D --> E(Build library) --> F(Release library) & H(Doc deploy dev)
    F --> G(Doc deploy stable)

    classDef green fill:green, fill-opacity:0.5, stroke:green, stroke-width:2
    class A,B,C,D,E green
    classDef blue fill:lightblue, fill-opacity:0.5, stroke:lightblue
    class F,H,G blue

Loading

Recommended workflow when merging a new commit to the main branch of a repository

This workflow is similar to the one for validating new code contributions in a pull-request, but it also deploys the development documentation as new changes were introduced in the main development branch.

graph LR
    A(Doc style) --> B(Doc build)
    C(Code style) --> D(Tests)
    B & D --> E(Build library) --> F(Release library) & H(Doc deploy dev)
    F --> G(Doc deploy stable)

    classDef green fill:green, fill-opacity:0.5, stroke:green, stroke-width:2
    class A,B,C,D,E,H green
    classDef blue fill:lightblue, fill-opacity:0.5, stroke:lightblue
    class F,G blue

Loading

Recommended workflow when performing a new release

This workflow outlines the recommended steps for performing a new software release, ensuring a smooth and well-documented process by deploying the stable documentation at the end of the workflow.

graph LR
    A(Doc style) --> B(Doc build)
    C(Code style) --> D(Tests)
    B & D --> E(Build library) --> F(Release library) & H(Doc deploy dev)
    F --> G(Doc deploy stable)

    classDef green fill:green, fill-opacity:0.5, stroke:green, stroke-width:2
    class A,B,C,D,E,F,G green
    classDef blue fill:lightblue, fill-opacity:0.5, stroke:lightblue
    class H blue

Loading