Cloud Run Multi-Container NGINX Example

This project demonstrates a multi-container application using Go (Gin), NodeJs with Express, React, and NGINX, orchestrated with Docker Compose. The main POC will be to run NGINX as a API proxy in Cloud Run to support the Frontend with the Backend API.

Project Structure

• apis/users: Go service for user management (Gin)
• apis/ping: Javascript service for health checks (NodeJS/Express)
• frontend: React app served by NGINX
• proxy: NGINX reverse proxy for API routing

Services

Service	Description	Port
frontend	React app via NGINX	3000
proxy	NGINX reverse proxy for API routing	8080
users	Go user API (Gin)	N/A
ping	Javascript ping API (NodeJS/Express)	N/A

Development

Prerequisites

• Docker & Docker Compose
• Node.js (for local frontend dev and ping service)
• Go (for local user API dev)

Running with Docker Compose

docker compose up --build

• Frontend: http://localhost:3000
• API Gateway: http://localhost:8080

API Endpoints

• GET /ping — returns pong
• GET /users — user management endpoints (see apis/users)

Environment Variables

Frontend uses VITE_API_BASE_URL (see frontend/.env.development.local)

Building and Pushing Docker Images

This is the required .env file for building and pushing the images:

DOCKER_REPO=my-full-repo-path
GCP_REGION=service-region
GCP_PROJECT_ID=service-project-id
USERS_SERVICE=user-service-run.app# for preparing the proxy config
PING_SERVICE=ping-service-run.app# for preparing the proxy config

task build:all # build and push all images
task deploy:all # deploy all images to Cloud Run

GCP Setup

1. Create a GCP project
2. Enable the following APIs:
   • Cloud Run
   • Artifact Registry
   • Container Registry
3. Create a service account run-nginx-poc with the following roles:
   • Cloud Run Invoker
   • Service Account User
   • Artifact Registry Reader
   • Firebase Admin SDK Administrator
4. Create a Firebase project and link it to the GCP project
5. Create an Artifact Registry repository for the Docker images

Current Status

• Works in local dev compose
• Works in Cloud Run, with backend services Authenticated, not NGINX proxy