Skip to content

Latest commit

 

History

History
53 lines (32 loc) · 2.13 KB

README.md

File metadata and controls

53 lines (32 loc) · 2.13 KB

wireguard-orb CircleCI Build Status CircleCI Orb Version GitHub License

CircleCI orb for connecting to a WireGuard VPN

It allows you to establish a WireGuard VPN connection from within a CircleCI build job.

Prerequisites

The following environment variables need to be set in CircleCI either directly or via a context:

  • WIREGUARD_CONFIG

Variable has to contain a Base64 encoded WireGuard VPN config file

$ cat <<EOF | base64
> [Interface]
> PrivateKey = <private-key>=
> Address = 192.0.0.1/32
> DNS = 10.0.0.13
>
> [Peer]
> PublicKey = <public-key>=
> AllowedIPs = 0.0.0.0/0
> Endpoint = 50.210.50.3:51820
> EOF

If AllowedIPs is "0.0.0.0/0" the CircleCI container will stop responding and the build will crush. To avoid this "0.0.0.0/0" will be replaced with the public IP of the current job while execution.

See CircleCI Documentation for instructions on how you would set this up.

Usage

Example use as well as a list of available executors, commands, and jobs are available on this orb's registry page.

Resources

CircleCI Orb Registry Page - The official registry page for this orb will all versions, executors, commands, and jobs described. CircleCI Orb Docs - Docs for using and creating CircleCI Orbs.

Contributing

We welcome issues to and pull requests against this repository!

Publishing

New versions of this orb are published by pushing a SemVer git tag by the Community & Partner Engineering Team.