Add guide for Google Cloud Engine. #6350

Closed
wants to merge 1 commit into
from

Conversation

Projects
None yet
3 participants
Contributor

fcuny commented Mar 9, 2014

This is a first attempt to document the GCE modules.

Please bear in mind that I'm not a native speaker, but I'm more than happy to improve and update this PR.

(cc @erjohnso).

Thanks.

Contributor

mpdehaan commented Mar 9, 2014

Very nice! This comes at a very good time actually.

I hope to get this reviewed and up this week. Thanks very much!

@mpdehaan mpdehaan self-assigned this Mar 9, 2014

docsite/rst/guide_gce.rst
@@ -0,0 +1,186 @@
+ Google Web Services Guide
@erjohnso

erjohnso Mar 10, 2014

Member

Google marketing folks would prefer "Google Cloud Platform Guide" if you don't mind.

docsite/rst/guide_gce.rst
+Credentials
+-----------
+
+To work with the GCE modules, you'll first need some to get some credentials. You can create new one from the `console <https://console.developers.google.com/>`_ by going to the "APIs and Auth" section. Once you've created a new client ID and downloaded the generated private key (in the pkcs2 format), you'll need to convert the key by running the following command:
@erjohnso

erjohnso Mar 10, 2014

Member

...you'll first need to get some credentials. Remove extra "some".

@erjohnso

erjohnso Mar 10, 2014

Member

pkcs2 -> pkcs12

docsite/rst/guide_gce.rst
+
+.. code-block:: python
+
+ GCE_PARAMS = ('i...@project.googleusercontent.com', 'secret')
@erjohnso

erjohnso Mar 10, 2014

Member

Suggest using a path notation, 'secret' -> '/path/to/project.pem'

Member

erjohnso commented Mar 10, 2014

Great work @franckcuny! I had a few small suggestions but otherwise, this is really great to see and thank you!

Contributor

fcuny commented Mar 12, 2014

I've fixed all the suggestions. This should be good to go.

Contributor

mpdehaan commented Mar 14, 2014

Working on merging this in now!

Contributor

mpdehaan commented Mar 14, 2014

All merged in, I also updated this a bit to show the usage of tags rather than hostnames to manage cloud "more like cloud", and also updated somethings stylistically to make them not have to rely on "local_action" which makes formatting a little better.

Some of these changes have not had the full benefit of testing and review, so if you would like to help look these over I can easily push updates.

That all being said, this is now integrated into the docs and I'll be kicking off a docs build/push ...
NOW.

Other upgrades are of course also welcome -- like maybe crosslinking to the GCE modules pages?

Thanks very much for this, great to see the guide sections being built out further.

Much appreciated!

@mpdehaan mpdehaan closed this Mar 14, 2014

@fcuny fcuny deleted the fcuny:gce-doc branch Sep 29, 2014

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment