Skip to content

Commit 1071107

Browse files
committed
docs: Updated README
1 parent a70dd3f commit 1071107

File tree

1 file changed

+104
-1
lines changed

1 file changed

+104
-1
lines changed

README.md

Lines changed: 104 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1,104 @@
1-
# pipelines
1+
# Daily DevOps & .NET - Pipelines
2+
3+
This repository contains several workflow templates for the daily usage inside the Daily DevOps & .NET team. We try to automate as much as possible to make our lives easier. For that reason, we have created several GitHub Actions workflows that will help us to automate the process of building, testing, and deploying our applications.
4+
5+
## Workflows
6+
7+
At the moment, we have concentrated on creating workflows for .NET applications. We have created two different workflows for .NET applications. These are a composition of several jobs that will help us to automate the process of building, testing, and deploying our applications.
8+
9+
All jobs are separated into templates that can be reused in other workflows. More details about the templates can be found in the [Templates](#templates) section.
10+
11+
### `ci-dotnet-fast.yml`
12+
13+
### `ci-dotnet.yml`
14+
15+
## Templates
16+
17+
### `step-dependabot-merge.yml`
18+
19+
This template is used to merge the pull request created by the dependabot. The template will check if the pull request is created by the dependabot and if the pull request is ready to be merged. If the conditions are met, the pull request will be merged.
20+
21+
To use this template, you need to add the following code to your workflow file:
22+
23+
```yaml
24+
jobs:
25+
merge-dependabot:
26+
runs-on: ubuntu-latest
27+
steps:
28+
- uses: dailydevops/pipelines/.github/workflows/step-dependabot-merge.yml@0.12.16
29+
secrets: inherits
30+
```
31+
32+
#### Secrets
33+
34+
This step requires the secret `DEPENDABOT` to be set in the repository. The secret should contain the GitHub token that has the permissions to merge the pull requests.
35+
36+
### `step-dotnet-build.yml`
37+
38+
This template is used to build the .NET application. The template will build the application using the `dotnet build` command, and upload the build artifacts to the GitHub as an artifact `release-packages`.
39+
40+
To use this template, you need to add the following code to your workflow file:
41+
42+
```yaml
43+
jobs:
44+
build:
45+
runs-on: ubuntu-latest
46+
steps:
47+
- uses: dailydevops/pipelines/.github/workflows/step-dotnet-build.yml@0.12.16
48+
with:
49+
solution: "src/MyApp.sln"
50+
```
51+
52+
#### Parameters
53+
54+
| Parameter | Description | Required | Default |
55+
| ---------------- | ---------------------------------------------- | :------: | --------------- |
56+
| `disablePublish` | Disable the publishing of the build artifacts. | ❌ | `false` |
57+
| `dotnet-logging` | The verbosity of the dotnet build command. | ❌ | `quiet` |
58+
| `dotnet-version` | The version of the dotnet SDK to use. | ❌ | `8.x` |
59+
| `dotnet-quality` | The quality of the dotnet SDK to use. | ❌ | `ga` |
60+
| `runs-on` | The runner to use. | ❌ | `ubuntu-latest` |
61+
| `solution` | The path to the solution or project file. | ✅ | |
62+
63+
#### Secrets
64+
65+
This step has an _optional_ secret `FETCH_TOKEN` that can be used to fetch the dependencies from the private repositories. The secret should contain the GitHub token that has the permissions to fetch the dependencies. If the secret is not set, the dependencies will be fetched using the default `{{ github.token }}`.
66+
67+
### `step-dotnet-codeql.yml`
68+
69+
This template will analyze the application using the CodeQL and upload the analysis results to the GitHub as an artifact `codeql`.
70+
71+
To use this template, you need to add the following code to your workflow file:
72+
73+
```yaml
74+
jobs:
75+
codeql:
76+
runs-on: ubuntu-latest
77+
steps:
78+
- uses: dailydevops/pipelines/.github/workflows/step-dotnet-codeql.yml@0.12.16
79+
```
80+
81+
#### Parameters
82+
83+
| Parameter | Description | Required | Default |
84+
| ---------------- | ----------------------------------------- | :------: | --------------- |
85+
| `dotnet-version` | The version of the dotnet SDK to use. | ❌ | `8.x` |
86+
| `dotnet-quality` | The quality of the dotnet SDK to use. | ❌ | `ga` |
87+
| `runs-on` | The runner to use. | ❌ | `ubuntu-latest` |
88+
| `solution` | The path to the solution or project file. | ✅ | |
89+
90+
#### Secrets
91+
92+
This step has an _optional_ secret `FETCH_TOKEN` that can be used to fetch the dependencies from the private repositories. The secret should contain the GitHub token that has the permissions to fetch the dependencies. If the secret is not set, the dependencies will be fetched using the default `{{ github.token }}`.
93+
94+
### `step-dotnet-draft-release.yml`
95+
96+
### `step-dotnet-format.yml`
97+
98+
### `step-dotnet-publish-nuget.yml`
99+
100+
### `step-dotnet-tests.yml`
101+
102+
### `step-dotnet-version.yml`
103+
104+
### `step-node-commitlint.yml`

0 commit comments

Comments
 (0)