README
¶
Service packages structure
All service cloud function packages share a consistent structure
Two functions and one type
Initialize function
- Goal
- Optimize cloud function performance by reducing the invocation latency
- Implementation
- Is executed once per cloud function instance as a cold start.
- Cache objects expensive to create, like clients
- Retreive settings once, like environment variables
- Cached objects and reteived settings are exposed in one global variable named
global
Global type
- A
structto define a global variable carrying cached objects and retreived settings byInitializedfunction and used byEntryPointfunction
EntryPoint function
- Goal
- Execute operations to be performed each time the cloud function is invoked
- Implementation
- Is executed on every event triggering the cloud function
- Uses cached objects and retreived settings prepared by the
Initializedfunction and carried by a global variable of typeGlobal - Performs the task a given service is targetted to do that is described before the
packagekey word
Automatic retrying
Automatic retrying is consistently implemented in RAM service packages as documented in Google Cloud Function best practice Retrying Background Functions
Impact on cloud functions Stackdriver logs:
- Errors entry in log only appears for transient errors.
- As en error is reported the function is retried.
- Other errors and loged as information to avoid unwanted retries
- To find errors in such cloud function logs you can use the following Stackdriver logging filter
resource.type="cloud_function"
textPayload:"error"
Documentation
ramGO packages are documented on line: https://godoc.org/github.com/BrunoReboul/ram
Directories
¶
| Path | Synopsis |
|---|---|
|
Package dumpinventory request CAI to perform an export Triggered by Cloud Scheduler Job, through PubSub messages.
|
Package dumpinventory request CAI to perform an export Triggered by Cloud Scheduler Job, through PubSub messages. |
|
Package getgroupsettings retreives the settings of one group from `Groups Settings API` Triggered by PubSub messages from the GCI groups topic.
|
Package getgroupsettings retreives the settings of one group from `Groups Settings API` Triggered by PubSub messages from the GCI groups topic. |
|
Package listgroupmembers extract all members from a group in GCI directory using the Admin SDK API Triggered by PubSub messages from the GCI groups topic.
|
Package listgroupmembers extract all members from a group in GCI directory using the Admin SDK API Triggered by PubSub messages from the GCI groups topic. |
|
Package listgroups extract all groups from a GCI directory using the Admin SDK API Triggered by Cloud Scheduler Job, through PubSub messages.
|
Package listgroups extract all groups from a GCI directory using the Admin SDK API Triggered by Cloud Scheduler Job, through PubSub messages. |
|
Package monitorcompliance check asset compliance Triggered by Resource or IAM policies assets feed messages in PubSub topics.
|
Package monitorcompliance check asset compliance Triggered by Resource or IAM policies assets feed messages in PubSub topics. |
|
Package publish2fs publish assets resource feeds as FireStore documents It manages creation, updates and delete.
|
Package publish2fs publish assets resource feeds as FireStore documents It manages creation, updates and delete. |
|
Package splitdump nibble large CAI dumps into PubSub asset feed messages One dump line = one PubSub message.
|
Package splitdump nibble large CAI dumps into PubSub asset feed messages One dump line = one PubSub message. |
|
Package stream2bq streams PubSub message into BigQuery tables It can stream into 3 RAM tables: 1) assets 2) compliance states 3) violations.
|
Package stream2bq streams PubSub message into BigQuery tables It can stream into 3 RAM tables: 1) assets 2) compliance states 3) violations. |
|
Package upload2gcs stores feeds as JSON files in a GCS bucket Manage file creation (with override) and deletion.
|
Package upload2gcs stores feeds as JSON files in a GCS bucket Manage file creation (with override) and deletion. |
Click to show internal directories.
Click to hide internal directories.