You need a Google Cloud Platform project
to run Spinnaker against. The next steps assume you’ve already created a
gcloud. You can check
gcloud is installed and authenticated by running:
If this is your first time deploying to App Engine in your project, create an App Engine application. You cannot change your application’s region, so pick wisely:
gcloud app create --region <e.g., us-central>
You will also need to enable the App Engine Admin API for your project:
gcloud service-management enable appengine.googleapis.com
Spinnaker does not need to be given service account credentials if it is running on a Google Compute Engine VM whose application default credentials have sufficient scopes to deploy to App Engine and Spinnaker is deploying to an App Engine application inside the same Google Cloud Platform project in which it is running. If Spinnaker will not need to be given service account credentials, or if you already have such a service account with the corresponding JSON key downloaded, skip ahead to Adding an Account.
Run the following commands to create a service account
roles/storage.admin roles enabled:
SERVICE_ACCOUNT_NAME=spinnaker-appengine-account SERVICE_ACCOUNT_DEST=~/.gcp/appengine-account.json gcloud iam service-accounts create \ $SERVICE_ACCOUNT_NAME \ --display-name $SERVICE_ACCOUNT_NAME SA_EMAIL=$(gcloud iam service-accounts list \ --filter="displayName:$SERVICE_ACCOUNT_NAME" \ --format='value(email)') PROJECT=$(gcloud info --format='value(config.project)') gcloud projects add-iam-policy-binding $PROJECT \ --role roles/storage.admin \ --member serviceAccount:$SA_EMAIL gcloud projects add-iam-policy-binding $PROJECT \ --role roles/appengine.appAdmin \ --member serviceAccount:$SA_EMAIL mkdir -p $(dirname $SERVICE_ACCOUNT_DEST) gcloud iam service-accounts keys create $SERVICE_ACCOUNT_DEST \ --iam-account $SA_EMAIL
Your service account JSON key now sits inside
Adding an Account
First, make sure that the provider is enabled:
hal config provider appengine enable
Next, run the following
hal command to add an account named
my-appengine-account to your list of App Engine accounts:
hal config provider appengine account add my-appengine-account \ --project $PROJECT \ --json-path $SERVICE_ACCOUNT_DEST
You can omit the
--json-path flag if Spinnaker does not need service account credentials.
Deploying to App Engine
Deploying from Git
Spinnaker supports deploying your source code to App Engine by cloning your application’s git repository and submitting it to App Engine. Unless your code is public, Spinnaker needs a mechanism to authenticate with your repositories - many of the configuration flags for App Engine manage this authentication.
You can view the available configuration flags for App Engine within the Halyard reference.
Deploying from Storage
Much like deploying from Git, Spinnaker also supports deploying your source code to App Engine from a Google Cloud Storage bucket. This method of deploying requires you to bundle your code into a .tar archive and then store that on GCS. When the deploy stage executes, Spinnaker will fetch your tar archive, untar it, and then deploy the code to App Engine.
Deploying from Google Container Registry URL
Spinnaker supports deploying Docker containers on the App Engine Flex runtime from images built and stored in Google Container Registry from just a gcr.io URL. This feature is currently flagged because it is still quite new.
In order to enable this feature, set the flag with Halyard like so:
hal config features edit --appengine-container-image-url-deployments true
After doing this you’ll find an option in the Create Server Group modal in Deck to use a Container Image as a deployment’s Source Type.
Selecting the Container Image option reveals a textbox that can then be used to specify the gcr.io URL. Alternatively you can use an Artifact as the source of the container image URL.