/examples

Infrastructure, containers, and serverless apps to AWS, Azure, GCP, and Kubernetes... all deployed with Pulumi

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Pulumi Examples

Open in GitHub Codespaces

This repository contains examples of using Pulumi to build and deploy cloud applications and infrastructure across major programming languages.

Each example has a two-part prefix, <cloud>-<language>, to indicate which <cloud> and <language> it pertains to. For example, <cloud> could be:

See the Pulumi documentation for more details on getting started with Pulumi.

Checking Out a Single Example

You can checkout only the example(s) you want by using a sparse checkout. The following commands show how checkout only the aws-go-fargate example. Replace aws-go-fargate with your example of interest.

$ mkdir examples && cd examples
$ git init
$ git remote add origin -f https://github.com/pulumi/examples/
$ git config core.sparseCheckout true
$ echo "aws-go-fargate" >> .git/info/sparse-checkout ## update this
$ git pull origin master

Don't see an example listed? Try Pulumi AI and use natural-language prompts to generate Pulumi infrastructure-as-code programs in any language.

Outline

AWS

TypeScript

(Click here to go back to the main list)

Example Description
API Gateway Deploy a simple REST API that counts the number of times a route has been hit.
API Gateway HTTP API with routes Deploy a HTTP API that invokes a Lambda.
API Gateway HTTP API quickstart Deploy a very simple HTTP API that invokes a Lambda.
API Gateway V1 with EventBridge and Lambda Deploy a REST API that uses EventBridge to target a Lambda function. Includes API Gateway model validation and custom integration-response mapping.
API Gateway V2 with EventBridge and Lambda Deploy an HTTP API that uses EventBridge to target a Lambda function.
Apigateway - Auth0 Deploy a simple REST API protected by Auth0.
AppSync Deploy a basic GraphQL endpoint in AWS AppSync.
AssumeRole Use AssumeRole to create resources.
Containers Provision containers on Fargate.
EKS - Dashboard Deploy an EKS Kubernetes cluster with an EBS-backed StorageClass, then the Kubernetes Dashboard into the cluster.
EKS - Hello World Deploy an EKS Kubernetes cluster with an EBS-backed StorageClass, then a Kubernetes namespace and nginx deployment into the cluster.
EKS - Migrate Node Groups Create an EKS cluster and node group to use for workload migration with zero downtime.
Fargate Build, deploy, and run a Dockerized app using ECS, ECR, and Fargate.
Lambda Thumbnailer Create a video thumbnail extractor using serverless functions.
Miniflux Stand up an RSS Service using Fargate and RDS.
Pulumi Webhooks Create a Pulumi cloud.HttpEndpoint that receives webhook events delivered by Pulumi Cloud, then echos the event to Slack.
RDS and Airflow Deploy a RDS Postgres instance and containerized Airflow.
Resources Create various resources, including cloudwatch.Dashboard, cloudwatch.EventRule, cloudwatch.LogGroup, and sqs.Queue.
Ruby on Rails Create a single EC2 virtual machine instance with a local MySQL database.
S3 Lambda Set up two AWS S3 Buckets and a single Lambda that listens to one and, upon each new object arriving in it, zips it up and copies it to the second bucket.
Serverless Application Deploy a complete serverless C# application using raw resources from @pulumi/aws.
Serverless Datawarehouse Deploy a serverless data warehouse.
Slackbot Create a simple slackbot that posts a notification to a specific channel any time you're @mentioned anywhere.
Stack Reference Create a "team" EC2 Instance with tags set from upstream stacks.
Static Website Serve a static website using S3, CloudFront, Route53, and Certificate Manager.
Step Functions Use Step Functions with a Lambda function.
Thumbnailer Create a video thumbnail extractor using serverless functions and containers.
Twitter Query Twitter every 2 minutes, store the results in S3, and set up an Athena table and query.
URL Shortener Create a serverless URL shortener that uses high-level components.
Voting App Create a simple voting app using Redis and Python Flask.
Web Server Deploy an EC2 Virtual machine using TypeScript to run a Python web server.
Web Server with Manual Provisioning Use Pulumi dynamic providers to accomplish post-provisioning configuration steps.
LangServe - Hello OpenAI Deploy a LangServe app that uses OpenAI's on AWS ECS.

JavaScript

(Click here to go back to the main list)

Example Description
Containers Provision containers on Fargate.
S3 Folder Component Serve a static website on S3 from a component.
S3 Folder Serve a static website on S3.
Servless SQS to Slack Wire up a serverless AWS Lambda to an AWS SQS queue and post a message to Slack.
Web Server - Component Deploy an EC2 instance using a common module for creating an instance.
Web Server Deploy an EC2 Virtual machine running a Python web server.
LangServe - Hello OpenAI Deploy a LangServe app that uses OpenAI's on AWS ECS.

Python

(Click here to go back to the main list)

Example Description
API Gateway HTTP API quickstart Deploy a very simple HTTP API that invokes a Lambda.
API Gateway V2 with EventBridge and Lambda Deploy an HTTP API that uses EventBridge to target a Lambda function.
AppSync Deploy a basic GraphQL endpoint in AWS AppSync.
AssumeRole Use AssumeRole to create resources.
Fargate Provision a full ECS Fargate cluster running a load-balanced nginx web server.
Resources Create various resources, including cloudwatch.Dashboard, cloudwatch.EventRule, cloudwatch.LogGroup, and sqs.Queue.
S3 Folder Serve a static website on S3.
Stack Reference Create a "team" EC2 Instance with tags set from upstream stacks.
Step Functions Use Step Functions with a Lambda function.
Web Server Deploy an EC2 instance and open port 80.
LangServe - Hello OpenAI Deploy a LangServe app that uses OpenAI's on AWS ECS.

Go

(Click here to go back to the main list)

Example Description
AssumeRole Use AssumeRole to create resources.
Fargate Provision a full ECS Fargate cluster running a load-balanced nginx web server.
Lambda Create a lambda that does a simple ToUpper on the string input and returns it.
S3 Folder Serve a static website on S3.
Web Server Deploy an EC2 Virtual machine running a Python web server.
LangServe - Hello OpenAI Deploy a LangServe app that uses OpenAI's on AWS ECS.

C#

(Click here to go back to the main list)

Example Description
AssumeRole Use AssumeRole to create resources.
Fargate Build, deploy, and run a Dockerized app using ECS, ECR, and Fargate.
Lambda Create a lambda that does a simple ToUpper on the string input and returns it.
S3 Folder Serve a static website on S3.
Web Server Deploy an EC2 instance and open port 80.
LangServe - Hello OpenAI Deploy a LangServe app that uses OpenAI's on AWS ECS.

F#

(Click here to go back to the main list)

Example Description
Lambda Web Server Create a web server in AWS lambda using the Giraffe web server.
S3 Folder Serve a static website on S3.

Azure

TypeScript

(Click here to go back to the main list)

Example Description
Azure Container Apps Run a Docker image on Azure Container Apps.
Azure Container Instance Run Azure Container Instances on Linux.
Azure Kubernetes Service Create an Azure Kubernetes Service (AKS) Cluster.
Azure App Service Build a web application hosted in App Service and provision Azure SQL Database and Azure Application Insights.
Azure App Service with Docker Build a web application hosted in App Service from Docker images.
App Service in Virtual Network Deploy two App Services - Front web app with VNet injection and Back web app with a Private Endpoint.
Azure Cosmos DB and LogicApp Define Cosmos DB, API connections, and link them to a logic app.
Azure Functions Deploy a Node.js serverless function to Azure Functions.
Azure Functions - Many Deploy several kinds of Azure Functions created from raw deployment packages.
Azure SDK integration Call Azure SDK functions from a Pulumi program.
Static Website Configure static website hosting in Azure Storage.
Azure Synapse Starting point for enterprise analytics solutions based on Azure Synapse.
Web Server Provision a Linux web server in an Azure Virtual Machine.

Python

(Click here to go back to the main list)

Example Description
Azure Container Apps Run a Docker image on Azure Container Apps.
Azure Container Instance Run Azure Container Instances on Linux.
Azure Kubernetes Service Create an Azure Kubernetes Service (AKS) Cluster.
Azure App Service Build a web application hosted in App Service and provision Azure SQL Database and Azure Application Insights.
Azure App Service with Docker Build a web application hosted in App Service from Docker images.
Azure SDK integration Call Azure SDK functions from a Pulumi program in Python.
Azure Cosmos DB and LogicApp Define Cosmos DB, API connections, and link them to a logic app.
Minecraft Server Deploy an Azure Virtual Machine and provision a Minecraft server.
Static Website Configure static website hosting in Azure Storage.
Azure Synapse Starting point for enterprise analytics solutions based on Azure Synapse.
Virtual Data Center Deploy Azure Virtual Data Center (VDC) hub-and-spoke network stacks in Azure, complete with ExpressRoute and VPN Gateways, Azure Firewall guarding a DMZ, and Azure Bastion.
Web Server Provision a Linux web server in an Azure Virtual Machine.

Go

(Click here to go back to the main list)

Example Description
Azure Container Apps Run a Docker image on Azure Container Apps.
Azure Container Instance Run Azure Container Instances on Linux.
Azure Kubernetes Service Create an Azure Kubernetes Service (AKS) Cluster.
Azure App Service with Docker Build a web application hosted in App Service from Docker images.
Static Website Configure static website hosting in Azure Storage.
Azure SDK integration Call Azure SDK functions from a Pulumi programin Go.

