Integrate resource manager support

[stephenplusplus]

Fixes #851

To Dos

• Tests
  • Unit
    • project.js
    • index.js
  • System
• Docs http://stephenplusplus.github.io/gcloud-node/#/docs/master/resource
  • readme https://github.com/stephenplusplus/gcloud-node/tree/spp--resource-manager
  • JSDocs
  • Build script
  • FE Overview

Preview

var gcoud = require('gcloud');
var resource = gcloud.resource({/*...*/});

// Resource Level:
resource.createProject('grape-spaceship-123', function(err) {}); // (not sure if this works, see "Problems")

resource.getProjects([options], function(err, projects) {});
resource.getProjects([options]).on('data', function(project) {});

// Project Level:
var myProject = resource.project('grape-spaceship-123');

myProject.delete(function(err, apiResponse) {});
myProject.restore(function(err, apiResponse) {});

myProject.getMetadata(function(err, metadata, apiResponse) {});
myProject.setMetadata({/*...*/}, function(err, apiResponse) {});

Problems

I haven't been able to create a project programmatically, receiving a 403 error:

My project (that has resource manager API enabled) can list my projects and get their metadata. However, I get a 403 when I try to create one:

REQUEST
  method: 'POST'
  uri: 'https://cloudresourcemanager.googleapis.com/v1beta1/projects/'
  json: { projectId: 'gcloud-tests-1441915137564' }
  headers
   { Authorization: 'Bearer /*token*/',
     'User-Agent': 'gcloud-node/0.21.0' }

RESPONSE
  https://cloudresourcemanager.googleapis.com/v1beta1/projects/
  403
  Error: The caller does not have permission

  vary: 'X-Origin, Referer, Origin,Accept-Encoding'
  'content-type': 'application/json; charset=UTF-8'
  date: 'Thu, 10 Sep 2015 20:02:52 GMT'
  server: 'ESF'
  'cache-control': 'private'
  'x-xss-protection': '1; mode=block'
  'x-frame-options': 'SAMEORIGIN'
  'x-content-type-options': 'nosniff'
  'alternate-protocol': '443:quic,p=1'
  'alt-svc': 'quic=":443"; p="1"; ma=604800'
  'accept-ranges': 'none'
  connection: 'close'

I'm not sure how to auth this one; so far, gcloud lets users control one project's sub-services using a service account for it. What do we need to get to have control over all of their projects?

Maybe we just want to support modifying the project the user is on already? Deleting, undeleting, getting and setting metadata?

[jgeewax]

/cc @dhermes re system testing... I forget what we said here, I think it
may have been "meh, let's punt on that until service accounts can create
projects and stuff..." Correct me if I'm wrong?

On Fri, Sep 11, 2015 at 1:59 PM, Stephen Sawchuk [email protected]
wrote:

Fixes #851 #851
To Dos

• Tests
  • Unit
    • project.js
    • index.js
  • System (Having issues with this...)
• Docs
  • JSDocs
  • Build script
  • FE Overview

Problems

I haven't been able to create a project programmatically, receiving a 403
error:

My project (that has resource manager API enabled) can list my projects
and get their metadata. However, I get a 403 when I try to create one:

REQUEST
method: 'POST'
uri: 'https://cloudresourcemanager.googleapis.com/v1beta1/projects/'
json: { projectId: 'gcloud-tests-1441915137564' }
headers
{ Authorization: 'Bearer /token/',
'User-Agent': 'gcloud-node/0.21.0' }

RESPONSE
https://cloudresourcemanager.googleapis.com/v1beta1/projects/
403
Error: The caller does not have permission

vary: 'X-Origin, Referer, Origin,Accept-Encoding'
'content-type': 'application/json; charset=UTF-8'
date: 'Thu, 10 Sep 2015 20:02:52 GMT'
server: 'ESF'
'cache-control': 'private'
'x-xss-protection': '1; mode=block'
'x-frame-options': 'SAMEORIGIN'
'x-content-type-options': 'nosniff'
'alternate-protocol': '443:quic,p=1'
'alt-svc': 'quic=":443"; p="1"; ma=604800'
'accept-ranges': 'none'
connection: 'close'

I'm not sure how to auth this one; so far, gcloud lets users control one
project's sub-services using a service account for it. What do we need to
get to have control over all of their projects?

Maybe we just want to support modifying the project the user is on

already? Deleting, undeleting, getting and setting metadata?

You can view, comment on, or merge this pull request online at:

#860
Commit Summary

• Integrate resource manager support

File Changes

• A docs/json/master/resource/.gitkeep
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-0
  (0)
• M docs/site/components/docs/docs-values.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-1
  (16)
• M lib/common/util.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-2
  (6)
• M lib/index.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-3
  (23)
• A lib/resource/index.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-4
  (299)
• A lib/resource/project.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-5
  (197)
• M scripts/docs.sh
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-6
  (3)
• A system-test/resource.js
  https://github.com/GoogleCloudPlatform/gcloud-node/pull/860/files#diff-7
  (92)

Patch Links:

• https://github.com/GoogleCloudPlatform/gcloud-node/pull/860.patch
• https://github.com/GoogleCloudPlatform/gcloud-node/pull/860.diff

—
Reply to this email directly or view it on GitHub
#860.

[stephenplusplus]

Checked off all the bullet points. It's ready to merge with these methods currently implemented and unit tested, but not exposed to our docs:

• resource.createProject
• project.delete
• project.restore
• project.setMetadata

These methods are exposed:

• resource.getProjects
• project.getMetadata

[callmehiphop]

Looks good, thanks! Should we open a separate issue to keep track of project creation, etc.?

[stephenplusplus]

Done!

[callmehiphop]

👍

[callmehiphop]

@jgeewax can you enable the resource manager api on the Travis project?

[jgeewax]

Done.

[callmehiphop]

Thanks!