Skip to main content

​
Overview

Nginx is a high-performance web server and reverse proxy. This template deploys Nginx as a reverse proxy that routes incoming traffic to workloads in your GVC based on configurable path-based location rules.

​
What Gets Created

  • Workload — A serverless Nginx reverse proxy with configurable routing rules and autoscaling.
  • Secret — An opaque secret containing the rendered Nginx configuration file, mounted into the container at startup.
  • Identity & Policy — An identity bound to the workload with reveal access to the configuration secret.
  • Example Backend Workload (optional) — A sample backend workload used to verify the proxy is working. Enabled when enableExample: true. Disable this before using in production.
This template does not create a GVC. You must deploy it into an existing GVC.

​
Installation

This template has no external prerequisites. To install, follow the instructions for your preferred method:

UI

Browse, install, and manage templates visually

CLI

Manage templates from your terminal

Terraform

Declare templates in your Terraform configurations

Pulumi

Declare templates in your Pulumi programs

​
Configuration

The default values.yaml for this template:

​
Proxy Workload

  • proxyWorkload.image — Nginx container image.
  • proxyWorkload.port — Port Nginx listens on (default: 80).
  • proxyWorkload.capacityAI — Enable CapacityAI autoscaling on the proxy workload.
  • proxyWorkload.timeoutSeconds — Proxy connection timeout in seconds.

​
Resources

  • resources.cpu / resources.memory — CPU and memory allocated to each Nginx replica.

​
Autoscaling

  • autoscaling.minScale / autoscaling.maxScale — Minimum and maximum replica count.
  • autoscaling.maxConcurrency — Maximum number of concurrent connections per replica.

​
Routing

  • locations — Array of path-based routing rules. Each entry forwards matching requests to an internal workload:
Example:

​
Built-in Endpoints

The following endpoints are always active regardless of your locations configuration:

​
Example Backend

  • enableExample — When true, deploys a sample helloworld backend workload and routes all traffic to it. Set to false when configuring your own locations.

​
Accessing the Proxy

Once deployed, the Nginx proxy is available at:

​
External References

Nginx Documentation

Official Nginx documentation

Nginx Template

View the source files, default values, and chart definition