C#

(Click here to go back to the main list)

Example Description
Cluster.
Azure Container Apps Run a Docker image on Azure Container Apps.
Azure Container Instance Run Azure Container Instances on Linux.
Azure Kubernetes Service Create an Azure Kubernetes Service (AKS) Cluster.
AKS web app with .NET 5 Create an Azure Kubernetes Service (AKS) cluster and deploy a web app to it using .NET 5 and C# 9.
AKS + Cosmos DB A Helm chart deployed to AKS that stores TODOs in an Azure Cosmos DB MongoDB API.
Azure App Service Build a web application hosted in App Service and provision Azure SQL Database and Azure Application Insights.
Azure App Service with Docker Build a web application hosted in App Service from Docker images.
Azure API integration Call additional Azure API endpoints from a Pulumi program.
Azure Cosmos DB and LogicApp Define Cosmos DB, API connections, and link them to a logic app.
Azure Functions Deploy a Node.js serverless function to Azure Functions.
Static Website Configure static website hosting in Azure Storage.
Azure Synapse Starting point for enterprise analytics solutions based on Azure Synapse.
Azure SQL Server An example of a SQLServer on Azure PaaS.

GCP

TypeScript

(Click here to go back to the main list)

Example Description
Cloud Run Deploy a custom Docker image into Google Cloud Run service.
Functions - Raw Deploy two Google Cloud Functions implemented in Python and Go.
Functions Deploy an HTTP Google Cloud Function endpoint.
GKE - Hello World Deploy a GKE cluster, then a Kubernetes namespace and nginx deployment into the cluster.
GKE Provision a Google Kubernetes Engine (GKE) cluster, then a Kubernetes Deployment.
Ruby on Rails Deliver a containerized Ruby on Rails application.
Slackbot Create a simple slackbot that posts a notification to a specific channel any time you're @mentioned anywhere.

JavaScript

(Click here to go back to the main list)

Example Description
Web Server Build a web server in Google Cloud.

Python

(Click here to go back to the main list)

Example Description
Functions - Raw Deploy two Google Cloud Functions implemented in Python and Go.
Functions Deploy a Python-based Google Cloud Function.
GKE Provision a Google Kubernetes Engine (GKE) cluster, then a Kubernetes Deployment.
Network Component Use a reusable component to create a Google Cloud Network and instance.
nginx Server Build a nginx server in Google Cloud.

Go

(Click here to go back to the main list)

Example Description
Functions Deploy a Go-based Google Cloud Function.
Functions - Raw Deploy a Google Cloud Function implemented in Python.
Web Server Build a web server in Google Cloud.

C#

(Click here to go back to the main list)

Example Description
Functions - Raw Deploy a Google Cloud Function implemented in Python.
Functions Deploy a Go-based Google Cloud Function.

Kubernetes

TypeScript

(Click here to go back to the main list)

Example Description
App Rollout via ConfigMap Enable a change in a ConfigMap to trigger a rollout of an nginx Deployment.
App Rollout via S3 Data Change Enable a change in data in S3 to trigger a rollout of an nginx deployment.
Expose Deployment Deploy nginx to a Kubernetes cluster, and publicly explose it using a Kubernetes Service.
Guestbook Build and deploy a simple, multi-tier web application using Kubernetes and Docker.
Jenkins Deploy a container running the Jenkins continuous integration system onto a running Kubernetes cluster.
Multicloud Create managed Kubernetes clusters using AKS, EKS, and GKE, and deploy the application on each cluster.
nginx server Deploy a replicated nginx server to a Kubernetes cluster, using TypeScript and no YAML.
Sock Shop Deploy a version of the standard Sock Shop microservices reference app.
Staged App Rollout Create a staged rollout gated by checking that the P90 response time reported by Prometheus is less than some amount.
Wordpress Helm Chart Use the Helm API to deploy v2.1.3 of the Wordpress Helm Chart to a Kubernetes cluster.

Python

(Click here to go back to the main list)

Example Description
Guestbook Build and deploy a simple, multi-tier web application using Kubernetes and Docker.

C#

(Click here to go back to the main list)

Example Description
Guestbook Build and deploy a simple, multi-tier web application using Kubernetes and Docker.

Go

(Click here to go back to the main list)

Example Description
Guestbook Build and deploy a simple, multi-tier web application using Kubernetes and Docker.
App Rollout via ConfigMap Enable a change in a ConfigMap to trigger a rollout of an nginx Deployment.
Wordpress Helm Chart Use the Helm API to deploy v9.6.0 of the Wordpress Helm Chart to a Kubernetes cluster.
Expose Deployment Deploy nginx to a Kubernetes cluster, and publicly expose it using a Kubernetes Service.

