Skip to content

Helmless Chart for Google Cloud Run

Documentation Version GitHub Workflow Status semantic-versioning: helmless License

This Helmless chart generates a manifest compatible with Google Cloud Run's YAML specification, which can then be deployed using the gcloud run services replace command or the helmless/google-cloudrun-deploy-action. Head to the documentation for more information.

Prerequisites

  • Helm v3.x
  • Google Cloud SDK
  • Access to a Google Cloud project and permissions to deploy to Google Cloud Run
  • The run.googleapis.com API enabled on your project

Usage

If you are new to Helmless I suggest you head to the documentation first. If you want to learn by doing or are already familiar with Helmless, continue reading.

  1. You will need to create a values.yaml file to configure your deployment.
cat <<EOF > values.yaml
# yaml-language-server: $schema=https://raw.githubusercontent.com/helmless/google-cloudrun-chart/main/values.schema.json
name: 'my-helmless-service'
region: 'us-central1'
image: 'us-docker.pkg.dev/cloudrun/container/hello:latest'
env:
  COLOR: 'blue'
autoscaling:
  minScale: 0
EOF
  1. Render the manifest using helm template:
helm template oci://ghcr.io/helmless/google-cloudrun -f values.yaml > cloudrun_manifest.yaml
  1. Deploy the manifest using gcloud run services replace:
gcloud run services replace cloudrun_manifest.yaml
  1. To clean up and delete the service, run the following command:
gcloud run services delete my-helmless-service --region=us-central1

Configuration Reference

You can find the full configuration reference for the Helm chart in the docs/values.md file.