CODEWITHSUNDEEP
google-app-enginegcloud
Anthony Kong
Anthony Kong

Reputation: 40624

What permission is required for a service account to deploy to Google App Engine using gcloud?

I have created a service account in order to deploy a project to google app engine.

The service account I have created has these two roles:

  1. App Engine -> App Engine Deployer
  2. Storage -> Storage Object Admin

I downloaded the json key file, and then run these commands:

gcloud auth activate-service-account --key-file key.json
gcloud -q app deploy app_deploy.yaml --version 1.0 --promote

I got this error message:

ERROR: (gcloud.app.deploy) Error Response: [403] Operation not allowed

Details: [
  [
    {
      "@type": "type.googleapis.com/google.rpc.ResourceInfo",
      "description": "The \"appengine.applications.get\" permission is required.",
      "resourceType": "gae.api"
    }
  ]
]

What role did I miss to add?

Upvotes: 24

Views: 13977

Answers (7)

atlex2
atlex2

Reputation: 2624

I found the docs on the Github action deploy-appengine helpful: https://github.com/google-github-actions/deploy-appengine

The caller must have the following Google Cloud IAM Roles:

App Engine Admin (roles/appengine.appAdmin) to manage all App Engine resources and create new services and versions.

Storage Admin (roles/storage.admin) to upload files to Cloud Storage to store source artifacts.

Cloud Build Editor (roles/cloudbuild.builds.editor) to build the service.

Artifact Registry Reader (roles/artifactregistry.reader) to view & get artifacts for implementing CI/CD pipeline.

Service Account User (roles/iam.serviceAccountUser) permissions on the runtime service account to deploy the service. The default runtime service account is [email protected], but you can also customize the service account in your app.yaml file.

(optional) Cloud Scheduler Admin (roles/cloudscheduler.admin) to schedule tasks

Note: An owner will be needed to create the App Engine application.

Upvotes: 1

Benzi
Benzi

Reputation: 448

You can use App Engine Deployer or App Engine Admin

Depends on your needs.

In addition, according to the GCP App Engine doc, you need to add three more rolls; https://cloud.google.com/appengine/docs/standard/roles

To deploy new versions, you must also have the Service Account User (roles/iam.serviceAccountUser) role on the assigned App Engine service account, and the Cloud Build Editor (roles/cloudbuild.builds.editor), and Cloud Storage Object Admin (roles/storage.objectAdmin) roles on the project.

 roles/iam.serviceAccountUser
 roles/cloudbuild.builds.editor
 roles/storage.objectAdmin

Upvotes: 0

Kevin Aung
Kevin Aung

Reputation: 832

These roles worked for me. I'm using gcloud to deploy from AppVeyor.

  • App Engine Deployer
  • App Engine Service Admin
  • Cloud Build Service Account
  • Service Account User

Reference: https://github.com/google-github-actions/setup-gcloud/issues/191#issuecomment-706039046

Upvotes: 4

frankie567
frankie567

Reputation: 1760

As of January 2020, the documentation for App Engine Roles states:

Note: The App Engine Deployer (roles/appengine.deployer) role alone grants adequate permission to deploy using the App Engine Admin API. To use other App Engine tooling, like gcloud commands, you must also have the Compute Storage Admin (roles/compute.storageAdmin) and Cloud Build Editor (cloudbuild.builds.editor) roles.

However, this is not completely true:

  1. The cloudbuild.builds.editor is not sufficient (I suspect an error in the doc here). Indeed, the CLI apparently needs the storage.objects.list permission which is provided by cloudbuild.builds.builder.
  2. After deployment, you'll get an error because you don't have permission to change traffic splits. Thus, you need roles/appengine.serviceAdmin.

So, here is the roles list that worked for me:

  • roles/appengine.deployer
  • roles/appengine.serviceAdmin
  • roles/compute.storageAdmin
  • roles/cloudbuild.builds.builder

Upvotes: 13

faithonour
faithonour

Reputation: 401

You don't need to grant Admin role for Storage.

You should only need grant following roles for service account:

  • App Engine Deployer
  • Storage Object Creator for only bucket staging.<project-id>.appspot.com
  • Storage Object Viewer for only bucket staging.<project-id>.appspot.com

You may got some error because service account do not have permission to change traffic to new version (you have just deployed). But deploy was successful & you can migrate to new version from console.

Following is message from my case.

[INFO] GCLOUD: ERROR: (gcloud.app.deploy) Your deployment has succeeded, but promoting the new version to default failed. You may not have permissions to change traffic splits. Changing traffic splits requires the Owner, Editor, App Engine Admin, or App Engine Service Admin role. Please contact your project owner and use the gcloud app services set-traffic --splits <version>=1 command to redirect traffic to your newly deployed version.

Upvotes: 1

ingernet
ingernet

Reputation: 1524

I'm still parsing all of the various docs about this myself, but I stumbled upon this list of predefined GAE roles, complete with the definition of the permissions they had. "Deployer" seems like kind of a misnomer...they maybe should have called it "NewDeployer" or something like that. Hope this helps!

EDIT - here's also the App Engine-specific list of roles.

Cheers! inger

Upvotes: 1

Anthony Kong
Anthony Kong

Reputation: 40624

It works if I replace the role App Engine -> App Engine Deployer with App Engine -> App Engine Admin.

No idea why Deployer will not be sufficient for app deployment.

Upvotes: 11

Related Questions