Repository: libcloud Updated Branches: refs/heads/trunk a39c4e254 -> f70264647
Update GCE docs - use new links, add screenshots. Project: http://git-wip-us.apache.org/repos/asf/libcloud/repo Commit: http://git-wip-us.apache.org/repos/asf/libcloud/commit/4e730787 Tree: http://git-wip-us.apache.org/repos/asf/libcloud/tree/4e730787 Diff: http://git-wip-us.apache.org/repos/asf/libcloud/diff/4e730787 Branch: refs/heads/trunk Commit: 4e7307878789ce0a3a0cb2ca6aa6191a2dc88e87 Parents: a03877a Author: Tomaz Muraus <[email protected]> Authored: Thu Jan 4 10:25:30 2018 +0100 Committer: Tomaz Muraus <[email protected]> Committed: Thu Jan 4 10:30:56 2018 +0100 ---------------------------------------------------------------------- .../images/misc/gce/create_service_account.png | Bin 0 -> 46211 bytes docs/_static/images/misc/gce/iam_and_roles.png | Bin 0 -> 170197 bytes docs/_static/images/misc/gce/new_project.png | Bin 0 -> 17727 bytes .../images/misc/gce/project_dashboard.png | Bin 0 -> 117485 bytes .../images/misc/gce/view_service_accounts.png | Bin 0 -> 82062 bytes docs/compute/drivers/gce.rst | 49 +++++++++++++++++-- 6 files changed, 44 insertions(+), 5 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/_static/images/misc/gce/create_service_account.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/gce/create_service_account.png b/docs/_static/images/misc/gce/create_service_account.png new file mode 100644 index 0000000..92b5a96 Binary files /dev/null and b/docs/_static/images/misc/gce/create_service_account.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/_static/images/misc/gce/iam_and_roles.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/gce/iam_and_roles.png b/docs/_static/images/misc/gce/iam_and_roles.png new file mode 100644 index 0000000..de7f9a9 Binary files /dev/null and b/docs/_static/images/misc/gce/iam_and_roles.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/_static/images/misc/gce/new_project.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/gce/new_project.png b/docs/_static/images/misc/gce/new_project.png new file mode 100644 index 0000000..ff6f4a9 Binary files /dev/null and b/docs/_static/images/misc/gce/new_project.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/_static/images/misc/gce/project_dashboard.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/gce/project_dashboard.png b/docs/_static/images/misc/gce/project_dashboard.png new file mode 100644 index 0000000..aad2b2f Binary files /dev/null and b/docs/_static/images/misc/gce/project_dashboard.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/_static/images/misc/gce/view_service_accounts.png ---------------------------------------------------------------------- diff --git a/docs/_static/images/misc/gce/view_service_accounts.png b/docs/_static/images/misc/gce/view_service_accounts.png new file mode 100644 index 0000000..2d05cca Binary files /dev/null and b/docs/_static/images/misc/gce/view_service_accounts.png differ http://git-wip-us.apache.org/repos/asf/libcloud/blob/4e730787/docs/compute/drivers/gce.rst ---------------------------------------------------------------------- diff --git a/docs/compute/drivers/gce.rst b/docs/compute/drivers/gce.rst index 9f743aa..7435843 100644 --- a/docs/compute/drivers/gce.rst +++ b/docs/compute/drivers/gce.rst @@ -53,9 +53,18 @@ To set up Service Account authentication, you will need to download the corresponding private key file in either the new JSON (preferred) format, or the legacy P12 format. -1. Follow the instructions at - https://developers.google.com/console/help/new/#serviceaccounts - to create and download the private key. +1. Go to Google Cloud Console (https://console.cloud.google.com/) and create a + new project (https://console.cloud.google.com/projectcreate) or re-use an + existing one. + +.. figure:: /_static/images/misc/gce/create_service_account.png + :align: center + :width: 500 + +2. Select the existing or newly created project and go to IAM & Admin -> + Service Accounts -> Create service account to create a new service account. + Select "furnish a new private key" to create and download new private key you will + use to authenticate. a. If you opt for the new preferred JSON format, download the file and save it to a secure location. @@ -68,11 +77,41 @@ the legacy P12 format. Move the .pem file to a safe location -2. You will need the Service Account's "Email Address" and the path to the + +.. figure:: /_static/images/misc/gce/iam_and_roles.png + :align: center + :width: 500 + +.. figure:: /_static/images/misc/gce/create_service_account.png + :align: center + :width: 500 + +3. You will need the Service Account's "Email Address" and the path to the key file for authentication. -3. You will also need your "Project ID" (a string, not a numerical value) that + +.. figure:: /_static/images/misc/gce/view_service_accounts.png + :align: center + :width: 500 + +4. You will also need your "Project ID" (a string, not a numerical value) that can be found by clicking on the "Overview" link on the left sidebar. +.. figure:: /_static/images/misc/gce/project_dashboard.png + :align: center + :width: 500 + +5. You will also need to have billing information associated and enabled for + that project. If billing is not yet enabled for that project, error message + similar to the one below will be printed when you first run the code which + uses GCE driver: + +.. sourcecode:: python + + libcloud.common.google.GoogleBaseError: {u'domain': u'usageLimits', u'message': u'Access Not Configured. Compute Engine API has not been used in project 1029894677594 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/compute.googleapis.com/overview?project=1029894677594 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.', u'reason': u'accessNotConfigured', u'extendedHelp': u'https://console.developers.google.com/apis/api/compute.googleapis.com/overview?project=YYYYYYYY'} + +You can simply follow the link in the error message to configure and enable +billing. + Installed Application ~~~~~~~~~~~~~~~~~~~~~
