Skip to content

CircleCI orb for connecting to a WireGuard VPN

License

Notifications You must be signed in to change notification settings

titel-media/wireguard-orb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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.