search

trailofbits / algo

Set up a personal VPN in the cloud
https://blog.trailofbits.com/2016/12/12/meet-algo-the-vpn-that-works/
GNU Affero General Public License v3.0
28.65k stars 2.31k forks source link

Better Documentation For Other Cloud Providers #682

Open RandomDSdevel opened 6 years ago

RandomDSdevel commented 6 years ago

OS/Environment

None yet, but I'm working on OS X v10.11.6 'El Capitan' client-side. (See 'The way of deployment (cloud or local)' below for details on considered server infrastructure.)

Ansible version

None yet, as I haven't yet gotten that far into setting up Algo.

Version of components from requirements.txt

Not applicable (see above.)

Summary of the problem

In the 'Additional Documentation' section of Algo's README.md, the bullet point on 'Cloud setup' of Algo on various cloud hosting services has only one child bullet item, namely one linking to instructions for cloud setup of Algo specific to Microsoft Azure.

Steps to reproduce the behavior

  1. View that section of the read-me either directly or via its mirror on Alog's main GitHub project page.
  2. Look for bullet items that are children of the one on 'Cloud setup.'

The way of deployment (cloud or local)

None yet, but I'm working on hosting on Google Cloud Platform.

Expected behavior

Finding links to documentation on how to set up a cloud deployment of Algo on multiple different hosting providers' infrastructure offerings in this project's read-me under the section cited was the sort of outcome I expected from the route of investigation described in this issue.

Actual behavior

A single link pointing to instructions specific to Microsoft Azure was all that I found in that section of the read-me.

Full logs

Not applicable; no logs (see 'OS/Environment' and 'The way of deployment (cloud or local)' above.)

Suggested resolution

Improve Algo's documentation to include instructions on how to set a cloud deployment of Algo up on all of the cloud platforms that it supports.

RandomDSdevel commented 6 years ago

Feel free to split the various aspects of this issue's resolution into multiple issues, leaving this one as a tracking issue or abandoning it altogether.

RandomDSdevel commented 6 years ago

For Amazon Web Services, this Lifehacker article could be adapted if it isn't too out of date.

RandomDSdevel commented 6 years ago

Now that I look for it, there does seem to be some documentation of the sort I was looking for, just not all together by cloud provider. It'd still be useful to have information, newly duplicated or just reformatted, organized that way, though…

chrisjensen commented 6 years ago

For Google Cloud Compute, here's the steps I needed to get it working.

(Before running ./algo)

  1. Create a service account and grant it owner permission for your GCE engine.
  2. Download and save the json credentials and take note of the location
  3. Enable the GCE API

(Then run ./algo)

jackivanov commented 6 years ago

These steps should be documented as well (https://github.com/trailofbits/algo/issues/658)

jackivanov commented 5 years ago

I think the only Lightsail and OpenStack are missing now

GearGit commented 4 years ago

Can I still work on this issue for Hacktoberfest?

jackivanov commented 4 years ago

@GearGit Yes! PRs welcome.

oliver44k commented 2 years ago

how can i use this vpn i subscribed already