aboutsummaryrefslogtreecommitdiffstatshomepage
path: root/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'README.md')
-rw-r--r--README.md38
1 files changed, 38 insertions, 0 deletions
diff --git a/README.md b/README.md
index 05a76ba..e3cff70 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,44 @@ This GitHub action sets up a WireGuard connection in your workflow run.
1. Installs WireGuard if it's missing.
2. Sets up a connection using the provided credentials.
+Use it your workflow like this:
+
+ - name: Set up WireGuard
+ uses: egor-tensin/setup-wireguard@v1
+ with:
+ endpoint: 46.46.46.46:51820
+ endpoint_public_key: 9IHlvJqgkVWMq57a0A56XI5IjhnL5gaRhI1Pszk7S24=
+ ips: 192.168.143.254/24,fd8c:bc10:5021::192.168.143.254/48
+ private_key: GLEiXhRwFuhw8aPy+HQfSMwwoLU0Sw8jE8MOxZ8GV3w=
+ preshared_key: PWAfvVWCjiNV0Uh2DhmXhdRaT326qosSOcaDB3j9dwI=
+ allowed_ips: 192.168.143.0/24,fd8c:bc10:5021::/48
+
+Of couse it's highly advised to store all sensitive data in your repository's
+secrets.
+It could then become something like:
+
+ - name: Set up WireGuard
+ uses: egor-tensin/setup-wireguard@v1
+ with:
+ endpoint: '${{ secrets.ENDPOINT }}'
+ endpoint_public_key: '${{ secrets.ENDPOINT_PUBLIC }}'
+ ips: '${{ secrets.IPS }}'
+ allowed_ips: '${{ secrets.ALLOWED_IPS }}'
+ private_key: '${{ secrets.PRIVATE }}'
+ preshared_key: '${{ secrets.PRESHARED }}'
+
+API
+---
+
+| Input | Example | Description
+| ------------------- | ----------------------------------------------------- | -----------
+| endpoint | 46.46.46.46:51820 | Endpoint to connect to in the HOST:PORT format.
+| endpoint_public_key | 9IHlvJqgkVWMq57a0A56XI5IjhnL5gaRhI1Pszk7S24= | Endpoint's public key.
+| ips | 192.168.143.254/24,fd8c:bc10:5021::192.168.143.254/48 | Comma-separated list of IP addresses to assign to the VM.
+| allowed_ips | 192.168.143.0/24,fd8c:bc10:5021::/48 | Comma-separated list of netmasks.
+| private_key | GLEiXhRwFuhw8aPy+HQfSMwwoLU0Sw8jE8MOxZ8GV3w= | Private key of the VM.
+| preshared_key | PWAfvVWCjiNV0Uh2DhmXhdRaT326qosSOcaDB3j9dwI= | Preshared key assigned to the VM.
+
License
-------