Openstack

Python

(Click here to go back to the main list)

Web Server | Deploy an Openstack instance and open port 8000.

OVHCloud

Go

Example Description
Kubernetes A sample to deploy a managed Kubernetes cluster on OVHcloud

Cloud

TypeScript

(Click here to go back to the main list)

Example Description
URL Shortener - Cache and HttpServer Create a simple URL shortener SPA that uses the high-level cloud.Table and cloud.HttpServer components.
URL Shortener - Cache Create a simple URL shortener SPA that uses the high-level cloud.Table and cloud.API components.
URL Shortener Create a complete URL shortener web application that uses the high-level cloud.Table and cloud.HttpServer components.
Voting App Create a simple voting app using Redis and Python Flask.

JavaScript

(Click here to go back to the main list)

Example Description
API on AWS Create a simple REST API that counts the number of times a route has been hit.
Containers Provision containers on Fargate.
HttpServer Create a simple REST API that counts the number of times a route has been hit.
Thumbnailer - Machine Learning Create a video thumbnail extractor using serverless functions, containers, and AWS Rekognition.
Thumbnailer Create a video thumbnail extractor using serverless functions and containers.
Twitter Query Twitter every 2 minutes, store the results in S3, and set up an Athena table and query.

DigitalOcean

TypeScript

(Click here to go back to the main list)

Example Description
Droplets Build sample architecture.
Kubernetes Provision a DigitalOcean Kubernetes cluster.

Python

(Click here to go back to the main list)

Example Description
Droplets Build sample architecture.
Kubernetes Provision a DigitalOcean Kubernetes cluster.

C#

(Click here to go back to the main list)

Example Description
Droplets Build sample architecture.
Kubernetes Provision a DigitalOcean Kubernetes cluster.

Multicloud

TypeScript

(Click here to go back to the main list)

Example Description
Buckets Use a single Pulumi program to provision resources in both AWS and GCP.

F5

TypeScript

(Click here to go back to the main list)

Example Description
BigIP Local Traffic Manager Provide load balancing via an F5 BigIP appliance to backend HTTP instances.

Twilio

TypeScript

(Click here to go back to the main list)

Example Description
Component Create a custom Component Resource to parse incoming messages from Twilio.

Linode

JavaScript

(Click here to go back to the main list)

Example Description
Web Server Build a web server on Linode.

Testing

(Click here to go back to the main list)

Example Description
Unit Tests in TypeScript Mock-based unit tests in TypeScript.
Unit Tests in Python Mock-based unit tests in Python.
Unit Tests in Go Mock-based unit tests in Go.
Unit Tests in C# Mock-based unit tests in C#.
Testing with Policies Tests based on Policy-as-Code in TypeScript.
Integration Testing in Go Deploy-check-destroy tests in Go.

Automation API

(Click here to go back to the main list)

Automation API Examples

Community and Social

Engage with our community to elevate your developer experience:

  • Join our online Pulumi Community on Slack - Interact with over 3K Pulumi developers for collaborative problem-solving and knowledge-sharing!
  • Join a Local Pulumi User Groups (PUGs)- Attend tech-packed meetups and hands-on virtual or in-person workshops.
  • Follow @PulumiCorp on X (Twitter) - Get real-time updates, technical insights, and sneak peeks into the latest features.
  • Subscribe to our YouTube Channel, PulumiTV - Learn about AI / ML essentials, launches, workshops, demos and more.
  • Follow our LinkedIn - Uncover company news, achievements, and behind-the-scenes glimpses.

Contributors

Meet the brilliant minds behind this project, view their profiles, and learn about their valuable contributions.

FAQs

How can I contribute to this repository?

We're glad you asked! Please visit our CONTRIBUTING doc for details.

How can I install the Pulumi CLI?

Visit our install page for installation steps.

Is Pulumi Cloud free?

Individual accounts are always free and allow unlimited resources. See our pricing page for other options.

Further Reading

Delve deeper into our project with additional resources:

  • Get Started with Pulumi: Deploy a simple application in AWS, Azure, Google Cloud, or Kubernetes using Pulumi.
  • Registry: Search for packages and learn about the supported resources you need. Install the package directly into your project, browse the API documentation, and start building.
  • Try Pulumi AI - Use natural-language prompts to generate Pulumi infrastructure-as-code programs in any language.
  • Documentation: Learn about Pulumi concepts, follow user guides, and consult the reference documentation.
  • Pulumi Blog - Stay in the loop with our latest tech announcements, insightful articles, and updates.