Virtual Machine on Azure
The Azure Virtual Machine template scaffolds a Pulumi project that provisions an Azure virtual machine inside a new Azure Virtual Network. The instance boots an HTTP server on port 80 from a small init script, so the project deploys end to end out of the box. Use it as a starting point for a web application, backend service, or database VM.
Using this template#
To use this template to deploy your own virtual machine, make sure you’ve installed Pulumi and configured your Azure credentials, then create a new project using the template in the language of your choice:
TypeScript
Python
Go
C#
YAML
HCLmkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-typescriptAlternatively, you can create and configure a new project with this template (vm-azure-typescript) in Pulumi Cloud.
mkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-pythonAlternatively, you can create and configure a new project with this template (vm-azure-python) in Pulumi Cloud.
mkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-goAlternatively, you can create and configure a new project with this template (vm-azure-go) in Pulumi Cloud.
mkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-csharpAlternatively, you can create and configure a new project with this template (vm-azure-csharp) in Pulumi Cloud.
mkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-yamlAlternatively, you can create and configure a new project with this template (vm-azure-yaml) in Pulumi Cloud.
mkdir my-virtual-machine && cd my-virtual-machinepulumi new vm-azure-hclAlternatively, you can create and configure a new project with this template (vm-azure-hcl) in Pulumi Cloud.
Follow the prompts to complete the new-project wizard. When it’s done, you’ll have a complete Pulumi project that’s ready to deploy and configured with the most common settings. Feel free to inspect the code in index.tsindex.js__main__.pymain.goProgram.csProgram.fsProgram.vbApp.javaPulumi.yaml for a closer look.
Deploying the project#
The template requires no additional configuration. Once the new project is created, you can deploy it immediately with pulumi up:
pulumi upWhen the deployment completes, Pulumi exports the following stack output values:
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- ip
The IP address of the virtual machine.
- hostname
The provider-assigned hostname of the virtual machine.
- url
The fully-qualified HTTP URL of the HTTP server running on the virtual machine.
- private_key
The PEM-encoded private key for SSH access to the VM. This value is a secret.
Output values like these are useful in many ways, most commonly as inputs for other stacks or related cloud resources. The computed url, for example, can be used from the command line to open the newly deployed website in your favorite web browser:
open $(pulumi stack output url)Customizing the project#
Projects created with the Virtual Machine template expose the following configuration settings:
- adminUsername
The user account to create on the VM. Defaults to
pulumiuser.- vmName
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vmSize
The machine size to use for the VM. Defaults to
Standard_A1_v2.- osImage
The Azure URN of the base image to use for the VM. Defaults to
Debian:debian-11:11:latest.- servicePort
The HTTP service port to expose on the VM. Defaults to
80.- sshPublicKey
The public key data to use for SSH authentication.
- adminUsername
The user account to create on the VM. Defaults to
pulumiuser.- vmName
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vmSize
The machine size to use for the VM. Defaults to
Standard_A1_v2.- osImage
The Azure URN of the base image to use for the VM. Defaults to
Debian:debian-11:11:latest.- servicePort
The HTTP service port to expose on the VM. Defaults to
80.- sshPublicKey
The public key data to use for SSH authentication.
- adminUsername
The user account to create on the VM. Defaults to
pulumiuser.- vmName
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vmSize
The machine size to use for the VM. Defaults to
Standard_A1_v2.- osImage
The Azure URN of the base image to use for the VM. Defaults to
Debian:debian-11:11:latest.- servicePort
The HTTP service port to expose on the VM. Defaults to
80.- sshPublicKey
The public key data to use for SSH authentication.
- adminUsername
The user account to create on the VM. Defaults to
pulumiuser.- vmName
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vmSize
The machine size to use for the VM. Defaults to
Standard_A1_v2.- osImage
The Azure URN of the base image to use for the VM. Defaults to
Debian:debian-11:11:latest.- servicePort
The HTTP service port to expose on the VM. Defaults to
80.- sshPublicKey
The public key data to use for SSH authentication.
- adminUsername
The user account to create on the VM. Defaults to
pulumiuser.- vmName
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vmSize
The machine size to use for the VM. Defaults to
Standard_A1_v2.- osImage
The Azure URN of the base image to use for the VM. Defaults to
Debian:debian-11:11:latest.- servicePort
The HTTP service port to expose on the VM. Defaults to
80.- sshPublicKey
The public key data to use for SSH authentication.
- admin_username
The user account to create on the VM. Defaults to
pulumiuser.- vm_name
The DNS hostname prefix to use for the VM. Defaults to
my-server.- vm_size
The machine size to use for the VM. Defaults to
Standard_A1_v2.- os_image
The Azure image reference (publisher:offer:sku:version) to use for the VM. Defaults to
Debian:debian-11:11:latest.- service_port
The HTTP service port to expose on the VM. Defaults to
80.
All of these settings are optional and may be adjusted either by editing the stack configuration file directly (by default, Pulumi.dev.yaml) or by changing their values with pulumi config set:
Cleaning up#
You can cleanly destroy the stack and all of its infrastructure with pulumi destroy:
pulumi destroyLearn more#
- Browse other architecture templates in the Templates gallery.
- Explore the Azure Native provider API docs in the Pulumi Registry.
- Walk through Pulumi from the ground up in Pulumi Tutorials.
- Read the latest Azure posts on the Pulumi blog.