026234bdbb
* add back getting started page * decollapse getting started guide * update style * remove quickstart files scss file * lint * assets * update links * update links * update links * update links * update link
379 lines
19 KiB
Markdown
379 lines
19 KiB
Markdown
---
|
||
title_tag: Get Started with Pulumi
|
||
meta_desc: Step-by-step guides for creating, deploying, and managing infrastructure with
|
||
Pulumi on the cloud using your favorite language.
|
||
title: Get started
|
||
h1: Get started with Pulumi
|
||
no_on_this_page: true
|
||
meta_image: /images/docs/meta-images/docs-meta.png
|
||
menu:
|
||
getstarted:
|
||
name: Overview
|
||
weight: 2
|
||
|
||
aliases:
|
||
- /docs/quickstart/
|
||
- /start/
|
||
- /getting-started/
|
||
- /get-started/
|
||
- /docs/tour/
|
||
---
|
||
|
||
Pulumi is an [infrastructure as code](/what-is/what-is-infrastructure-as-code/) platform that allows you to use familiar programming languages and tools to build, deploy, and manage cloud infrastructure.
|
||
|
||
Pulumi is free, [open source](https://github.com/pulumi/pulumi), and optionally pairs with the [Pulumi Cloud](/docs/pulumi-cloud/) to make managing infrastructure secure, reliable, and hassle-free.
|
||
|
||
Select one of the following options to get started:
|
||
|
||
{{% chooser cloud "aws,azure,gcp,kubernetes" / %}}
|
||
|
||
{{% choosable cloud aws %}}
|
||
|
||
<div class="tiles flex-wrap justify-center items-stretch mt-4">
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-get-started" href="/docs/clouds/aws/get-started/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-folder text-blue-400 pr-2"></i>Starter</h4>
|
||
<p>If you are new to Pulumi, this guide helps you install Pulumi, configure AWS, and run your first update.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-primary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-container-service" href="/templates/container-service/aws/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-tasks text-blue-400 pr-2"></i>Containers with Fargate</h4>
|
||
<p>Run your container on AWS using ECS and Fargate.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-kubernetes" href="/templates/kubernetes/aws/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Amazon Elastic Kubernetes Service (EKS)</h4>
|
||
<p>Create an EKS cluster that provides a managed Kubernetes control plane.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-static-website" href="/templates/static-website/aws/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cloud text-blue-400 pr-2"></i>S3 and Cloudfront Website</h4>
|
||
<p>Create a static website hosted in S3 with a CloudFront Distribution to serve the website with caching and HTTPs.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-serverless" href="/templates/serverless-application/aws/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-sitemap text-blue-400 pr-2"></i>Serverless with API Gateway</h4>
|
||
<p>Create an API Gateway REST API and a static website that consumes that API.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="aws-vm" href="/templates/virtual-machine/aws/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-server text-blue-400 pr-2"></i>EC2</h4>
|
||
<p>Create an Amazon EC2 for the virtual machine and VPC for the virtual network.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
</div>
|
||
|
||
{{< /choosable >}}
|
||
|
||
{{% choosable cloud azure %}}
|
||
|
||
<div class="tiles flex-wrap justify-center items-stretch mt-4">
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-get-started" href="/docs/clouds/azure/get-started/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-folder text-blue-400 pr-2"></i>Starter</h4>
|
||
<p>If you are new to Pulumi, this guide helps you install Pulumi, configure Azure, and run your first update.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-primary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-container" href="/templates/container-service/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-tasks text-blue-400 pr-2"></i>Containers on Azure</h4>
|
||
<p>
|
||
Create an Azure Container Instances (ACI) for running containers and an Azure Container Registry that stores the container image.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-kubernetes" href="/templates/kubernetes/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Azure Kubernetes Service (AKS)</h4>
|
||
<p>
|
||
Create an Azure Virtual Network with three subnets and deploy an Azure Kubernetes Service (AKS) cluster.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-static-website" href="/templates/static-website/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cloud text-blue-400 pr-2"></i>Static Website with a CDN</h4>
|
||
<p>Create a static website with a Blob storage and a CDN to serve the website with caching and HTTPs.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-serverless" href="/templates/serverless-application/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-sitemap text-blue-400 pr-2"></i>Full Stack Serverless App</h4>
|
||
<p>Create a Function App and a static website that consumes that Function.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="azure-vm" href="/templates/virtual-machine/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-server text-blue-400 pr-2"></i>Virtual Machine</h4>
|
||
<p>
|
||
Create an Azure Virtual Machine and Azure Virtual Network for the virtual network.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
</div>
|
||
|
||
{{< /choosable >}}
|
||
|
||
{{% choosable cloud gcp %}}
|
||
|
||
<div class="tiles flex-wrap justify-center items-stretch mt-4">
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-get-started" href="/docs/clouds/gcp/get-started/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-folder text-blue-400 pr-2"></i>Starter</h4>
|
||
<p>If you are new to Pulumi, this guide helps you install Pulumi, configure Google Cloud, and run your first update.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-primary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-container" href="/templates/container-service/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-tasks text-blue-400 pr-2"></i>Google Cloud Run</h4>
|
||
<p>
|
||
Use Google Cloud Run for running containers on serverless compute and Artifact Registry for storing container images.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-kubernetes" href="/templates/kubernetes/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Google Kubernetes Engine (GKE)</h4>
|
||
<p>
|
||
Create a VPC network with a subnet and deploy a Google Kubernetes Engine (GKE) cluster.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-static-website" href="/templates/static-website/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cloud text-blue-400 pr-2"></i>Static Website with a CDN</h4>
|
||
<p>Create a static website with a Cloud Storage bucket and a CDN to serve the website with caching and HTTPs.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-serverless" href="/templates/serverless-application/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-sitemap text-blue-400 pr-2"></i>Full Stack Serverless App</h4>
|
||
<p>Create a Cloud Function and a static website that consumes that function.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="google-vm" href="/templates/virtual-machine/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-server text-blue-400 pr-2"></i>Virtual Machine</h4>
|
||
<p>
|
||
Use Compute Engine to create a virtual machine and virtual network.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
</div>
|
||
|
||
{{< /choosable >}}
|
||
|
||
{{% choosable cloud kubernetes %}}
|
||
|
||
<div class="tiles flex-wrap justify-center items-stretch mt-4">
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-get-started" href="/docs/clouds/kubernetes/get-started/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-folder text-blue-400 pr-2"></i>Starter</h4>
|
||
<p>If you are new to Pulumi, this guide helps you install Pulumi, configure the Kubernetes Provider, and run your first update.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-primary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-helm" href="/templates/kubernetes-application/helm-chart/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cloud text-blue-400 pr-2"></i>Helm Chart</h4>
|
||
<p>Deploy a Helm chart to an existing cluster using Pulumi.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-web-app" href="/templates/kubernetes-application/web-application/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-sitemap text-blue-400 pr-2"></i>Web App</h4>
|
||
<p>Deploy and example web application into an existing Kubernetes cluster.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-aws" href="/templates/kubernetes/aws" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Amazon Elastic Kubernetes Service (EKS)</h4>
|
||
<p>Create an EKS cluster that provides a managed Kubernetes control plane.</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-azure" href="/templates/kubernetes/azure/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Azure Kubernetes Service (AKS)</h4>
|
||
<p>
|
||
Create an Azure Virtual Network with three subnets and deploy an Azure Kubernetes Service (AKS) cluster.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
<div class="pb-4 md:pr-4 md:w-1/2">
|
||
<a data-track="kubernetes-google" href="/templates/kubernetes/gcp/" class="tile h-full">
|
||
<div class="block rounded shadow border border-gray-300 p-3 h-full flex flex-col">
|
||
<h4 class="no-anchor"><i class="fas fa-cubes text-blue-400 pr-2"></i>Google Kubernetes Engine (GKE)</h4>
|
||
<p>
|
||
Create a VPC network with a subnet and deploy a Google Kubernetes Engine (GKE) cluster.
|
||
</p>
|
||
<div class="flex flex-grow items-end">
|
||
<div class="btn btn-secondary">Get Started</div>
|
||
</div>
|
||
</div>
|
||
</a>
|
||
</div>
|
||
</div>
|
||
|
||
{{< /choosable >}}
|
||
|
||
Or, watch how to do it in this video walkthrough:
|
||
|
||
<div class="rounded-md shadow border border-gray-300 w-3/4 mx-auto my-4" style="position: relative; padding-bottom: 40.25%; height: 0; overflow: hidden;">
|
||
<iframe
|
||
src="//www.youtube.com/embed/6f8KF6UGN7g?rel=0"
|
||
style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border:0;"
|
||
allowfullscreen=""
|
||
title="Introduction to Pulumi: Modern Infrastructure as Code"
|
||
srcdoc="<style>*{padding:0;margin:0;overflow:hidden}html,body{height:100%}img{position:absolute;width:100%;top:0;bottom:0;margin:auto}</style><a href=https://www.youtube.com/embed/6f8KF6UGN7g?autoplay=1><img src='/images/home/youtube-preview.svg' alt='Introduction to Pulumi: Modern Infrastructure as Code'></a>">
|
||
</iframe>
|
||
</div>
|
||
|
||
See [Registry](/registry/) on how to use other supported clouds.
|
||
|
||
## Pulumi Cloud
|
||
|
||
The Pulumi Cloud is a fully managed service that helps you adopt Pulumi’s open source SDK with ease. It provides built-in state and secrets management, integrates with source control and CI/CD, and offers a web console and API that make it easier to visualize and manage infrastructure. It is free for individual use, with features available for teams.
|
||
|
||
<a class="btn btn-secondary" href="https://app.pulumi.com/signup" target="_blank">Create an Account</a>
|
||
|
||
## Additional resources
|
||
|
||
The following sections are also useful when first learning how to use Pulumi:
|
||
|
||
<div class="md:flex flex-row mt-6 mb-6">
|
||
<div class="md:w-1/2 border-solid border-t-2 border-gray-200">
|
||
<h3 class="no-anchor pt-4"><a href="/docs/intro/concepts"><i class="fas fa-file-alt pr-2"></i>Concepts</a></h3>
|
||
<p>Get details on the Pulumi programming model and core concepts.</p>
|
||
</div>
|
||
<div class="md:w-1/2 md:ml-4 border-solid border-t-2 border-gray-200">
|
||
<h3 class="no-anchor pt-4"><a href="/docs/using-pulumi/adopting-pulumi/"><i class="fas fa-cloud pr-2"></i>Adopting Pulumi</a></h3>
|
||
<p>Learn how to support, migrate, or convert existing cloud infrastructure with Pulumi.</p>
|
||
</div>
|
||
</div>
|
||
|
||
<div class="md:flex flex-row mt-6 mb-6">
|
||
<div class="w-full border-solid border-t-2 border-gray-200">
|
||
<h3 class="no-anchor pt-4"><a href="/resources/introduction-to-pulumi"><i class="fas fa-users pr-2"></i>Live Workshops</a></h3>
|
||
<p>Deploy your first Pulumi program in a live, instructor-led event.</p>
|
||
</div>
|
||
</div>
|