Pulumi example that deploys multiple EC2 instances, one in each availability zone for the region. The example uses aws.getAvailabilityZones() which calls an an AWS API to retrieve all availability zones for the selected region. The program then loops over these AZs and creates an EC2 instance in each zone.

This example shows how to use dynamic data when deploying infrastructure.

1. Run pulumi init. (Note: this command will not be required in a future SDK release.)

2. Create a new stack:

   $ pulumi stack init
   Enter a stack name: webserver-testing
   

3. Set the provider and region, such as us-west-2:

   $ pulumi config set cloud:provider aws
   $ pulumi config set aws:region us-west-2
   

4. Compile the program via tsc or npm run build.

5. Preview the program deployment:

   $ pulumi preview
   [...details omitted...]
   ---outputs:---
   serverUrls: [
       [0]: computed<string>
       [1]: computed<string>
       [2]: computed<string>
   ]
   info: 5 changes previewed:
       + 5 resources to create
   

6. Perform the deployment. Depending on the region you've selected, you should see two or three EC2 instances created.

   $ pulumi update
   [...details omitted...]
   ---outputs:---
   serverUrls: [
       [0]: "http:https://ec2-54-148-246-71.us-west-2.compute.amazonaws.com"
       [1]: "http:https://ec2-34-213-186-185.us-west-2.compute.amazonaws.com"
       [2]: "http:https://ec2-52-33-17-194.us-west-2.compute.amazonaws.com"
   ]
   info: 5 changes performed:
       + 5 resources created
   Update duration: 57.392733427s    
   

7. View the stack output:

   $ pulumi stack output serverUrls
   ["http:https://ec2-54-148-246-71.us-west-2.compute.amazonaws.com","http:https://ec2-34-213-186-185.us-west-2.compute.amazonaws.com","http:https://ec2-52-33-17-194.us-west-2.compute.amazonaws.com"]
   

8. Call curl on one of the endpoints:

   $ curl http:https://ec2-54-148-246-71.us-west-2.compute.amazonaws.com
   Hello, World!
   Instance metadata:
   us-west-2a
   

When you're done, run pulumi destroy to delete the program's resources:

$ pulumi destroy
This will permanently destroy all resources in the 'webserver-testing' stack!
Please confirm that this is what you'd like to do by typing ("webserver-testing"): webserver-testing