AppEngine: Get current serving application version

user_56495 0
Viewed 11110

Is there a simple way to get the current serving application version in AppEngine?

google-app-engine
8 Answers

For nodejs, I am not sure if this is documented.

process.env.GAE_VERSION

user_54221340

You can also access the process' environment variables:

GAE_VERSION

which is available when you deploy (gcloud app deploy) using the flag --version

user_91789660

For those who want an update, environment variables set for a GAE instance as of September 2020:

GAE_VERSION is the one that seems to answer the original question.

Google doc:

https://cloud.google.com/appengine/docs/standard/python3/runtime#environment_variables

The following environment variables are set by the runtime:

Environment variable Description GAE_APPLICATION The ID of your App Engine application. This ID is prefixed with 'region code~' such as 'e~' for applications deployed in Europe.

GAE_DEPLOYMENT_ID The ID of the current deployment.

GAE_ENV The App Engine environment. Set to standard.

GAE_INSTANCE The ID of the instance on which your service is currently running.

GAE_MEMORY_MB The amount of memory available to the application process, in MB.

GAE_RUNTIME The runtime specified in your app.yaml file.

GAE_SERVICE The service name specified in your app.yaml file. If no service name is specified, it is set to default.

GAE_VERSION The current version label of your service.

GOOGLE_CLOUD_PROJECT The Cloud project ID associated with your application.

PORT The port that receives HTTP requests.

user_15596790

Based on my experiments today, there are two os.environ variables that you can use to get the current app version:

  1. os.environ['GAE_VERSION']: the version name only
  2. os.environ['CURRENT_VERSION_ID']: a unique version identifier composed of {version name}.{deployment id}, which is equivalent to os.environ['GAE_VERSION'] + '.' + os.environ['GAE_DEPLOYMENT_ID']

It appears that the so-called "deployment id" can be right-shifted 28 bits to get a timestamp in epoch seconds (as other answers already described).

For example: I deployed version "101" of my app at 2021-03-04T00:17:12Z and I'm seeing the following values:

  • os.environ['GAE_VERSION']: '101'
  • os.environ['CURRENT_VERSION_ID']: '101.433474146608888597'
  • os.environ['GAE_DEPLOYMENT_ID']: '433474146608888597'

You can use the following code to get the version name and timestamp from os.environ['CURRENT_VERSION_ID']:

>>> import os
>>> import datetime
>>> version_id = os.environ['CURRENT_VERSION_ID']  # example: '101.433474146608888597'
>>> name, ts = version_id.split('.')
>>> dt = datetime.datetime.utcfromtimestamp(int(ts) >> 28))
>>> dt.isoformat()
'2021-03-04T00:17:12'

Disclaimer: Most of this functionality is undocumented and the deployment ID format may be subject to change.

user_19654040
Related