#Environment variables

#Log URL placeholders

LOG_URL_TEMPLATE and the per-workload github-deployment-bridge.io/log-url annotation both expand these tokens (annotation wins when set):

Only GitHub's environment_url and Deployment Status log_url are prominent operational links. The bridge deliberately keeps the Deployment payload small; use log_url to send operators to the system that already owns the rich data.

Set LOG_URL_TEMPLATE_ESCAPE=true (Helm: config.logURLTemplateEscape: true) for the presets below. Each substituted value is percent-encoded without changing the template's URL syntax. The final result must be an absolute HTTPS URL. An invalid result is omitted with a warning; deployment reporting continues.

#Copy-paste presets

Replace only the hostname, datasource/dashboard identifiers, and any fixed dashboard path.

#Grafana Loki Explore

https://grafana.example.com/a/grafana-lokiexplore-app/explore/service/{name}/logs?from=now-1h&to=now&var-ds=loki&var-filters=service_name%7C%3D%7C{name}&var-filters=namespace%7C%3D%7C{namespace}

#Grafana dashboard

https://grafana.example.com/d/workload/logs?var-cluster={cluster}&var-namespace={namespace}&var-service={service}&var-environment={environment}&var-sha={sha}

#Generic Flux/Kubernetes dashboard

https://ops.example.com/clusters/{cluster}/namespaces/{namespace}/workloads/{name}?environment={environment}&service={service}&revision={sha}

#Workload overrides and monorepos

The annotation remains a template and takes precedence over the global value. This Kustomization-managed Deployment uses the global preset and gives one monorepo workload its own deployment identity:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: storefront-api
  namespace: storefront
  annotations:
    github-deployment-bridge.io/auto-report: "true"
    github-deployment-bridge.io/deployment-name: "storefront-api"
    github-deployment-bridge.io/service: "api"

A HelmRelease-managed StatefulSet can override the link (annotations belong on the discovered workload, usually via the chart's pod/workload annotation values):

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: checkout-worker
  namespace: checkout
  annotations:
    github-deployment-bridge.io/auto-report: "true"
    github-deployment-bridge.io/deployment-name: "checkout-worker"
    github-deployment-bridge.io/log-url: "https://grafana.example.com/d/workload/logs?var-cluster={cluster}&var-namespace={namespace}&var-service={service}&var-sha={sha}"

deployment-name separates cache/supersession identity for repositories with multiple workloads; it does not add a new visible GitHub payload field.

See also: Helm values map