Skip to content

Commit 023955b

Browse files
committed
Add README
1 parent 180251e commit 023955b

File tree

1 file changed

+32
-4
lines changed

1 file changed

+32
-4
lines changed

README.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,13 @@
11
# eps-workflow-quality-checks
2-
A workflow to run the quality checks for EPS repositories
2+
A workflow to run the quality checks for EPS repositories. The steps executed by this script are as follows:
3+
4+
- **Install Project Dependencies**
5+
- **Generate and Check SBOMs**: Creates Software Bill of Materials (SBOMs) to track dependencies for security and compliance. Uses [THIS](https://github.com/NHSDigital/eps-action-sbom) action.
6+
- **Run Linting**
7+
- **Run Unit Tests**
8+
- **SonarCloud Scan**: Performs code analysis using SonarCloud to detect quality issues and vulnerabilities.
9+
- **Validate CloudFormation Templates** (*Conditional*): If CloudFormation or AWS SAM templates are present, runs `cfn-lint` and `cfn-guard` to validate templates against AWS best practices and security rules.
10+
- **Check Python Licenses** (*Conditional*): If the project uses Poetry, scans Python dependencies for incompatible licenses.
311

412
# Usage
513

@@ -14,13 +22,33 @@ One of `[18, 20, 22]`. SBOM generations requires knowing which version of nodeJS
1422
In order to run, these `make` commands must be present. They may be mocked, if they are not relevant to the project.
1523

1624
- `install`
17-
- `check-licenses`
1825
- `lint`
1926
- `test`
20-
- `cfn-guard`
2127

2228
## Environment variables
2329

2430
### `SONAR_TOKEN`
2531

26-
Required for the SonarCloud Scan step, which analyzes your code for quality and security issues using SonarCloud.
32+
Required for the SonarCloud Scan step, which analyzes your code for quality and security issues using SonarCloud.
33+
34+
# Example Workflow Call
35+
36+
To use this workflow in your repository, call it from another workflow file:
37+
38+
```yaml
39+
name: Quality Checks
40+
41+
on:
42+
push:
43+
branches:
44+
- main
45+
- develop
46+
47+
jobs:
48+
quality_checks:
49+
uses: NHSDigital/eps-workflow-quality-checks/.github/workflows/quality-checks.yml@v1
50+
with:
51+
node_version: '20'
52+
secrets:
53+
SONAR_TOKEN: ${{ secrets.SONAR_TOKEN }}
54+
```

0 commit comments

Comments
 (0)