Skip to content

Latest commit

 

History

History
97 lines (74 loc) · 2.82 KB

cloudrun.md

File metadata and controls

97 lines (74 loc) · 2.82 KB
Raw

Deploy SLO Generator as a Cloud Run service

slo-generator can also be deployed as a Cloud Run service by following the instructions below.

Terraform setup

To set up the slo-generator with Terraform, please look at the terraform-google-slo.

Manual setup using gcloud

Setup a Cloud Storage bucket

Create the GCS bucket that will hold our SLO configurations:

gsutil mb -p ${PROJECT_ID} gs://${BUCKET_NAME}

Upload the slo-generator configuration to the GCS bucket:

gsutil cp config.yaml gs://${BUCKET_NAME}/

See sample config.yaml

Deploy the CloudRun service

gcloud run deploy slo-generator \
   --image gcr.io/slo-generator-ci-a2b4/slo-generator:latest \
   --region=europe-west1 \
   --project=${PROJECT_ID} \
   --set-env-vars CONFIG_PATH=gs://${BUCKET_NAME}/config.yaml \
   --platform managed \
   --command="slo-generator" \
   --args=api \
   --args=--signature-type=http \
   --min-instances 1 \
   --allow-unauthenticated

Once the deployment is finished, get the service URL from the log output.

[Optional] Test an SLO

curl -X POST -H "Content-Type: text/x-yaml" --data-binary @slo.yaml ${SERVICE_URL} # yaml
curl -X POST -H "Content-Type: application/json" -d @${SLO_PATH} ${SERVICE_URL}    # json

See sample slo.yaml

Schedule SLO reports every minute

Upload your SLO config to the GCS bucket:

gsutil cp slo.yaml gs://${BUCKET_NAME}/

Create a Cloud Scheduler job that will hit the service with the SLO config URL:

gcloud scheduler jobs create http slo --schedule=”* * * * */1” \
   --uri=${SERVICE_URL} \
   --message-body=”gs://${BUCKET_NAME}/slo.yaml”
   --project=${PROJECT_ID}

[Optional] Set up the export service

If you decide to split some of the exporters to another dedicated service, you can deploy an export-only API to Cloud Run:

Upload the slo-generator export config to the GCS bucket:

gsutil cp config_export.yaml gs://${BUCKET_NAME}/config_export.yaml

Deploy the slo-generator with --signature-type=cloudevent and --target=run_export:

gcloud run deploy slo-generator-export \
   --image gcr.io/slo-generator-ci-a2b4/slo-generator:latest \
   --region=europe-west1 \
   --project=${PROJECT_ID} \
   --set-env-vars CONFIG_PATH=gs://${BUCKET_NAME}/config_export.yaml \
   --platform managed \
   --command="slo-generator" \
   --args=api \
   --args=--signature-type=cloudevent \
   --args=--target=run_export \
   --min-instances 1 \
   --allow-unauthenticated

To send your SLO reports from the standard service to the export-only service, set up a cloudevent exporter in the standard service config.yaml.