updatedatastore

gsuitemdm Cloud Function updatedatastore

A cloud Function component of the gsuitemdm package that updates mobile device data in Google Datastore with the latest mobile device data from the Admin SDK as well as any local device-specific notes that may be stored in the Google Sheet.

The updatedatastore API is used by the mdmtool command line utility.

HOW-TO Configure updatedatastore

updatedatastore uses a .yaml file containing several environment variables the cloud function reads during app startup. These environment variables point the app to the shared master cloud function configuration and API key that are stored as Secret Manager secrets. An example .yaml file for updatedatastore:

APPNAME: updatedatastore
SM_APIKEY_ID: projects/12334567890/secrets/gsuitemdm_apikey
SM_CONFIG_ID: projects/12334567890/secrets/gsuitemdm_conf

HOW-TO Deploy updatedatastore

$ gcloud functions deploy UpdateDatastore \
  --runtime go111 \
  --trigger-http \
  --env-vars-file env_updatedatastore.yaml 

HOW-TO Use updatedatastore

API

Example expected JSON to update Google Datastore with fresh mobile device data:

{
	"key": "0123456789"
}

Example command line using curl and the above JSON to update Google Datastore with fresh movbile device data:

$ curl -X POST -d '{"key": "0123456789"}' \
  https://us-central1-<YOURGCPPROJECTNAME>.cloudfunctions.net/UpdateDatastore

It is recommended that Google Cloud Scheduler be used to schedule automatic calls to updatedatastore, for example:

$ gcloud scheduler jobs list
ID                   LOCATION     SCHEDULE (TZ)                      TARGET_TYPE  STATE
UpdateDatastore      us-central1  */5 * * * * (America/Los_Angeles)  HTTP         ENABLED

mdmtool

Fresh mobile device data can be downloaded and updated in Google Datastore by running mdmtool's updatedb command:

$ mdmtool updatedb
Updating Datastore...  done.
updatedatastore Success