aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2021-08-07 22:59:41 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2021-08-07 22:59:41 +0300
commit52bef20ac0cf5e9158ac6cec217cb8b857348186 (patch)
tree728e8b2fe5ab8d531344c4ac15fcb87285e316a0
parentadd the actual action code (diff)
downloadsetup-wireguard-52bef20ac0cf5e9158ac6cec217cb8b857348186.tar.gz
setup-wireguard-52bef20ac0cf5e9158ac6cec217cb8b857348186.zip
README: update
-rw-r--r--README.md38
-rw-r--r--action.yml8
2 files changed, 42 insertions, 4 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
-------
diff --git a/action.yml b/action.yml
index 77e4827..f8b2982 100644
--- a/action.yml
+++ b/action.yml
@@ -11,15 +11,15 @@ inputs:
ips:
description: Comma-separated list of IP addresses
required: true
+ allowed_ips:
+ description: Comma-separated list of netmasks
+ required: true
private_key:
description: Private key
required: true
preshared_key:
description: Preshared key
required: false
- allowed_ips:
- description: Comma-separated list of netmasks
- required: true
runs:
using: composite
@@ -30,9 +30,9 @@ runs:
readonly endpoint='${{ inputs.endpoint }}'
readonly endpoint_public_key='${{ inputs.endpoint_public_key }}'
readonly ips='${{ inputs.ips }}'
+ readonly allowed_ips='${{ inputs.allowed_ips }}'
readonly private_key='${{ inputs.private_key }}'
readonly preshared_key='${{ inputs.preshared_key }}'
- readonly allowed_ips='${{ inputs.allowed_ips }}'
readonly minport=51000
readonly maxport=51999