Skip to content

Commit 5044dca

Browse files
committed
Update readme
1 parent a06e670 commit 5044dca

File tree

1 file changed

+84
-0
lines changed

1 file changed

+84
-0
lines changed

README.md

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
# Dev Proxy GitHub Actions
2+
3+
A collection of GitHub Actions for using [Dev Proxy](https://aka.ms/devproxy) in your GitHub Action workflows.
4+
5+
## Actions
6+
7+
- [`install`](#install) - Install Dev Proxy
8+
- [`start`](#start) - Start Dev Proxy
9+
- [`stop`](#stop) - Stop Dev Proxy instance
10+
- [`record-start`](#record-start) - Start recording mode
11+
- [`record-stop`](#record-stop) - Stop recording mode
12+
13+
## Usage
14+
15+
### Install
16+
17+
Install Dev Proxy in your workflow. You can specify a version or use the latest.
18+
19+
```yaml
20+
- name: Install Dev Proxy
21+
uses: dev-proxy-tools/actions/install@main
22+
with:
23+
version: v0.29.2
24+
```
25+
26+
**Inputs:**
27+
28+
| Name | Description | Required | Default |
29+
|------|-------------|----------|---------|
30+
| `version` | Version of Dev Proxy to install (e.g., v0.29.2) | No | latest |
31+
32+
### Start
33+
34+
Start Dev Proxy with optional configuration file. Dev Proxy will run in the background and log its output to a specified file.
35+
36+
```yaml
37+
- name: Start Dev Proxy
38+
uses: dev-proxy-tools/actions/start@main
39+
with:
40+
logFile: devproxy.log # optional, defaults to devproxy.log
41+
configFile: ./devproxy.json # optional, defaults to devproxyrc.json
42+
```
43+
44+
**Inputs:**
45+
46+
| Name | Description | Required | Default |
47+
|------|-------------|----------|---------|
48+
| `logFile` | The file to log Dev Proxy output to | Yes | `devproxy.log` |
49+
| `configFile` | The path to the Dev Proxy configuration file | No | - |
50+
51+
### Stop
52+
53+
Stop the running Dev Proxy instance.
54+
55+
```yaml
56+
- name: Stop Dev Proxy
57+
uses: dev-proxy-tools/actions/stop@main
58+
```
59+
60+
### Record Start
61+
62+
Start recording mode.
63+
64+
```yaml
65+
- name: Start recording
66+
uses: dev-proxy-tools/actions/record-start@main
67+
```
68+
69+
### Record Stop
70+
71+
Stop recording mode.
72+
73+
```yaml
74+
- name: Stop recording
75+
uses: dev-proxy-tools/actions/record-stop@main
76+
```
77+
78+
## License
79+
80+
This project is licensed under the terms specified in the [LICENSE](LICENSE) file.
81+
82+
## Contributing
83+
84+
Contributions are welcome! Please feel free to submit a Pull Request.

0 commit comments

Comments
 (0)